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Java Quick Reference 



Console Input 

Scanner input = new Scanner(System.in) ; 
int intValue = i nput . nextlnt() ; 
long longValue = input. nextLongO ; 
double doubleValue = i nput . nextDoubl e() ; 
float floatValue = input. nextFloatO ; 
String string = i nput . next() ; 

Console Output 

System. out. println(anyValue) ; 



GUI Input Dialog 

String string = JOptionPane.showInputDialog( 

"Enter i nput") ; 
int intValue = Integer . parselnt(stri ng) ; 
double doubleValue = 

Doubl e . parseDoubl e(stri ng) ; 

Message Dialog 

JOptionPane . showMessageDi alog(null , 
"Enter i nput") ; 



Primitive 


Data Types 


byte 


8 bits 


short 


16 bits 


int 


32 bits 


long 


64 bits 


float 


32 bits 


doubl e 


64 bits 


char 


16 bits 


bool ean 


true/fal se 



Arithmetic Operators 


+ 


addi tion 




subtraction 




multiplication 


/ 


di vi si on 


% 


remai nder 


++var 


prei ncrement 


— var 


predecrement 


var++ 


posti ncrement 


var-- 


postdecrement 



Assignment Operators 

assignment 
+= addition assignment 

subtraction assignment 
*= multiplication assignment 
/= division assignment 
%= remainder assignment 



Relational Operators 

< less than 

<= less than or equal to 

> greater than 

>= greater than or equal to 

equal to 
!= not equal 



switch Statements 

switch (intExpression) { 
case valuel: 
statements ; 
break; 

case valuen: 

statements ; 

break; 
default: 

statements ; 



Logical Operators 




&& short circuit 


AND 


| | short ci rcuit 


OR 


! NOT 




a exclusive OR 





loop Statements 

while (condition) { 
statements ; 

} 

do { 

statements ; 
} while (condition); 

for (init; condition; 
adjustment) { 
statements ; 

} 



if Statements 

if (condition) { 
statements ; 

} 

if (condition) { 
statements ; 

} 

el se { 

statements ; 

} 

if (conditionl) { 
statements ; 

} 

else if (condition2) { 
statements ; 

} 

el se { 

statements ; 

} 
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Frequently Used Static Constants/Methods 

Math. PI 

Math . randomO 

Math.pow(a, b) 

System .cur rentTi meMi 1 1 i s () 

System . out . pri ntl n (anyVal ue) 

JOpti on Pane . showMessageDi al og (nul 1 , 

message) 
JOptionPane . showInputDi alog( 

prompt-message) 
Integer . parselnt(stri ng) 
Doubl e . parseDouble(stri ng) 
Arrays. sort(type[] list) 

Arrays. binarySearch (type [] list, type key) 



Array/Length/Initial izer 

int[] list = new int[10]; 
list. length; 

int[] list = {1, 2, 3, 4}; 

Multidimensional Array/Length/Initial izer 

int[][] list = new int[10][10]; 
list. length; 
list[0] .length; 

int[][] list = {{1, 2}, {3, 4}}; 

Ragged Array 

int[][] m = {{1, 2, 3, 4}, 
{1, 2, 3}, 
{1, 2}, 
{1}}; 



Text File Output 

PrintWriter output = 

new PrintWriter(filename) ; 
output. pri nt(. . .) ; 
output . pri ntl n( . . . ) ; 
output . pri ntf ( . . . ) ; 

Text File Input 

Scanner input = new Scanner( 
new File (filename)) ; 



File Class 

File file = 

new File (filename) ; 
file.exists() 
file. renameTo(Fi 1 e) 
file.delete() 



Object Class 

Object o = new ObjectO; 
o.toStringO ; 
o . equal s(ol) ; 



Comparable Interface 

c . compareTo(Comparabl e) 
c is a Comparable object 



String Class 

String s = "Welcome"; 

String s = new String(char[]) ; 

int length = s.length(); 

char ch = s . charAt(i ndex) ; 

int d = s . compareTo(sl) ; 

boolean b = s. equals (si) ; 

boolean b = s.startsWith(sl) ; 

boolean b = s.endsWith(sl) ; 

String si = s.trimO; 

String si = s . toUpperCase() ; 

String si = s . toLowerCase() ; 

int index = s . i ndexOf (ch) ; 

int index = s.lastlndexOf (ch) ; 

String si = s . substri ng(ch) ; 

String si = s . substri ng(i , j) ; 

char[] chs = s . toCharArrayO ; 

String si = s. replaceAll (regex, repl) ; 

String[] tokens = s . spl i t(regex) ; 



ArrayList Class 

Arrayl_ist<E> list = new ArrayLi st<E>() ; 

list. add (object) ; 

list. add (index, ob j ect) ; 

list. clear() ; 

Object o = list, get (index) ; 
boolean b = 1 ist. is Empty () ; 
boolean b = list.contains(object) ; 
int i = list.size() ; 
list. remove (index); 
list.set(index, object); 
int i = 1 i st. indexOf (object) ; 
int i = 1 i st . lastlndexOf (object) ; 



pri ntf Method 

System. out. pri ntf ("%b %c %d %f %e %s", 
true, 'A', 45, 45.5, 45.5, "Welcome"); 

System. out. pri ntf ("%-5d %10.2f %10.2e %8s", 
45, 45.5, 45.5, "Welcome"); 
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PREFACE 



fundamentals-first 



problem-driven 



comprehensive version 



brief version 



complete revision 

new problems 
early console input 

hand trace box 

multidimensional arrays 

Sudoku problem simplified 



This book uses the fundamentals-first approach and teaches programming concepts and tech- 
niques in a problem-driven way. 

The fundamentals-first approach introduces basic programming concepts and techniques 
before objects and classes. My own experience, confirmed by the experiences of many col- 
leagues, demonstrates that new programmers in order to succeed must learn basic logic and 
fundamental programming techniques such as loops and stepwise refinement. The fundamen- 
tal concepts and techniques of loops, methods, and arrays are the foundation for program- 
ming. Building the foundation prepares students to learn object-oriented programming, GUI, 
database, and Web programming. 

Problem-driven means focused on problem solving rather than syntax. We make introducto- 
ry programming interesting by using interesting problems. The central thread of early chapters 
is on problem solving. Appropriate syntax and library are introduced to support the writing of 
a program for solving the problems. To support the teaching of programming in a problem- 
driven way, the book provides a wide variety of problems at various levels of difficulty to mo- 
tivate students. In order to appeal to students in all majors, the problems cover many 
application areas in math, science, business, financials, gaming, animation, and multimedia. 



Two Versions 



This comprehensive version covers fundamentals of programming, object-oriented program- 
ming, GUI programming, algorithms and data structures, concurrency, networking, internation- 
alization, advanced GUI, database, and Web programming. It is designed to prepare students to 
become proficient Java programmers. A brief version (Introduction to Java Programming, Brief 
Version, Eighth Edition) is available for a first course on programming, commonly known as 
CS1. The brief version contains the first 20 chapters of the comprehensive version. 

What's New in This Edition? 

This edition substantially improves Introduction to Java Programming, Seventh Edition. The 
major improvements are as follows: 

■ This edition is completely revised in every detail to enhance clarity, presentation, content, 
examples, and exercises. 

■ In the examples and exercises, which are provided to motivate and stimulate student inter- 
est in programming, one-fifth of the problems are new. 

■ In the previous edition, console input was covered at the end of Chapter 2. The new edition in- 
troduces console input early in Chapter 2 so that students can write interactive programs early. 

■ The hand trace box is added for many programs to help novice students to read and trace 
programs. 

■ Single-dimensional arrays and multidimensional arrays are covered in two chapters to give 
instructors the flexibility to cover multidimensional arrays later. 

■ The case study for the Sudoku problem has been moved to the Companion Website. A 
more pedagogically effective simple version of the Sudoku problem is presented instead. 

■ The design of the API for Java GUI programming is an excellent example of how the 
object-oriented principle is applied. Students learn better with concrete and visual examples. 
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So, basic GUI now precedes the introduction of abstract classes and interfaces. The instruc- 
tor, however, can still choose to cover abstract classes and interfaces before GUI. 

Exception handling is covered before abstract classes and interfaces so that students can 
build robust programs early. The instructor can still choose to cover exception handling later. 

Chapter 12, "Object-Oriented Design and Patterns," in the previous edition has been 
replaced by spreading the design guidelines and patterns into several chapters so that these 
topics can be covered in appropriate context. 

The chapter on sorting now follows right after the chapter on algorithm efficiency, so that 
students can immediately apply algorithm efficiency to sorting algorithms. 

A brand-new bonus Chapter 44 covers Java 2D. 

The coverage on data structures is expanded with new bonus chapters on AVL trees, splay 
trees, 2-4 trees, B-trees, and red-black trees, and hashing. So the book can be used for a 
full data structures course. 



Learning Strategies 



A programming course is quite different from other courses. In a programming course, you 
learn from examples, from practice, and from mistakes. You need to devote a lot of time to 
writing programs, testing them, and fixing errors. 

For first-time programmers, learning Java is like learning any high-level programming lan- 
guage. The fundamental point is to develop the critical skills of formulating programmatic 
solutions for real problems and translating them into programs using selection statements, 
loops, methods, and arrays. 

Once you acquire the basic skills of writing programs using loops, methods, and arrays, 
you can begin to learn how to develop large programs and GUI programs using the object- 
oriented approach. 

When you know how to program and you understand the concept of object-oriented pro- 
gramming, learning Java becomes a matter of learning the Java API. The Java API establishes 
a framework for programmers to develop applications using Java. You have to use the classes 
and interfaces in the API and follow their conventions and rules to create applications. The 
best way to learn the Java API is to imitate examples and do exercises. 

Pedagogical Features 

The book uses the following elements to get the most from the material: 

■ Objectives list what students should have learned from the chapter. This will help them 
determine whether they have met the objectives after completing the chapter. 

■ Introduction opens the discussion with representative problems to give the reader an 
overview of what to expect from the chapter. 

■ Problems carefully chosen and presented in an easy-to-follow style, teach problem solving 
and programming concepts. The book uses many small, simple, and stimulating examples 
to demonstrate important ideas. 

■ Chapter Summary reviews the important subjects that students should understand and 
remember. It helps them reinforce the key concepts they have learned in the chapter. 

■ Review Questions are grouped by sections to help students track their progress and eval- 
uate their learning. 



basic GUI earlier 



exception handling earlier 



design guidelines 



sorting 



Java 2D 



new data structures chapters 



learn from mistakes 



programmatic solution 



object-oriented programming 



Java API 



■ Programming Exercises are grouped by sections to provide students with opportunities to 
apply on their own the new skills they have learned. The level of difficulty is rated as easy (no 
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asterisk), moderate (*), hard (**), or challenging (***). The trick of learning programming is 
practice, practice, and practice. To that end, the book provides a great many exercises. 

■ LiveLab is a course assessment and management system. Students can submit programs 
online. The system automatically grades the programs/multiple-choice quizzes and gives 
students instant feedback. Instructors can create custom programming exercises and 
quizzes as well as use the system prebuilt exercises and quizzes. 

■ Notes, Tips, and Cautions are inserted throughout the text to offer valuable advice and in- 
sight on important aspects of program development. 

ij| Note 

Provides additional information on the subject and reinforces important concepts. 

tj| Tip 

Teaches good programming style and practice. 

|p Caution 

Helps students steer away from the pitfalls of programming errors. 

Design Guide 

Provides the guidelines for designing programs. 

Flexible Chapter Orderings 

The book is designed to provide flexible chapter orderings to enable GUI, exception handling, 
recursion, generics, and the Java Collections Framework to be covered earlier or later. The 
diagram on the next page shows the chapter dependencies. 

Organization of the Book 

The chapters can be grouped into five parts that, taken together, form a comprehensive intro- 
duction to Java programming, data structures and algorithms, and database and Web pro- 
gramming. Because knowledge is cumulative, the early chapters provide the conceptual basis 
for understanding programming and guide students through simple examples and exercises; 
subsequent chapters progressively present Java programming in detail, culminating with the 
development of comprehensive Java applications. 

Part I: Fundamentals of Programming (Chapters 1-7) 

The first part of the book is a stepping stone, preparing you to embark on the journey of learning 
Java. You will begin to know Java (Chapter 1) and will learn fundamental programming tech- 
niques with primitive data types, variables, constants, assignments, expressions, and operators 
(Chapter 2), control statements (Chapters 3^1), methods (Chapter 5), and arrays (Chapters 6-7). 
After Chapter 6, you may jump to Chapter 20 to learn how to write recursive methods for solv- 
ing inherently recursive problems. 

Part II: Object-Oriented Programming (Chapters 8-11, 13-14, 19) 

This part introduces object-oriented programming. Java is an object-oriented programming 
language that uses abstraction, encapsulation, inheritance, and polymorphism to provide great 
flexibility, modularity, and reusability in developing software. You will learn programming 
with objects and classes (Chapters 8-10), class inheritance (Chapter 11), polymorphism 
(Chapter 11), exception handling (Chapter 13), abstract classes (Chapter 14), and interfaces 
(Chapter 14). Processing strings will be introduced in Chapter 9 along with text I/O. Binary 
I/O is introduced in Chapter 19. 



Part I: Fundamentals of 
Programming 

Chapter 1 Introduction to 
Computers, Programs, and 
Java 



Chapter 2 Elementary 
Programming 

T~ 

Chapter 3 Selections 

~r 

Chapter 4 Loops 

~r 

Chapter 5 Methods 



Chapter 6 Single-Dimensional 

Arrays 




Part II: Object-Oriented 
Programming 

- Chapter 8 Objects and Classes | 

Chapter 9 Strings and Text I/O | 
\ 

Chapter 10 Thinking in Objects j 

J 

Chapter 11 Inheritance and 
Polymorphism 

Chapter 13 Exception 
Handling 



Chapter 14 Abstract Classes 
and Interfaces 

Chapter 19 Binary I/O 



Part III: GUI Programming 
- Chapter 12 GUI Basil 



Part IV: Data Structures and 
Algorithms 



Chl8 




Ch6 | -»~ Chapter 20 Recursion 

h 14 |-»- Chapter 21 Generics 




Chapter 16 Event-Driven 
Programming 



J 



Chapter 17 Creating Graphical 
User Interfaces 



Chapter 7 Multidimensional 

Arrays 



Note: Chapters 1-20 are in the 
brief version of this book 

Note: Chapters 38-48 are bonus 
chapters available from the 
Companion Website 



Chapter 18 Applets and 
Multimedia 



Chapter 32 JavaBeans and Bean 
Events 



Chapter 33 Containers, Layout 
Managers, and Borders 

Chapter 34 Menus, Toolbars, 
and Dialogs 



Chapter 35 MVC and Swing 
Models 

} 

Chapter 36 JTable and JTree 



Chapter 44 Java 2D 



Chapter 22 Java Collections 
— Framework 



Chapter 23 Algorithm Efficiency J 

} 



Chapter 24 Sorting 



J 



Chapter 25 Lists, Stacks, and 
Queues, and Priority Queues 

T 



Chapter 26 Binary Search Trees 



hapter 27 Graphs and 
Applications 

Chapter 28 Weighted Graphs 
and Applications 



hapter 45 AVL and Splay 
Trees 



Part V: Advanced Java 
Programming 

- Chapter 29 Multithreading 

- Chapter 30 Networking 

- Chapter 31 Internationalization fl 



Chapter 37 Java Database 
Programming 



lJ 



Chapter 38 Advanced Java 
Database Programming 



Chapter 39 Servlets 



Chapter 40 JavaServer Pages 



Chapter 41 JSF and Visual 
Web Development 



J 



Chapter 42 Web Services 



Chapter 43 Remote Method 
Invocation 



Chapter 46 2-4 Trees and 
B-Trees 



Chapt 



er 47 Red-Black Trees 



- Chapter 48 Hashing 



— i 

ro 

ET 

n 
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Part III: GUI Programming (Chapters 12, 15-18, 32-36, and 44) 

This part introduces elementary Java GUI programming in Chapters 12 and 15-18 and advanced 
Java GUI programming in Chapters 32-36 and 44. Major topics include GUI basics (Chapter 12), 
drawing shapes (Chapter 15), event-driven programming (Chapter 16), creating graphical user 
interfaces (Chapter 17), and writing applets (Chapter 18). You will learn the architecture of Java 
GUI programming and use the GUI components to develop applications and applets from these 
elementary GUI chapters. The advanced GUI chapters introduce Java GUI programming in more 
depth and breadth. You will delve into JavaBeans and learn how to develop custom events and 
source components in Chapter 32, review and explore new containers, layout managers, and bor- 
ders in Chapter 33, learn how to create GUI with menus, popup menus, toolbars, dialogs, and 
internal frames in Chapter 34, develop components using the MVC approach and explore the 
advanced Swing components JSpinner, JList, JComboBox, JSpinner, and JTable, and 
JTree in Chapters 35 and 36. Bonus Chapter 44 introduces Java 2D. 

Part IV: Algorithms and Data Structures (Chapters 20-28, 45-48) 

This part introduces the main subjects in a typical data structures course. Chapter 20 intro- 
duces recursion to write methods for solving inherently recursive problems. Chapter 21 intro- 
duces generics to improve software reliability. Chapter 22 introduces the Java Collection 
Framework, which defines a set of useful API for data structures. Chapter 23 introduces mea- 
surement of algorithm efficiency in order to choose an appropriate algorithm for applications. 
Chapter 24 introduces classic sorting algorithms. You will learn how to implement several 
classic data structures lists, queues, priority queues, binary search trees, AVL trees, splay 
trees, 2-4 trees, B-trees, and red-black trees in Chapters 25-26 and 45-47. Chapters 27 and 28 
introduce graph applications. Chapter 48 introduces hashing. 

Part V: Advanced Java Programming (Chapters 29-31, 37-43) 

This part of the book is devoted to advanced Java programming. Chapter 29 treats the use of 
multithreading to make programs more responsive and interactive. Chapter 30 introduces how 
to write programs that talk with each other from different hosts over the Internet. Chapter 3 1 
covers the use of internationalization support to develop projects for international audiences. 
Chapter 37 introduces the use of Java to develop database projects, Chapter 38 introduces 
advanced Java database programming, and Chapters 39 and 40 introduce how to use Java 
servlets and JSP to generate dynamic contents from Web servers. Chapter 41 introduces rapid 
Web application development using JavaServer Faces. Chapter 42 introduces Web services. 
Chapter 43 introduces remote method invocation. 

Java Development Tools 

You can use a text editor, such as the Windows Notepad or WordPad, to create Java programs 
and to compile and run the programs from the command window. You can also use a Java 
IDE tutorials development tool, such as TextPad, NetBeans, or Eclipse. These tools support an integrated 

development environment (IDE) for rapidly developing Java programs. Editing, compiling, 
building, executing, and debugging programs are integrated in one graphical user interface. 
Using these tools effectively can greatly increase your programming productivity. TextPad is 
a primitive IDE tool. NetBeans and Eclipse are more sophisticated, but they are easy to use if 
you follow the tutorials. Tutorials on TextPad, NetBeans and Eclipse can be found in the sup- 
plements on the Companion Website. 

LiveLab 

This book is accompanied by an improved faster Web-based course assessment and manage- 
ment system. The system has three main components: 
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■ Automatic Grading System: It can automatically grade programs from the text or creat- 
ed by instructors. 

■ Quiz Creation/Submission/Grading System: It enables instructors to create/modify 
quizzes that students can take and be graded upon automatically. 

■ Tracking grades, attendance, etc: The system enables the students to track grades and 
instructors, to view the grades of all students, and to track attendance. 

The main features of the Automatic Grading System are as follows: 

■ Allows students to compile, run and submit exercises. (The system checks whether their 
program runs correctly — students can continue to run and resubmit the program before the 
due date.) 

■ Allows instructors to review submissions; run programs with instructor test cases; correct 
them; and provide feedback to students. 

■ Allows instructors to create/modify custom exercises, create public and secret test cases, 
assign exercises, and set due dates for the whole class or for individuals. 

■ All the exercises in the text can be assigned to students. Additionally, LiveLab provides 
extra exercises that are not printed in the text. 

■ Allows instructors to sort and filter all exercises and check grades (by time frame, student, 
and/or exercise). 

■ Allows instructors to delete students from the system. 

■ Allows students and instructors to track grades on exercises. 

The main features of the Quiz System are as follows: 

■ Allows instructors to create/modify quizzes from test bank or a text file or to create com- 
plete new tests online. 

■ Allows instructors to assign the quizzes to students and set a due date and test time limit 
for the whole class or for individuals. 

■ Allows students and instructors to review submitted quizzes. 

■ Allows students and instructors to track grades on quizzes. 

Video Notes are Pearson's new visual tool designed for teaching students key programming con- 
cepts and techniques. These short step-by-step videos demonstrate how to solve problems from 
design through coding. Video Notes allows for self-paced instruction with easy navigation includ- 
ing the ability to select, play, rewind, fast-forward, and stop within each Video Note exercise. 

Video Note margin icons in your textbook let you know what a Video Notes video is avail- 
able for a particular concept or homework problem. 

Video Notes are free with the purchase of a new textbook. To purchase access to Video 
Notes, please go to www.pearsonhighered.com/liang. 

Student Resource Materials 

The student resources can be accessed through the Publisher's Web site 
(www.pearsonhighered.com/liang) and the Companion Web site (www.cs.armstrong.edu/liang/intro8e). 
The resources include: 



■ Answers to review questions 

■ Solutions to even-numbered programming exercises 
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■ Source code for book examples 

■ Interactive self-test (organized by chapter sections) 

■ LiveLab 

■ Resource links 

■ Errata 

■ Video Notes 

■ Web Chapters 

To access the Video Notes and Web Chapters, students must log onto www.pearsonhighered.com/liang 
and use the access card located in the front of the book to register and access the material. If there is 
no access card in the front of this textbook, students can purchase access by visiting 
www.pearsonhighered.com/liang and selecting purchase access to premium content. 

Additional Supplements 

The text covers the essential subjects. The supplements extend the text to introduce additional 
topics that might be of interest to readers. The supplements listed in this table are available 
from the Companion Web site. 



Supplements on the Companion Web site 


Part I General Supplements 


F Enumerated Types 


A Glossary 


G Packages 


B Installing and Configuring JDK 


H Regular Expressions 


C Compiling and Running Java from the 


I Formatted Strings 


Command Window 


J The Methods in the Object Class 


D Java Coding Style Guidelines 


K Hiding Data Fields and Static 


E Creating Desktop Shortcuts for Java 


Methods 


Applications on Windows 


L Initialization Blocks 


F Using Packages to Organize the Classes 


M Extended Discussions on Overriding 


in the Text 


Methods 


Part II IDE Supplements 
A TextPad Tutorial 


N Design Patterns 

Text I/O Prior to JDK 1.5 (Reader and 

Writer Classes) 
P Assertions 


B NetBeans Tutorial | One Page Startup 

Instruction 
C Learning Java Effectively with 

NetBeans 
D Eclipse Tutorial | One Page Startup 

Instruction 
E Learning Java Effectively with Eclipse 


Q Packaging and Deploying Java Projects 
R Java Web Start 

S GridBagLayout | OverlayLayout | 

SpringLayout 
T Networking Using Datagram Protocol 
U Creating Internal Frames 


Part III Java Supplements 


V Pluggable Look and Feel 


A Java Characteristics 


W UML Graphical Notations 


B Discussion on Operator and Operand 


X Testing Classes Using JUnit 


Evaluations 


Y JNI 


C The & and | Operators 


Z The StringTokenizer Class 


D Bitwise Operations 
E Statement Labels with break 
and continue 


Part IV Database Supplements 
A SQL Statements for Creating and 
Initializing Tables Used in the Book 
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B MySQL Tutorial 


Part V Web Programming Supplements 


C Oracle Tutorial 


A HTML and XHTML Tutorial 


D Microsoft Access Tutorial 


B CSS Tutorial 


E Introduction to Database Systems 


C XML 


F Relational Database Concept 


D Java and XML 


G Database Design 


E Tomcat Tutorial 


H SQL Basics 


F More Examples on JSF and Visual Web 


I Advanced SQL 


Development 



Instructor Resource Materials 

The instructor resources can be accessed through the Publisher's Web site 
(www.pearsonhighered.com/liang) and the Companion Web site (www.cs.armstrong.edu/liang/intro8e). 
For username and password information to the Liang 8e site, please contact your Pearson Repre- 
sentative. 

The resources include: 

■ PowerPoint lecture slides with source code and run program capacity 

■ Instructor solutions manual 

■ Computerized test generator 

■ Sample exams using multiple choice and short answer questions, write and trace pro- 
grams, and correcting programming errors. 

■ LiveLab 

■ Errata 

■ Video Notes 

■ Web Chapters 

To access the Video Notes and Web Chapters, instructors must log onto www.pearsonhighered.com/liang 
and register. 
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Chapter 



Introduction to Computers 
Programs, and Java 

Objectives 

■ To review computer basics, programs, and operating systems (§§1.2-1.4). 

■ To explore the relationship between Java and the World Wide Web (§1.5). 

■ To distinguish the terms API, IDE, and JDK (§1.6). 

■ To write a simple Java program (§1.7). 

■ To display output on the console (§1.7). 

■ To explain the basic syntax of a Java program (§ 1 .7). 

■ To create, compile, and run Java programs (§1.8). 

■ (GUI) To display output using the JOptionPane 

output dialog boxes (§1.9). 



2 Chapter! Introduction to Computers, Programs, and Java 



I.I Introduction 

You use word processors to write documents, Web browsers to explore the Internet, and email 
programs to send email. These are all examples of software that runs on computers. Software 
is developed using programming languages. There are many programming languages — so 
why Java? why Javal The answer is that Java enables users to develop and deploy applications on the 

Internet for servers, desktop computers, and small hand-held devices. The future of comput- 
ing is being profoundly influenced by the Internet, and Java promises to remain a big part of 
that future. Java is the Internet programming language. 

You are about to begin an exciting journey, learning a powerful programming language. At 
the outset, it is helpful to review computer basics, programs, and operating systems and to 
become familiar with number systems. If you are already familiar with such terms as CPU, 
memory, disks, operating systems, and programming languages, you may skip the review in 
§§1.2-1.4. 



1.2 What Is a Computer? 

hardware A computer is an electronic device that stores and processes data. It includes both hardware 

software and software. In general, hardware comprises the visible, physical elements of the computer, 

and software provides the invisible instructions that control the hardware and make it perform 
specific tasks. Writing instructions for computers to perform is called computer program- 
ming. Knowing computer hardware isn't essential to your learning a programming language, 
but it does help you understand better the effect of the program instructions. This section 
introduces computer hardware components and their functions. 

A computer consists of the following major hardware components (Figure 1.1): 

■ Central processing unit (CPU) 

■ Memory (main memory) 

■ Storage devices (e.g., disks, CDs, tapes) 

■ Input and output devices (e.g., monitors, keyboards, mice, printers) 

■ Communication devices (e.g., modems and network interface cards (NICs)) 
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Figure I.I A computer consists of CPU, memory, storage devices, input devices, output 
devices, and communication devices. 



bus The components are connected through a subsystem called a bus that transfers data or 

power between them. 

1.2.1 Central Processing Unit 

CPU The central processing unit (CPU) is the computer's brain. It retrieves instructions from 

memory and executes them. The CPU usually has two components: a control unit and an 
arithmetic/logic unit. The control unit controls and coordinates the actions of the other 
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components. The arithmetic/logic unit performs numeric operations (addition, subtraction, 
multiplication, division) and logical operations (comparisons). 

Today's CPU is built on a small silicon semiconductor chip having millions of transistors. 
Every computer has an internal clock, which emits electronic pulses at a constant rate. These 
pulses are used to control and synchronize the pace of operations. The higher the clock speed, 
the more instructions are executed in a given period of time. The unit of measurement of clock 
speed is the hertz (Hz), with 1 hertz equaling 1 pulse per second. The clock speed of a com- speed 
puter is usually stated in megahertz (MHz) (1 MHz is 1 million Hz). CPU speed has been hertz 
improved continuously. Intel's Pentium 3 Processor runs at about 500 megahertz and Pentium megahertz 
4 Processor at about 3 gigahertz (GHz) (1 GHz is 1000 MHz). gigahertz 



1.2.2 Memory 

To store and process information, computers use off and on electrical states, referred to by 
convention as and 1. These 0s and Is are interpreted as digits in the binary number system 
and called bits (binary digits). Data of various kinds, such as numbers, characters, and strings, bit 
are encoded as series of bits. Data and program instructions for the CPU to execute are stored 
as groups of bits, or bytes, each byte composed of eight bits, in a computer's memory. A 
memory unit is an ordered sequence of bytes, as shown in Figure 1.2. byte 
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Figure 1.2 Memory stores data and program instructions. 



The programmer need not be concerned about the encoding and decoding of data, which 
the system performs automatically, based on the encoding scheme. In the popular ASCII 
encoding scheme, for example, character 1 D ' is represented by 01001010 in one byte. 

A byte is the minimum storage unit. A small number such as 3 can be stored in a single 
byte. To store a number that cannot fit into a single byte, the computer uses several adjacent 
bytes. No two data items can share or split the same byte. 

A memory byte is never empty, but its initial content may be meaningless to your program. 
The current content of a memory byte is lost whenever new information is placed in it. 

A program and its data must be brought to memory before they can be executed. 

Every byte has a unique address. The address is used to locate the byte for storing and 
retrieving data. Since bytes can be accessed in any order, the memory is also referred to as 
random-access memory (RAM). Today's personal computers usually have at least 1 gigabyte 
of RAM. Computer storage size is measured in bytes, kilobytes (KB), megabytes (MB), giga- RAM 
bytes (GB), and terabytes (TB). A kilobyte is 2 10 = 1024, about 1000 bytes, a megabyte is megabyte 
2 20 = 1048576, about 1 million bytes, a gigabyte is about 1 billion bytes, and a terabyte is 
about 1000 gigabytes. Like the CPU, memory is built on silicon semiconductor chips having 
thousands of transistors embedded on their surface. Compared to CPU chips, memory chips 
are less complicated, slower, and less expensive. 
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1.2.3 Storage Devices 

Memory is volatile, because information is lost when the power is turned off. Programs and 
data are permanently stored on storage devices and are moved, when the computer actually 
uses them, to memory, which is much faster than storage devices. 
There are four main types of storage devices: 

■ Disk drives 

■ CD drives (CD-R, CD-RW, and DVD) 

■ Tape drives 

■ USB flash drives 

drive Drives are devices for operating a medium, such as disks, CDs, and tapes. 

Disks 

hard disk Each computer has at least one hard drive. Hard disks are for permanently storing data and 

programs. The hard disks of the latest PCs store from 80 to 250 gigabytes. Often disk drives 
are encased inside the computer. Removable hard disks are also available. 

CDs and DVDs 

CD-R CD stands for compact disk. There are two types of CD drives: CD-R and CD-RW. A CD-R is 

for read-only permanent storage; the user cannot modify its contents once they are recorded. 

CD-RW A CD-RW can be used like a hard disk and can be both read and rewritten. A single CD can 

hold up to 700 MB. Most software is distributed through CD-ROMs. Most new PCs are 
equipped with a CD-RW drive that can work with both CD-R and CD-RW. 

DVD stands for digital versatile disc or digital video disk. DVDs and CDs look alike, and 
you can use either to store data. A DVD can hold more information than a CD. A standard 
DVD's storage capacity is 4.7 GB. 

Tapes 

Tapes are mainly used for backup of data and programs. Unlike disks and CDs, tapes store 
information sequentially. The computer must retrieve information in the order it was stored. 
Tapes are very slow. It would take one to two hours to back up a 1 -gigabyte hard disk. The 
new trend is to back up data using flash drives or external hard disks. 

USB Flash Drives 

USB flash drives are devices for storing and transporting data. A flash drive is small — about 
the size of a pack of gum. It acts like a portable hard drive that can be plugged into your com- 
puter's USB port. USB flash drives are currently available with up to 32 GB storage capacity. 

1.2.4 Input and Output Devices 

Input and output devices let the user communicate with the computer. The common input 
devices are keyboards and mice. The common output devices are monitors and printers. 

The Keyboard 

A computer keyboard resembles a typewriter keyboard with extra keys added for certain spe- 
cial functions. 

Function keys are located at the top of the keyboard and are numbered with prefix F. Their 
use depends on the software. 

A modifier key is a special key (e.g., Shift, Alt, Ctrl) that modifies the normal action of 
another key when the two are pressed in combination. 
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The numeric keypad, located on the right-hand corner of the keyboard, is a separate set of numeric keypad 
keys for quick input of numbers. 

Arrow keys, located between the main keypad and the numeric keypad, are used to move 
the cursor up, down, left, and right. 

The Insert, Delete, Page Up, and Page Down keys, located above the arrow keys, are used 
in word processing for performing insert, delete, page up, and page down. 

The Mouse 

A mouse is a pointing device. It is used to move an electronic pointer called a cursor around 
the screen or to click on an object on the screen to trigger it to respond. 

The Monitor 

The monitor displays information (text and graphics). The screen resolution and dot pitch 
determine the quality of the display. 

The screen resolution specifies the number of pixels per square inch. Pixels (short for "pic- screen resolution 
ture elements") are tiny dots that form an image on the screen. A common resolution for a 17- 
inch screen, for example, is 1024 pixels wide and 768 pixels high. The resolution can be set 
manually. The higher the resolution, the sharper and clearer the image is. 

The dot pitch is the amount of space between pixels in millimeters. The smaller the dot dot pitch 
pitch, the better the display. 



1.2.5 Communication Devices 

Computers can be networked through communication devices, such as the dialup modem 

(modulator/iiewiodulator), DSL, cable modem, network interface card, and wireless. A dialup modem 

modem uses a phone line and can transfer data at a speed up to 56,000 bps (bits per second). 

A DSL (digital subscriber line) also uses a phone line and can transfer data twenty times DSL 

faster. A cable modem uses the TV cable line maintained by the cable company and is as fast 

as a DSL. A network interface card (NIC) is a device that connects a computer to a local area NIC 

network (LAN). The LAN is commonly used in universities and business and government LAN 

organizations. A typical NIC called WBaseT can transfer data at 10 mbps (million bits per mbps 

second). Wireless is becoming popular. Every laptop sold today is equipped with a wireless 

adapter that enables the computer to connect with the Internet. 
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Computer programs, known as software, are instructions to the computer, telling it what to do. software 
Computers do not understand human languages, so you need to use computer languages in 
computer programs. Programming is the creation of a program that is executable by a com- programming 
puter and performs the required tasks. 

A computer's native language, which differs among different types of computers, is its 
machine language — a set of built-in primitive instructions. These instructions are in the form machine language 
of binary code, so in telling the machine what to do, you have to enter binary code. Program- 
ming in machine language is a tedious process. Moreover, the programs are highly difficult to 
read and modify. For example, to add two numbers, you might have to write an instruction in 
binary like this: 

1101101010011010 



Assembly language is a low-level programming language in which a mnemonic is used to 
represent each of the machine-language instructions. For example, to add two numbers, you 
might write an instruction in assembly code like this: 



assembly language 
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Assembly languages were developed to make programming easy. However, since the corn- 
assembler puter cannot understand assembly language, a program called an assembler is used to convert 

assembly-language programs into machine code, as shown in Figure 1.3. 
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Figure 1 .3 Assembler translates assembly-language instructions to machine code. 



Assembly programs are written in terms of machine instructions with easy-to-remember 
mnemonic names. Since assembly language is machine dependent, an assembly program can 
be executed only on a particular kind of machine. The high-level languages were developed in 
order to transcend platform specificity and make programming easier, 
high-level language The high-level languages are English-like and easy to learn and program. Here, for exam- 

ple, is a high-level language statement that computes the area of a circle with radius 5: 

area =5*5* 3.1415; 

Among the more than one hundred high-level languages, the following are well known: 

■ COBOL (COmmon Business Oriented Language) 

■ FORTRAN (FORmula TRANslation) 

■ BASIC (Beginner's All-purpose Symbolic Instruction Code) 

■ Pascal (named for Blaise Pascal) 

■ Ada (named for Ada Lovelace) 

■ C (developed by the designer of B) 

■ Visual Basic (Basic-like visual language developed by Microsoft) 

■ Delphi (Pascal-like visual language developed by Borland) 

■ C++ (an object-oriented language, based on C) 

■ C# (a Java-like language developed by Microsoft) 

■ Java 

Each of these languages was designed for a specific purpose. COBOL was designed for busi- 
ness applications and is used primarily for business data processing. FORTRAN was 
designed for mathematical computations and is used mainly for numeric computations. 
BASIC was designed to be learned and used easily. Ada was developed for the Department 
of Defense and is used mainly in defense projects. C combines the power of an assembly lan- 
guage with the ease of use and portability of a high-level language. Visual Basic and Delphi 
are used in developing graphical user interfaces and in rapid application development. C++ 
is popular for system software projects such as writing compilers and operating systems. The 
Microsoft Windows operating system was coded using C++. C# (pronounced C sharp) is a 
new language developed by Microsoft for developing applications based on the Microsoft 
.NET platform. Java, developed by Sun Microsystems, is widely used for developing plat- 
form-independent Internet applications. 
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A program written in a high-level language is called a source program or source code. 
Since a computer cannot understand a source program, a program called a compiler is used to 
translate it into a machine-language program. The machine-language program is then linked 
with other supporting library code to form an executable file, which can be run on the 
machine, as shown in Figure 1.4. On Windows, executable files have extension .exe. 
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Figure 1.4 A source program is compiled into a machine-language file, which is then 
linked with the system library to form an executable file. 



1.4 Operating Systems 



The operating system (OS) is the most important program that runs on a computer, which 
manages and controls a computer's activities. The popular operating systems are Microsoft 
Windows, Mac OS, and Linux. Application programs, such as a Web browser or a word 
processor, cannot run without an operating system. The interrelationship of hardware, operat- 
ing system, application software, and the user is shown in Figure 1.5. 
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Figure 1 .5 The operating system is the software that controls and manages the system. 



The major tasks of an operating system are: 

■ Controlling and monitoring system activities 

■ Allocating and assigning system resources 

■ Scheduling operations 

1.4.1 Controlling and Monitoring System Activities 

Operating systems perform basic tasks, such as recognizing input from the keyboard, sending 
output to the monitor, keeping track of files and directories on the disk, and controlling 
peripheral devices, such as disk drives and printers. They also make sure that different pro- 
grams and users running at the same time do not interfere with each other, and they are 
responsible for security, ensuring that unauthorized users do not access the system. 
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1.4-2 Allocating and Assigning System Resources 

The operating system is responsible for determining what computer resources a program 
needs (e.g., CPU, memory, disks, input and output devices) and for allocating and assigning 
them to run the program. 

1.4-3 Scheduling Operations 

The OS is responsible for scheduling programs to make efficient use of system resources. Many 
of today's operating systems support such techniques as multiprogramming, multithreading, or 
multiprocessing to increase system performance. 

Multiprogramming allows multiple programs to run simultaneously by sharing the CPU. 
The CPU is much faster than the computer's other components. As a result, it is idle most of 
the time — for example, while waiting for data to be transferred from the disk or from other 
sources. A multiprogramming OS takes advantage of this situation by allowing multiple pro- 
grams to use the CPU when it would otherwise be idle. For example, you may use a word 
processor to edit a file at the same time as the Web browser is downloading a file. 

Multithreading allows concurrency within a program, so that its subtasks can run at the 
same time. For example, a word-processing program allows users to simultaneously edit text 
and save it to a file. In this example, editing and saving are two tasks within the same applica- 
tion. These two tasks may run on separate threads concurrently. 

Multiprocessing, or parallel processing, uses two or more processors together to perform a 
task. It is like a surgical operation where several doctors work together on one patient. 

1.5 Java, World Wide Web, and Beyond 

This book introduces Java programming. Java was developed by a team led by James 
Gosling at Sun Microsystems. Originally called Oak, it was designed in 1991 for use in 
embedded chips in consumer electronic appliances. In 1995, renamed Java, it was 
redesigned for developing Internet applications. For the history of Java, see 
java.sun.com/features/1998/05/birthday.html. 

Java has become enormously popular. Its rapid rise and wide acceptance can be traced to 
its design characteristics, particularly its promise that you can write a program once and run it 
anywhere. As stated by Sun, Java is simple, object oriented, distributed, interpreted, robust, 
secure, architecture neutral, portable, high performance, multithreaded, and dynamic. For the 
anatomy of Java characteristics, see www.cs.armstrong.edu/liang/JavaCharacteristics.pdf. 

Java is a full-featured, general-purpose programming language that can be used to develop 
robust mission-critical applications. Today, it is employed not only for Web programming, but 
also for developing standalone applications across platforms on servers, desktops, and mobile 
devices. It was used to develop the code to communicate with and control the robotic rover on 
Mars. Many companies that once considered Java to be more hype than substance are now 
using it to create distributed applications accessed by customers and partners across the Inter- 
net. For every new project being developed today, companies are asking how they can use 
Java to make their work easier. 

The World Wide Web is an electronic information repository that can be accessed on the 
Internet from anywhere in the world. The Internet, the Web's infrastructure, has been around 
for more than thirty years. The colorful World Wide Web and sophisticated Web browsers are 
the major reason for the Internet's popularity. 

The primary authoring language for the Web is the Hypertext Markup Language (HTML). 
HTML is a simple language for laying out documents, linking documents on the Internet, and 
bringing images, sound, and video alive on the Web. However, it cannot interact with the user 
except through simple forms. Web pages in HTML are essentially static and flat. 

Java initially became attractive because Java programs can be run from a Web browser, 
applet Such programs are called applets. Applets employ a modern graphical interface with buttons, 
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text fields, text areas, radio buttons, and so on, to interact with users on the Web and process 
their requests. Applets make the Web responsive, interactive, and fun to use. Figure 1.6 shows 
an applet running from a Web browser for playing a Tic Tac Toe game. 
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Figure 1.6 A Java applet for playing TicTacToe is embedded in an HTML page. 



Tip 

For a demonstration of Java applets, visit java.sun.com/applets. This site provides a rich Java 
resource as well as links to other cool applet demo sites, java.sun.com is the official Sun Java Web- 
site. 

Java can also be used to develop applications on the server side. These applications can be 
run from a Web server to generate dynamic Web pages. The automatic grading system for this 
book, as shown in Figure 1 .7, was developed using Java. 
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Figure 1.7 Java was used to develop an automatic grading system to accompany this book. 
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Java is a versatile programming language. You can use it to develop applications on 
your desktop and on the server. You can also use it to develop applications for small hand- 
held devices. Figure 1.8 shows a Java-programmed calendar displayed on a BlackBerry© 
and on a cell phone. 




Figure 1.8 Java can be used to develop applications for hand-held and wireless devices, 
such as a BlackBerry© (left) and a cell phone (right). 

1.6 The Java Language Specification, API, JDK, and IDE 

Computer languages have strict rules of usage. If you do not follow the rules when writing a 
program, the computer will be unable to understand it. The Java language specification and 
Java API define the Java standard. 

Java language specification The Java language specification is a technical definition of the language that includes the 

syntax and semantics of the Java programming language. The complete Java language speci- 
fication can be found atjava.sun.com/docs/books/jls. 

API The application program interface (API) contains predefined classes and interfaces for 

developing Java programs. The Java language specification is stable, but the API is still 
expanding. At the Sun Java Website (java.sun.com), you can view and download the latest ver- 
sion of the Java API. 

Java is a full-fledged and powerful language that can be used in many ways. It comes in 
Java SE, EE, and ME three editions: Java Standard Edition (Java SE), Java Enterprise Edition (Java EE), and Java 

Micro Edition (Java ME). Java SE can be used to develop client-side standalone applications 
or applets. Java EE can be used to develop server-side applications, such as Java servlets and 
JavaServer Pages. Java ME can be used to develop applications for mobile devices, such as 
cell phones. This book uses Java SE to introduce Java programming. 

There are many versions of Java SE. The latest, Java SE 6, will be used in this book. Sun 
releases each version with a Java Development Toolkit (JDK). For Java SE 6, the Java Devel- 
JDK 1.6 = JDK 6 opment Toolkit is called JDK 1.6 (also known as Java 6 or JDK 6). 

JDK consists of a set of separate programs, each invoked from a command line, for devel- 
oping and testing Java programs. Besides JDK, you can use a Java development tool (e.g., Net- 
Java IDE Beans, Eclipse, and TextPad) — software that provides an integrated development environment 

(IDE) for rapidly developing Java programs. Editing, compiling, building, debugging, and 
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online help are integrated in one graphical user interface. Just enter source code in one window 
or open an existing file in a window, then click a button, menu item, or function key to compile 
and run the program. 



.7 A Simple Java Program 



Let us begin with a simple Java program that displays the message "Welcome to Java!" on the 
console. Console refers to text entry and display device of a computer. The program is shown 
in Listing 1.1. 



console 



Listing I.I Wei come, java 

1 public class Welcome { 

2 public static void main(String[] args) { 

3 // Display message Welcome to Java! to the console 

4 System. out. println ("Wei come to Java!"); 

5 } 

6 } 



Video Note 

First Java program 
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Welcome to Java! 




The line numbers are displayed for reference purposes but are not part of the program. So, 
don't type line numbers in your program. 

Line 1 defines a class. Every Java program must have at least one class. Each class has a 
name. By convention, class names start with an uppercase letter. In this example, the class 
name is Wei come. 

Line 2 defines the main method. In order to run a class, the class must contain a method 
named mai n. The program is executed from the mai n method. 

A method is a construct that contains statements. The main method in this program con- 
tains the System . out . pri ntl n statement. This statement prints a message "Wei come to 
Java ! " to the console (line 4). Every statement in Java ends with a semicolon ( ;), known as 
the statement terminator. 

Reserved words, or keywords, have a specific meaning to the compiler and cannot be used 
for other purposes in the program. For example, when the compiler sees the word cl ass, it 
understands that the word after cl ass is the name for the class. Other reserved words in this 
program are publ ic, static, and void. 

Line 3 is a comment that documents what the program is and how it is constructed. Com- 
ments help programmers to communicate and understand the program. They are not pro- 
gramming statements and thus are ignored by the compiler. In Java, comments are preceded 
by two slashes (//) on a line, called a line comment, or enclosed between /* and */ on one or 
several lines, called a block comment. When the compiler sees //, it ignores all text after // 
on the same line. When it sees /*, it scans for the next */ and ignores any text between /* 
and */. Here are examples of comments: 



line numbers 



class name 



main method 



statement terminator 
reserved word 



comment 



// This application program prints Welcome to Java! 
/* This application program prints Welcome to Java! */ 
/* This application program 
prints Welcome to Java! */ 



A pair of braces in a program forms a block that groups the program's components. In Java, 
each block begins with an opening brace ({) and ends with a closing brace (}). Every class 
has a class block that groups the data and methods of the class. Every method has a method 



block 
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block that groups the statements in the method. Blocks can be nested, meaning that one block 
can be placed within another, as shown in the following code. 



public class Welcome { 



public static void main(String[] args) { ■< 1 

System, out. pri ntl n("Wel come to Java!"); Method block 
}^ ' 



1 

Class block 



matching braces 



Tip 

An opening brace must be matched by a closing brace. Whenever you type an opening brace, 
immediately type a closing brace to prevent the missing-brace error. Most Java IDEs automatically 
insert the closing brace for each opening brace. 



Note 

You are probably wondering why the main method is declared this way and why 
System, out .print! n(. . .) is used to display a message to the console. For the time being, 
simply accept that this is how things are done. Your questions will be fully answered in subse- 
quent chapters. 
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Caution 

Java source programs are case sensitive. It would be wrong, for example, to replace main in the 
program with Main. 
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Note 

Like any programming language, Java has its own syntax, and you need to write code that obeys 
the syntax rules. If your program violates the rules — for example if the semicolon is missing, a 
brace is missing, a quotation mark is missing, or String is misspelled — the Java compiler will 
report syntax errors. Try to compile the program with these errors and see what the compiler 
reports. 

The program in Listing 1.1 displays one message. Once you understand the program, it is 
easy to extend it to display more messages. For example, you can rewrite the program to dis- 
play three messages, as shown in Listing 1.2. 

Listing 1.2 Wei cornel, java 

1 public class Wei cornel { 

2 public static void main(String[] args) { 

3 System. out. pri ntl n("Programming is fun!"); 

4 System. out. pri ntl n ("Fundamentals First"); 

5 System. out. pri ntl n("Problem Driven"); 

6 } 

7 } 



Programming is fun! 
Fundamentals First 
Problem Driven 



Further, you can perform mathematical computations and display the result to the console. 

10.5 + 2X3 

Listing 1.3 gives an example of evaluating — — — — . 
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Listing 1.3 ComputeExpression. java 

1 public class ComputeExpression { 

2 public static void main(String[] args) { 

3 System, out. pri nt~l n((10. 5 + 2*3)/ (45 

4 } 

5 } 



3.5)); 
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0.39759036144578314 



The multiplication operator in Java is *. As you see, it is a straightforward process to trans- 
late an arithmetic expression to a Java expression. We will discuss Java expressions further in 
Chapter 2. 

1.8 Creating, Compiling, and Executing a Java Program 

You have to create your program and compile it before it can be executed. This process is 
repetitive, as shown in Figure 1.9. If your program has compilation errors, you have to mod- 
ify the program to fix them, then recompile it. If your program has runtime errors or does not 
produce the correct result, you have to modify the program, recompile it, and execute it 
again. 
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public class Welcome { 

public static void mai n(Stri ng [] args) { 
System. out. pri ntln ("Wei come to lava!"); 

} 

} 



Bytecode (generated by the compiler for JVM 
to read and interpret, not for you to understand) 
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Stored on the disk 



If compilation errors 



Bytecode 



3 







Run Bytecode 
e.g., java Wei come 







Result 



If runtime errors or incorrect result 



Figure 1 .9 The Java program-development process consists of repeatedly creating/modifying source code, compilin 
and executing programs. 
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editor 



You can use any text editor or IDE to create and edit a Java source-code file. This section 
demonstrates how to create, compile, and run Java programs from a command window. If you 
wish to use an IDE such as Eclipse, NetBeans, or TextPad, please refer to Supplement II for 
tutorials. From the command window, you can use the NotePad to create the Java source code 
file, as shown in Figure 1.10. 



Video Note 

Brief Eclipse Tutorial 



P Wdcomc.jaYa Notepad 



rip Vfi'A format Vwvt Help 



public class Welcome { 

public static void main (St H ng [] args) { 
System, out. pH ntl n ("Wei come to Java I 11 ); 

} } 



Figure 1 . 1 You can create the Java source file using Windows NotePad. 



file name 



compile 



Note 

The source file must end with the extension Java and must have exactly the same name as the 
public class name. For example, the file for the source code in Listing I.I should be named 
Welcome.java, since the public class name is Welcome. 

A Java compiler translates a Java source file into a Java bytecode file. The following com- 
mand compiles Welcome.java: 

javac Welcome.java 



Supplement LB 
Supplement I.C 

.class bytecode file 



Note 

You must first install and configure JDK before compiling and running programs. See Supplement 
LB, "Installing and Configuring JDK 6," on how to install JDK and set up the environment to 
compile and run Java programs. If you have trouble compiling and running programs, please see 
Supplement I.C, "Compiling and Running Java from the Command Window." This supplement 
also explains how to use basic DOS commands and how to use Windows NotePad and Word Pad 
to create and edit files. All the supplements are accessible from the Companion Website. 

If there are no syntax errors, the compiler generates a bytecode file with a .class extension. So 
the preceding command generates a file named Welcome, class, as shown in Figure 1.1 1(a). The 
Java language is a high-level language while Java bytecode is a low-level language. The bytecode 
is similar to machine instructions but is architecture neutral and can run on any platform that has 
a Java Virtual Machine (JVM), as shown in Figure 1.11(b). Rather than a physical machine, the 
virtual machine is a program that interprets Java bytecode. This is one of Java's primary advan- 
tages: Java bytecode can run on a variety of hardware platforms and operating systems. 



Welcome.java 
(Java source 
code file) 





Java 




compiled 


Compiler 


generates 



Welcome.class 
(Java bytecode 
executable file) 



executed 
by 



JVM 




(a) 



(b) 



Figure I.I I (a) Java source code is translated into bytecode. (b) Java bytecode can be executed on any computer with a 
Java Virtual Machine. 
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To execute a Java program is to run the program's bytecode. You can execute the bytecode 
on any platform with a JVM. Java bytecode is interpreted. Interpreting translates the individ- 
ual steps in the bytecode into the target machine-language code one at a time rather than trans- 
lating the whole program as a single unit. Each step is executed immediately after it is 
translated. 

The following command runs the bytecode: 



interpreting bytecode 



java Welcome 

Figure 1.12 shows the javac command for compiling Welcome.java. The compiler gener- 
ated the Welcome. class file. This file is executed using the java command. 



Compile — 
Show files 



Run 



Command Prompt 



Js|x| 



C : \book>javac Welcome. java 

C;\book>dir Welcome. * 
Uolume in drive C has no label. 
Uolume Serial Number is 48F3-18BE 



Directory of C:\book 



12/11/2606 
12/14/2006 



85:24 PM 

05:23 PM 

2 File(s) 
S Dir(sJ 



C:\book>jaua Welcome 
Welcome to Java! 

C:\book> 

±J 



424 Welcome . class 
1 76 Welcome. java 
Geo bytes 
3Q,25Q,3G0,a32 bytes free 



I 



Video Note 

Compile and run a Java program 



Figure 1.12 The output of Listing 1.1 displays the message "Welcome to Java! 



Note 

For simplicity and consistency, all source code and class files are placed under c:\book unless 
specified otherwise. 



c:\book 



Caution 

Do not use the extension .class in the command line when executing the program. Use java 
ClassName to run the program. If you use java ClassName. class in the command line, the 
system will attempt to fetch ClassName. class. class. 



java ClassName 



Tip 

If you execute a class file that does not exist, a NoClassDefFoundError will occur. If you exe- 
cute a class file that does not have a main method or you mistype the main method (e.g., by 
typing Mai n instead of mai n), a NoSuchMethodError will occur. 



NoCl assDef FoundError 
NoSuchMethodError 



Note 

When executing a Java program, the JVM first loads the bytecode of the class to memory using a 
program called the class loader. If your program uses other classes, the class loader dynamically 
loads them just before they are needed. After a class is loaded, the JVM uses a program called 
bytecode verifier to check the validity of the bytecode and ensure that the bytecode does not vio- 
late Java's security restrictions. Java enforces strict security to make sure that Java programs arriv- 
ing from the network do not harm your computer. 



class loader 
bytecode verifier 
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using package 



JOptionPane 

s howMes sageD i al og 



block comment 

import 

main method 
display message 

package 



1.9 



Pedagogical Note 

Instructors may require students to use packages for organizing programs. For example, you may 
place all programs in this chapter in a package named chapter I . For instructions on how to use 
packages, please see Supplement I.F, "Using Packages to Organize the Classes in the Text." 

(GUI) Displaying Text in a Message Dialog Box 

rogram in Listing 1.1 displays the text on the console, as shown in Figure 1.12. 1 



The program in Listing 1.1 displays the text on the console, as shown in Figure 1.12. You can 
rewrite the program to display the text in a message dialog box. To do so, you need to use the 
showMessageDialog method in the JOptionPane class. JOptionPane is one of the many 
predefined classes in the Java system that you can reuse rather than "reinventing the wheel." 
You can use the showMessageDialog method to display any text in a message dialog box, 
as shown in Figure 1.13. The new program is given in Listing 1.4. 



Title bar 



Title 

L 

® 



WclctNnc to Java! 



r°"~i - 



Message 

Click the OK button to 
dismiss the dialog box 



Figure 1.13 "Welcome to Java!" is displayed in a message box. 

Listing 1.4 WelcomelnMessageDialogBox. java 

1 /* This application program displays Welcome to lava! 

2 * in a message dialog box. 

3 */ 

4 import javax. swing. JOptionPane; 
5 

6 public class WelcomelnMessageDialogBox { 

7 public static void main(String[] args) { 

8 // Display Welcome to lava! in a message dialog box 

9 JOptionPane. showMessageDialog (null , "Welcome to Java!"); 

10 } 

11 } 

This program uses a Java class JOptionPane (line 9). Java's predefined classes are grouped 
into packages. JOptionPane is in the javax. swing package. JOptionPane is imported to 
the program using the import statement in line 4 so that the compiler can locate the class 
without the full name javax. swing. JOptionPane. 



Note 

If you replace JOptionPane on line 9 with javax. swing. JOptionPane, you don't need to 
import it in line 4- javax. swing. JOptionPane is the full name for the JOptionPane class. 

The showMessageDialog method is a static method. Such a method should be invoked 
by using the class name followed by a dot operator ( . ) and the method name with arguments. 
Methods will be introduced in Chapter 5, "Methods." The showMessageDialog method can 
be invoked with two arguments, as shown below. 




JOptionPane . showMessageDialog (null , 

"Welcome to Java!"); 



Key Terms 1 7 



The first argument can always be nul 1 . nul 1 is a Java keyword that will be fully intro- 
duced in Chapter 8, "Objects and Classes." The second argument is a string for text to be 
displayed. 

There are several ways to use the showMessageDial og method. For the time being, you two versions of 
need to know only two ways. One is to use a statement, as shown in the example: showMessageDial og 

JOptionPane.showMessageDialog(null , x) ; 

where x is a string for the text to be displayed. 
The other is to use a statement like this one: 

JOptionPane.showMessageDialog(null , x, 
y , JOpti onPane . INFORMATIONLMESSAGE) ; 

where x is a string for the text to be displayed, and y is a string for the title of the message 
box. The fourth argument can be JOptionPane . INFORMATION_MESSACE, which causes the 
icon (^p) to be displayed in the message box. as shown in the following example. 




JOpti on Pane . showMessageDi al og (nul 1 , 

"Welcome to Java!", 
"Display Message", 
JOpti on Pane . INFORMATIONLMESSAGE) ; 



# Note 

There are two types of import statements: specific import and wildcard import. The specific specific import 

import specifies a single class in the import statement. For example, the following statement 
imports DOptionPane from package javax. swing. 

import javax. swing. JOpti onPane ; 

The wildcard import imports all the classes in a package. For example, the following statement wildcard import 

imports all classes from package javax. swing. 

import javax. swing.'-; 

The information for the classes in an imported package is not read in at compile time or runtime 
unless the class is used in the program. The import statement simply tells the compiler where to 

locate the classes. There is no performance difference between a specific import and a wildcard no performance difference 

import declaration. 



^0 Note 

Recall that you have used the System class in the statement System, out. printT n("Wel come 

to Java"); in Listing I.I. The System class is not imported because it is in the java.lang java.lang 

package. All the classes in the java.lang package are implicitly imported in every Java program. implicitly imported 



Key Terms 



.class file 14 byte 3 

Java file 14 bytecode 14 

assembly language 5 bytecode verifier 15 

bit 3 cable modem 5 

block 12 central processing unit (CPU) 

block comment 11 class loader 15 

bus 2 comment 11 
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compiler 7 
console 1 1 
dot pitch 5 

DSL (digital subscriber line) 5 
hardware 2 
high-level language 6 
Integrated Development Environment 

(IDE) 10 
java command 15 
javac command 15 
Java Development Toolkit (JDK) 10 
Java Virtual Machine (JVM) 14 
keyword (or reserved word) 1 1 
line comment 1 1 
machine language 5 
main method 1 1 

(ff Note 

Supplement LA The above terms are defined in the present chapter. Supplement I. A, "Glossary," lists all the 

key terms and descriptions in the book, organized by chapters. 

Chapter Summary 



1 . A computer is an electronic device that stores and processes data. 

2. A computer includes both hardware and software. 

3. Hardware is the physical aspect of the computer that can be seen. 

4. Computer programs, known as software, are the invisible instructions that control the 
hardware and make it perform tasks. 

5. Computer programming is the writing of instructions (i.e., code) for computers to 
perform. 

6. The central processing unit (CPU) is a computer's brain. It retrieves instructions from 
memory and executes them. 

7. Computers use zeros and ones because digital devices have two stable states, referred 
to by convention as zero and one. 

8. A bit is a binary digit or 1 . 

9. A byte is a sequence of 8 bits. 

10. A kilobyte is about 1000 bytes, a megabyte about 1 million bytes, a gigabyte about 1 
billion bytes, and a terabyte about 1000 gigabytes. 

I I . Memory stores data and program instructions for the CPU to execute. 

12. A memory unit is an ordered sequence of bytes. 

I 3. Memory is volatile, because information is lost when the power is turned off. 



memory 3 
modem 5 

network interface card (NIC) 5 

operating system (OS) 7 

pixel 5 

program 5 

programming 5 

resolution 5 

software 5 

source code 7 

source file 14 

specific import 17 

storage devices 4 

statement 1 1 

wildcard import 17 
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14- Programs and data are permanently stored on storage devices and are moved to mem- 
ory when the computer actually uses them. 

1 5 . The machine language is a set of primitive instructions built into every computer. 

I 6. Assembly language is a low-level programming language in which a mnemonic is 
used to represent each machine-language instruction. 

1 7. High-level languages are English-like and easy to learn and program. 

18. A program written in a high-level language is called a source program. 

19. A compiler is a software program that translates the source program into a machine- 
language program. 

20. The operating system (OS) is a program that manages and controls a computer's 
activities. 

2 I . Java is platform independent, meaning that you can write a program once and run it 

anywhere. 

22. Java programs can be embedded in HTML pages and downloaded by Web browsers 
to bring live animation and interaction to Web clients. 

23. Java source files end with the Java extension. 

24. Every class is compiled into a separate bytecode file that has the same name as the 
class and ends with the .class extension. 

25. To compile a Java source-code file from the command line, use the javac command. 

26. To run a Java class from the command line, use the java command. 

27. Every Java program is a set of class definitions. The keyword class introduces a 
class definition. The contents of the class are included in a block. 

28. A block begins with an opening brace ({) and ends with a closing brace (}). Methods 
are contained in a class. 

29. A Java program must have a man n method. The man n method is the entry point where 
the program starts when it is executed. 

30. Every statement in Java ends with a semicolon ( ; ), known as the statement terminator. 

3 I . Reserved words, or keywords, have a specific meaning to the compiler and cannot be 

used for other purposes in the program. 

32. In Java, comments are preceded by two slashes (//) on a line, called a line comment, 
or enclosed between /* and */ on one or several lines, called a block comment. 

33. Java source programs are case sensitive. 

34- There are two types of import statements: specific import and wildcard import. The 
specific import specifies a single class in the import statement. The wildcard import 
imports all the classes in a package. 
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Review Questions 

§ Note 

Answers to review questions are on the Companion Website. 
Sections 1.2-1.4 

I . I Define hardware and software. 

1 .2 List the main components of the computer. 

1.3 Define machine language, assembly language, and high-level programming 
language. 

1 .4 What is a source program? What is a compiler? 

1 .5 What is the JVM? 

1 .6 What is an operating system? 

Sections 1.5-1.6 

1 .7 Describe the history of Java. Can Java run on any machine? What is needed to run 
Java on a computer? 

1 .8 What are the input and output of a Java compiler? 

1 .9 List some Java development tools. Are tools like NetBeans and Eclipse different 
languages from Java, or are they dialects or extensions of Java? 

1 . 1 What is the relationship between Java and HTML? 
Sections 1.7-1.9 

I.I I Explain the Java keywords. List some Java keywords you learned in this chapter. 

1.12 Is Java case sensitive? What is the case for Java keywords? 

1.13 What is the Java source filename extension, and what is the Java bytecode file- 
name extension? 

1.14 What is a comment? Is the comment ignored by the compiler? How do you denote 
a comment line and a comment paragraph? 

1.15 What is the statement to display a string on the console? What is the statement to 
display the message "Hello world" in a message dialog box? 

1.16 The following program is wrong. Reorder the lines so that the program displays 
morni ng followed by afternoon. 

public static void mai n(Stri ng [] args) { 
} 

public class Welcome { 

System. out . pri ntl n ("afternoon") ; 
System. out . pri ntl n("morning") ; 

} 

1.17 Identify and fix the errors in the following code: 

1 public class Welcome { 

2 public void Main(String[] args) { 

3 System. out. pri ntl n(' Wei come to Java!); 

4 } 

5 ) 



Programming Exercises 

1.18 What is the command to compile a Java program? What is the command to run a 
Java program? 

1.19 If a NoCl assDef FoundEr ror occurs when you run a program, what is the cause 
of the error? 

1.20 If a NoSuchMethodError occurs when you run a program, what is the cause of 
the error? 

1 .2 I Why does the System class not need to be imported? 

1.22 Are there any performance differences between the following two import 
statements? 

import javax. swing. JOptionPane ; 
i mport j avax . swi ng . * ; 

1 .23 Show the output of the following code: 

public class Test { 

public static void man n(Stri ng [] args) { 

System. out. println("3. 5 * 4 / 2 - 2. 5 is ") ; 
System. out. println (3. 5 * 4 / 2 - 2.5); 

} 

} 

Programming Exercises 

# Note 

Solutions to even-numbered exercises are on the Companion Website. Solutions to all exer- 
cises are on the Instructor Resource Website. The level of difficulty is rated easy (no star), level of difficulty 
moderate (*), hard (**). or challenging (***). 

I . I (Displaying three messages) Write a program that displays Wei come to Java, 
Welcome to Computer Science, and Programming is fun. 

1 .2 (Displaying five messages) Write a program that displays Wei come to Dava five 
times. 

1.3* (Displaying a pattern) Write a program that displays the following pattern: 

J A V V A 
J A A V V A A 

: J AAAAA V V AAAAA 

] J A A V A A 

1.4 (Printing a table) Write a program that displays the following table: 



a 


aA2 


aA3 


1 


1 


1 


2 


4 


8 


3 


9 


27 


4 


16 


64 



1.5 (Computing expressions) Write a program that displays the result of 
9.5 X 4.5 - 2.5 X 3 
45.5 - 3.5 
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1.6 (Summation of a series) Write a program that displays the result of 
1+2 + 3 + 4 + 5 + 6 + 7 + 8 + 9. 

1.7 (Approximating 77) 77 can be computed using the following formula: 

. f, 1 1 1 1 1 1 

4X1 H H h h • 

3 5 7 9 11 13 



1 1 1 

Write a program that displays the result of 4 X [ 1 1 h 

11 1 \ 

1 . Use 1 . instead of 1 in your program. 

9 11 13/ 



3 5 7 



Chapter 2 



Elementary Programming 



Objectives 



To write Java programs to perform simple calculations (§2.2). 

To obtain input from the console using the Scanner 
class (§2.3). 

To use identifiers to name variables, constants, methods, 
and classes (§2.4). 

To use variables to store data (§§2.5-2.6). 

To program with assignment statements and assignment 
expressions (§2.6). 

To use constants to store permanent data (§2.7). 

To declare Java primitive data types: byte, short, 
int, long, float, double, and char (§2.8.1). 

To use Java operators to write numeric 
expressions (§§2.8.2-2.8.3). 

To display the current time (§2.9). 

To use shorthand operators (§2.10). 

To cast the value of one type to another type (§2.11). 

To compute loan payments (§2.12). 

To represent characters using the char type (§2.13). 

To compute monetary changes (§2.14). 

To represent a string using the String type (§2.15). 

To become familiar with Java documentation, 
programming style, and naming conventions (§2.16). 

To distinguish syntax errors, runtime errors, and logic 
errors and debug errors (§2.17). 

(GUI) To obtain input using the JOptionPane input 
dialog boxes (§2.18). 
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2.1 Introduction 

In Chapter 1 you learned how to create, compile, and run a Java program. Now you will learn 
how to solve practical problems programmatically. Through these problems, you will learn ele- 
mentary programming using primitive data types, variables, constants, operators, expressions, 
and input and output. 



2.2 Writing Simple Programs 



problem 



algorithm 



pseudocode 



To begin, let's look at a simple problem for computing the area of a circle. How do we write a 
program for solving this problem? 

Writing a program involves designing algorithms and translating algorithms into code. An 
algorithm describes how a problem is solved in terms of the actions to be executed and the 
order of their execution. Algorithms can help the programmer plan a program before writing 
it in a programming language. Algorithms can be described in natural languages or in 
pseudocode (i.e., natural language mixed with programming code). The algorithm for this 
program can be described as follows: 

1. Read in the radius. 

2. Compute the area using the following formula: 



area = radius X radius X tt 



3 . Display the area. 



variable 



Many of the problems you will encounter when taking an introductory course in program- 
ming can be described with simple, straightforward algorithms. 

When you code, you translate an algorithm into a program. You already know that every 
Java program begins with a class declaration in which the keyword class is followed by the 
class name. Assume that you have chosen ComputeArea as the class name. The outline of the 
program would look like this: 

public class ComputeArea { 

// Details to be given later 

} 

As you know, every Java program must have a main method where program execution 
begins. So the program is expanded as follows: 

public class ComputeArea { 

public static void main(String[] args) { 

// Step 1: Read in radius 

// Step 2: Compute area 

// Step 3: Display the area 

} 

} 

The program needs to read the radius entered by the user from the keyboard. This raises two 
important issues: 

■ Reading the radius. 

■ Storing the radius in the program. 

Let's address the second issue first. In order to store the radius, the program needs to declare a sym- 
bol called a variable. A variable designates a location in memory for storing data and computa- 
tional results in the program. A variable has a name that can be used to access the memory location. 



2.2 Writing Simple Programs 



Rather than using x and y as variable names, choose descriptive names: in this case, 
radius for radius, and area for area. To let the compiler know what radius and area are, 
specify their data types. Java provides simple data types for representing integers, floating- 
point numbers (i.e., numbers with a decimal point), characters, and Boolean types. These 
types are known as primitive data types or fundamental types. 

Declare radius and area as double-precision floating-point numbers. The program can 
be expanded as follows: 

public class ComputeArea { 

public static void main(String[] args) { 
double radius; 
double area; 

// Step 1: Read in radius 

// Step 2: Compute area 

// Step 3: Display the area 



The program declares radius and area as variables. The reserved word double indicates 
that radius and area are double-precision floating-point values stored in the computer. 

The first step is to read in radius. Reading a number from the keyboard is not a simple 
matter. For the time being, let us assign a fixed value to radi us in the program. 

The second step is to compute area by assigning the result of the expression radius * 
radius * 3 . 14159 to area. 

In the final step, display area on the console by using the System. out. println 
method. 

The complete program is shown in Listing 2.1. A sample run of the program is shown in 
Figure 2.1. 



descriptive names 
floating-point number 
primitive data types 



} 



} 





Compile 



C :\book>jauac ComputeArea. jaua 



Run 



C:\book>jaua ComputeArea 

The area for the c ircle of radius 20 _ is 1256. 636 



C:\book>_ 



±1 




Figure 2.1 The program displays the area of a circle. 



Listing 2.1 ComputeArea. java 



1 public class ComputeArea { 

2 public static void main(String[] args) { 

3 double radius; // Declare radius 

4 double area; // Declare area 
5 

6 // Assign a radius 

7 radius = 20; // New value is radius 
8 

9 // Compute area 

10 area = radius * radius * 3.14159; 
11 

12 // Display results 
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declaring variable 
assign value 



13 
14 

15 } 

16 } 



System. out. pri ntl n("The area for the circle of radius 
radius + " is " + area); 



Variables such as radius and area correspond to memory locations. Every variable has a 
name, a type, a size, and a value. Line 3 declares that radius can store a double value. The 
value is not defined until you assign a value. Line 7 assigns 20 into radius. Similarly, line 4 
declares variable area, and line 10 assigns a value into area. The following table shows the 
value in the memory for area and radius as the program is executed. Each row in the table 
shows the values of variables after the statement in the corresponding line in the program is 
executed. Hand trace is helpful to understand how a program works, and it is also a useful tool 
for finding errors in the program. 



Ox 



line# 


radius 


area 


3 


no value 




4 




no value 


7 


20 




10 




1256.636 



concatenating strings 



concatenating strings with 
numbers 



breaking a long string 



The plus sign (+) has two meanings: one for addition and the other for concatenating 
strings. The plus sign (+) in lines 13-14 is called a string concatenation operator. It combines 
two strings if two operands are strings. If one of the operands is a nonstring (e.g., a number), 
the nonstring value is converted into a string and concatenated with the other string. So the 
plus signs (+) in lines 13-14 concatenate strings into a longer string, which is then displayed 
in the output. Strings and string concatenation will be discussed further in §2.15, "The 
String Type." 



Caution 

A string constant cannot cross lines in the source code. Thus the following statement would 
result in a compile error: 

System. out. pri ntl n ("Introduction to Java Programming, 
by Y. Daniel Liang") ; 

To fix the error, break the string into separate substrings, and use the concatenation operator (+) 
to combine them: 

System. out. pri ntl n ("Introduction to Java Programming, " + 
"by Y. Daniel Liang") ; 



incremental development and 
testing 



H Tip 

This example consists of three steps. It is a good approach to develop and test these steps 
incrementally by adding them one at a time. 



Video Note 

Obtain input 



2.3 Reading Input from the Console 

In Listing 2.1, the radius is fixed in the source code. To use a different radius, you have to 
modify the source code and recompile it. Obviously, this is not convenient. You can use the 
Scanner class for console input. 

Java uses System . out to refer to the standard output device and System . i n to the stan- 
dard input device. By default the output device is the display monitor, and the input device is 



2.3 Reading Input from the Console 



the keyboard. To perform console output, you simply use the printl n method to display a 
primitive value or a string to the console. Console input is not directly supported in Java, but 
you can use the Scanner class to create an object to read input from System . i n, as follows: 

Scanner input = new Scanner(System.in) ; 

The syntax new Scanner (System, in) creates an object of the Scanner type. The syntax 
Scanner input declares that input is a variable whose type is Scanner. The whole line 
Scanner input = new Scanner (System, in) creates a Scanner object and assigns its ref- 
erence to the variable input. An object may invoke its methods. To invoke a method on an 
object is to ask the object to perform a task. You can invoke the methods in Table 2.1 to read 
various types of input. 



Table 2.1 Methods for Scanner Objects 



Method 


Description 


nextByteO 


reads an integer of the byte type. 


nextShortO 


reads an integer of the short type. 


nextlntO 


reads an integer of the i nt type. 


nextLongO 


reads an integer of the 1 ong type. 


nextFloatO 


reads a number of the f 1 oat type. 


nextDoubleO 


reads a number of the doubl e type. 


next() 


reads a string that ends before a whitespace character. 


nextLineQ 


reads a line of text (i.e., a string ending with the Enter key pressed). 



For now, we will see how to read a number that includes a decimal point by invoking the 
nextDoubleO method. Other methods will be covered when they are used. Listing 2.2 
rewrites Listing 2.1 to prompt the user to enter a radius. 



Listing 2.2 ComputeAreaWi thConsol elnput . java 

1 import java. util .Scanner; // Scanner is in the java. util package 
2 

3 public class ComputeAreaWi thConsol elnput { 

4 public static void main(String[] args) { 

// Create a Scanner object 
Scanner input = new Scanner(System.in) ; 



5 

6 

7 

8 

9 
10 
11 
12 
13 
14 
15 
16 
17 
18 

19 } 



// Prompt the user to enter a radius 

System . out . pri nt("Enter a number for radius: ") ; 

double radius = i nput . nextDoubl e() ; 

// Compute area 

double area = radius * radius * 3.14159; 

// Display result 

System. out. println("The area for the circle of radius " + 
radius + " is " + area); 



import class 



create a Scanner 



read a doubl e 



Enter a number for radius: 2.5 ^Enter 

The area for the circle of radius 2.5 is 19.6349375 
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Enter a number for radius: 23 ^Enter 

The area for the circle of radius 23.0 is 1661.90111 



print vs. print! n 



import class 



create a Scanner 



read a doubl e 



The Scanner class is in the java.util package. It is imported in line 1. Line 6 creates a 
Scanner object. 

The statement in line 9 displays a message to prompt the user for input. 
System . out . pri nt ("Enter a number for radius: ") ; 

The print method is identical to the printl n method except that printl n moves the cur- 
sor to the next line after displaying the string, but print does not advance the cursor to the 
next line when completed. 

The statement in line 10 reads an input from the keyboard. 

double radius = i nput . nextDoubl e() ; 

After the user enters a number and presses the Enter key, the number is read and assigned to 
radius. 

More details on objects will be introduced in Chapter 8, "Objects and Classes." For the 
time being, simply accept that this is how to obtain input from the console. 

Listing 2.3 gives another example of reading input from the keyboard. The example reads 
three numbers and displays their average. 

Listing 2.3 ComputeAverage . java 

1 import java.util .Scanner; // Scanner is in the java.util package 



public static void main(String[] args) { 

// Create a Scanner object 
Scanner input = new Scanner(System.in) ; 

// Prompt the user to enter three numbers 
System . out . pri nt("Enter three numbers: ") ; 
double numberl = i nput . nextDoubl e() 
double number2 = i nput . nextDoubl e() 
double number3 = i nput . nextDoubl e() 

// Compute average 

double average = (numberl + number2 + number3) / 3; 

// Display result 

System. out. println("The average of " + numberl + " " + number2 
+ " " + number3 + " is " + average); 



2 




3 


P 


4 




5 




6 




7 




8 




9 




10 




11 




12 




13 




14 




15 




16 




17 




18 




19 




20 




21 


} 



enter input in 
one line 



enter input in 
multiple lines 



Enter three numbers: 12 3 ^Enter 
The average of 1.0 2.0 3.0 is 2. 








Enter three numbers: 10.5 ^Enter 

11 pEnter 
11 . 5 -J Enter 



The average of 10.5 11.0 11.5 is 11.0 



2.5 Variables 



The code for importing the Scanner class (line 1) and creating a Scanner object (line 6) are 
the same as in the preceding example as well as in all new programs you will write. 

Line 9 prompts the user to enter three numbers. The numbers are read in lines 10-12. You 
may enter three numbers separated by spaces, then press the Enter key, or enter each number 
followed by a press of the Enter key, as shown in the sample runs of this program. 

2.4 Identifiers 

As you see in Listing 2.3, ComputeAverage, main, input, number 1, number2, number 3, 

and so on are the names of things that appear in the program. Such names are called 
identifiers. All identifiers must obey the following rules: 

■ An identifier is a sequence of characters that consists of letters, digits, underscores identifier naming rules 
(_), and dollar signs ($). 

■ An identifier must start with a letter, an underscore (_), or a dollar sign ($). It cannot 
start with a digit. 

■ An identifier cannot be a reserved word. (See Appendix A, "Java Keywords," for a 
list of reserved words.) 

■ An identifier cannot be true, f al se, or nul 1 . 

■ An identifier can be of any length. 

For example, $2, ComputeArea, area, radius, and showMessageDialog are legal identi- 
fiers, whereas 2A and d+4 are not because they do not follow the rules. The Java compiler 
detects illegal identifiers and reports syntax errors. 

|p Note 

Since Java is case sensitive, area, Area, and AREA are all different identifiers. case sensitive 

'«■>' 

HI Tip 

Identifiers are for naming variables, constants, methods, classes, and packages. Descriptive iden- descriptive names 

tifiers make programs easy to read. 

# Tip 

Do not name identifiers with the $ character. By convention, the $ character should be used only the $ character 

in mechanically generated source code. 

2.5 Variables 

As you see from the programs in the preceding sections, variables are used to store values to why called variables? 
be used later in a program. They are called variables because their values can be changed. In 
the program in Listing 2.2, radius and area are variables of double-precision, floating- 
point type. You can assign any numerical value to radius and area, and the values of 
radius and area can be reassigned. For example, you can write the code shown below to 
compute the area for different radii: 

// Compute the fi rst area 
radius = 1.0; 

area = radius * radius * 3.14159; 

System. out. println ("The area is " + area + " for radius " + radius); 

// Compute the second area 
radius = 2.0; 

area = radius * radius * 3.14159; 

System. out. pri nt~l n("The area is " + area + " for radius " + radius); 
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declaring variables 



Variables are for representing data of a certain type. To use a variable, you declare it by telling 
the compiler its name as well as what type of data it can store. The variable declaration tells 
the compiler to allocate appropriate memory space for the variable based on its data type. The 
syntax for declaring a variable is 

datatype vari abl eName ; 

Here are some examples of variable declarations: 

int count; // Declare count to be an integer variable; 

double radius; // Declare radius to be a double variable; 

double i nterestRate ; // Declare interestRate to be a double variable; 

The examples use the data types int, double, and char. Later you will be introduced to 
additional data types, such as byte, short, long, float, char, and boolean. 

If variables are of the same type, they can be declared together, as follows: 

datatype variablel, variable2, variablen; 
The variables are separated by commas. For example, 

int i , j, k; // Declare i, j, and k as int variables 



naming variables 



initializing variables 



jp Note 

By convention, variable names are in lowercase. If a name consists of several words, concatenate 
all of them and capitalize the first letter of each word except the first. Examples of variables are 
radius and interestRate. 

Variables often have initial values. You can declare a variable and initialize it in one step. 
Consider, for instance, the following code: 

int count = 1; 

This is equivalent to the next two statements: 

int count; 
x = 1; 

You can also use a shorthand form to declare and initialize variables of the same type together. 
For example, 



int i 



1, j = 2; 



assignment statement 
assignment operator 



i| Tip 

A variable must be declared before it can be assigned a value. A variable declared in a method 
must be assigned a value before it can be used. 

Whenever possible, declare a variable and assign its initial value in one step. This will make the 
program easy to read and avoid programming errors. 

2.6 Assignment Statements and Assignment 
Expressions 

After a variable is declared, you can assign a value to it by using an assignment statement. In 
Java, the equal sign (=) is used as the assignment operator. The syntax for assignment state- 
ments is as follows: 



vari abl e 



= expression; 



2.7 Named Constants 



An expression represents a computation involving values, variables, and operators that, expression 
taking them together, evaluates to a value. For example, consider the following code: 

int x = 1; // Assign 1 to variable x 

double radius =1.0; // Assign 1.0 to variable radius 

x = 5 * (3 / 2) + 3 * 2 ; // Assign the value of the expression to x 

x = y + 1; // Assign the addition of y and 1 to x 

area = radius * radius * 3.14159; // Compute area 

A variable can also be used in an expression. For example, 

x = x + 1; 

In this assignment statement, the result of x + 1 is assigned to x. If x is 1 before the state- 
ment is executed, then it becomes 2 after the statement is executed. 

To assign a value to a variable, the variable name must be on the left of the assignment 
operator. Thus, 1 = x would be wrong. 

HI Note 

In mathematics, x = 2 * x + 1 denotes an equation. However, in Java, x = 2 * x + 1 is 
an assignment statement that evaluates the expression 2 * x + 1 and assigns the result to x. 

In Java, an assignment statement is essentially an expression that evaluates to the value to be 

assigned to the variable on the left-hand side of the assignment operator. For this reason, an 

assignment statement is also known as an assignment expression. For example, the following assignment expression 

statement is correct: 

System. out. println(x = 1); 

which is equivalent to 

x = 1; 

System. out. println(x) ; 
The following statement is also correct: 

i = j = k = 1; 
which is equivalent to 

k = 1; 
j = k; 
i = j; 

§ Note 

In an assignment statement, the data type of the variable on the left must be compatible with the 
data type of the value on the right. For example, int x = 1.0 would be illegal, because the 
data type of x is int. You cannot assign a double value (1.0) to an int variable without using 
type casting. Type casting is introduced in §2.1 1 "Numeric Type Conversions." 

2.7 Named Constants 

The value of a variable may change during the execution of a program, but a named constant 
or simply constant represents permanent data that never changes. In our ComputeArea pro- constant 
gram, 77 is a constant. If you use it frequently, you don't want to keep typing 3 . 14159; 
instead, you can declare a constant for it. Here is the syntax for declaring a constant: 

final datatype CONSTANTNAME = VALUE; 
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A constant must be declared and initialized in the same statement. The word f i nal is a 
Java keyword for declaring a constant. For example, you can declare tt as a constant and 
rewrite Listing 2.1 as follows: 

// ComputeArea. java: Compute the area of a circle 
public class ComputeArea { 

public static void main(String[] args) { 

final double PI = 3.14159; // Declare a constant 

// Assign a radius 
double radius = 20; 

// Compute area 

double area = radius * radius * PI; 

// Display results 

System . out . pri ntl n("The area for the circle of radius " + 
radius + " is " + area); 

} 

} 

tip Caution 

naming constants " By convention, constants are named in uppercase: PI, not pi or Pi. 

§tg Note 

benefits of constants There are three benefits of using constants: ( I ) you don't have to repeatedly type the same value: 

(2) if you have to change the constant value (e.g., from 3 . 14 to 3 . 14159 for PI), you need to 
change it only in a single location in the source code; (3) a descriptive name for a constant makes 
the program easy to read. 



2.8 Numeric Data Types and Operations 

Every data type has a range of values. The compiler allocates memory space for each variable 
or constant according to its data type. Java provides eight primitive data types for numeric val- 
ues, characters, and Boolean values. This section introduces numeric data types. 
Table 2.2 lists the six numeric data types, their ranges, and their storage sizes. 



Table 2.2 Numeric Data Types 



Name 



Range 



Storage Size 



byte 
short 
int 
long 

float 
double 



-2 7 (-128) to2 7 -l (127) 8-bitsigned 

-2 15 (-32768) to 2 15 -1 (32767) 16 " bit si S ned 

-2 31 (-2147483648) to 2 31 - 1 (2147483647) 32 " bit si g ned 

— 2 63 to 2 63 — 1 64-bit signed 
(i.e., -9223372036854775808 
to 9223372036854775807) 

Negative range: -3.4028235E + 38 to -1.4E-45 32-bit IEEE 754 
Positive range: 1.4E-45 to 3.4028235E + 38 

Negative range: - 1.7976931348623157E + 308 to -4.9E-324 64-bit IEEE 754 
Positive range: 4.9E - 324 to 1.7976931348623157E + 308 



2.8 Numeric Data Types and Operations 



Note 

IEEE 754 is a standard approved by the Institute of Electrical and Electronics Engineers for represent- 
ing floating-point numbers on computers. The standard has been widely adopted. Java has adopted 
the 32-bit IEEE 754 for the float type and the 64-bit IEEE 754 for the double type. The IEEE 
754 standard also defines special values as given in Appendix E, "Special Floating-Point Values." 

Java uses four types for integers: byte, short, int, and long. Choose the type that is most 
appropriate for your variable. For example, if you know an integer stored in a variable is 
within a range of byte, declare the variable as a byte. For simplicity and consistency, we will 
use i nt for integers most of the time in this book. 

Java uses two types for floating-point numbers: float and double. The double type is 
twice as big as f 1 oat. So, the doubl e is known as double precision, f 1 oat as single precision. 
Normally you should use the doubl e type, because it is more accurate than the f 1 oat type. 



integer types 



floating point 



Caution 

When a variable is assigned a value that is too large (in size) to be stored, it causes overflow. For what is overflow? 

example, executing the following statement causes overflow, because the largest value that can 
be stored in a variable of the int type is 2147483647. 2147483648 is too large. 

int value = 2147483647 + 1; // value will actually be -2147483648 

Likewise, executing the following statement causes overflow, because the smallest value that can 
be stored in a variable of the int type is -2147483648. -2147483649 is too large in size to 
be stored in an int variable. 

int value = -2147483648 - 1; // value will actually be 2147483647 

Java does not report warnings or errors on overflow. So be careful when working with numbers 
close to the maximum or minimum range of a given type. 

When a floating-point number is too small (i.e., too close to zero) to be stored, it causes 

underflow. Java approximates it to zero. So normally you should not be concerned with underflow. what is underflow? 



2.8.1 Numeric Operators 

The operators for numeric data types include the standard arithmetic operators: addition (+), operators +, -, *, /, % 
subtraction (-), multiplication (*), division (/), and remainder (%), as shown in Table 2.3. 

When both operands of a division are integers, the result of the division is an integer. The integer division 
fractional part is truncated. For example, 5/2 yields 2, not 2.5, and - 5 / 2 yields -2, not 
-2 . 5. To perform regular mathematical division, one of the operands must be a floating-point 
number. For example, 5.0/2 yields 2.5. 

The % operator yields the remainder after division. The left-hand operand is the dividend 
and the right-hand operand the divisor. Therefore, 7 % 3 yields 1, 12 % 4 yields 0, 26 % 8 
yields 2, and 20 % 13 yields 7. 



Table 2.3 Numeric Operators 

Name Meaning Example Result 

+ Addition 34+1 35 

Subtraction 34.0-0.1 33.9 

Multiplication 300 * 30 9000 

/ Division 1.0/2.0 0.5 

% Remainder 20 % 3 2 
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\j 12 
12 




26 
24 



Divisor 



-13/ 20 
13 



1 ■< Quotient 

— Dividend 



7 



Remainder 



import Scanner 
create a Scanner 



read an integer 

divide 
remainder 



The % operator is often used for positive integers but can be used also with negative integers 
and floating-point values. The remainder is negative only if the dividend is negative. For example, 
-7 % 3 yields -1, -12 % 4 yields 0, -26 % -8 yields -2, and 20 % -13 yields 7. 

Remainder is very useful in programming. For example, an even number % 2 is always 
and an odd number % 2 is always 1. So you can use this property to determine whether a num- 
ber is even or odd. If today is Saturday, it will be Saturday again in 7 days. Suppose you and 
your friends are going to meet in 10 days. What day is in 10 days? You can find that the day 
is Tuesday using the following expression: 



Day 6 in a week is Saturday 



A week has 7 days 



(6 + 10) % 7 is 2 . 



Day 2 in a week is Tuesday 
Note: Day in a week is Sunday 



After 10 days 



Listing 2.4 gives a program that obtains minutes and remaining seconds from an amount of 
time in seconds. For example, 500 seconds contains 8 minutes and 20 seconds. 

Listing 2.4 DisplayTime. java 

"import java. util .Scanner; 



1 
2 
3 
4 
5 
6 
7 
8 
9 
10 
11 
12 
13 
14 
15 



public class DisplayTime { 

public static void main(String[] args) { 
Scanner input = new Scanner(System.in) ; 

// Prompt the user for input 

System . out . pri nt("Enter an integer for seconds: 
int seconds = i nput . nextlntQ ; 



"); 



int minutes = seconds / 60 ; // Find minutes in seconds 
int remai ni ngSeconds = seconds % 60 ; // Seconds remaining 
System . out . pri ntl n (seconds + " seconds is " + minutes + 
" minutes and " + remai ni ngSeconds + " seconds"); 



Enter an integer for seconds: 500 p&teT 
500 seconds is 8 minutes and 20 seconds 



Ox 


line# 


seconds 


minutes 


remainingSeconds 




8 


500 








10 
I I 




8 


20 



The nextlntO method (line 8) reads an integer for seconds. Line 4 obtains the minutes 
using seconds / 60. Line 5 (seconds % 60) obtains the remaining seconds after taking 
away the minutes. 
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The + and - operators can be both unary and binary. A unary operator has only one unary operator 
operand; a binary operator has two. For example, the - operator in -5 is a unary operator binary operator 
to negate number 5, whereas the - operator in 4 - 5 is a binary operator for subtracting 5 
from 4. 

||| Note 

Calculations involving floating-point numbers are approximated because these numbers are not floating-point approximation 

stored with complete accuracy. For example. 

System. out. pn'ntln (1.0 - 0.1 - 0.1 - 0.1 - 0.1 - 0.1); 
displays 0. 5000000000000001, not 0. 5, and 
System. out. print~ln(1.0 - 0.9); 

displays 0.09999999999999998, not 0.1. Integers are stored precisely. Therefore, calcula- 
tions with integers yield a precise integer result. 



2.8.2 Numeric Literals 

A literal is a constant value that appears directly in a program. For example, 34 and 0. 305 literal 
are literals in the following statements: 

int numberOfYears = 34; 
double weight = 0.305; 

Integer Literals 

An integer literal can be assigned to an integer variable as long as it can fit into the variable. 
A compile error will occur if the literal is too large for the variable to hold. The statement 
byte b = 128, for example, will cause a compile error, because 128 cannot be stored in a 
variable of the byte type. (Note that the range for a byte value is from —128 to 127.) 

An integer literal is assumed to be of the int type, whose value is between 
-2 31 (-2147483648) and2 31 - 1 (2147483647). To denote an integer literal of the long type, longliteral 
append the letter L or 1 to it (e.g., 2147483648L). L is preferred because 1 (lowercase L) can eas- 
ily be confused with 1 (the digit one). To write integer 2147483648 in a Java program, you have 
to write it as 2147483648L, because 2147483648 exceeds the range for the int value. 

§ Note 

By default, an integer literal is a decimal integer number. To denote an octal integer literal, use a octal and hex literals 

leading (zero), and to denote a hexadecimal integer literal, use a leading Ox or OX (zero x). For 
example, the following code displays the decimal value 65535 for hexadecimal number FFFF. 

System . out . pri ntl n (OxFFFF) ; 

Hexadecimal numbers, binary numbers, and octal numbers are introduced in Appendix F, "Num- 
ber Systems." 



Floating-Point Literals 

Floating-point literals are written with a decimal point. By default, a floating-point literal is 

treated as a doubl e type value. For example, 5 . is considered a doubl e value, not a f 1 oat 

value. You can make a number a f 1 oat by appending the letter f or F, and you can make a 

number a double by appending the letter d or D. For example, you can use 100. 2 f or suffix d or D 

100 . 2 F for a f 1 oat number, and 100 . 2d or 100 . 2D for a doubl e number. suffix f or F 

^0 Note 

The doubl e type values are more accurate than the f 1 oat type values. For example, doubl e vs. f 1 oat 
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System. out. print~ln("1.0 / 3.0 is " + 1.0 / 3.0); 
displays 1.0 / 3.0 is 0.3333333333333333. 
System. out. print~ln("l. OF / 3. OF is " + l.OF / 3. OF); 
displays 1. OF / 3. OF is 0.33333334. 

Scientific Notation 

Floating-point literals can also be specified in scientific notation; for example, 1 . 23456e+2, 
the same as 1.23456e2, is equivalent to 1.23456 X 10 2 = 123.456, and 1.23456e-2 is 
equivalent to 1.23456 X 10~ 2 = 0.0123456. E (or e) represents an exponent and can be in 
either lowercase or uppercase. 

^ Note 

why called floating-point? The float and double types are used to represent numbers with a decimal point. Why are 

they called floating-point numbers? These numbers are stored in scientific notation. When a 
number such as 50. 534 is converted into scientific notation, such as 5.0534e+l, its decimal 
point is moved (i.e., floated) to a new position. 



2.8.3 Evaluating Java Expressions 

Writing a numeric expression in Java involves a straightforward translation of an arithmetic 
expression using Java operators. For example, the arithmetic expression 

3 + Ax _ 10(y ~ 5) (a + b + c) + J 4 + 9 + x 
5 x \x y 

can be translated into a Java expression as: 

(3 + 4 * x) / 5 - 10 * (y - 5) * (a + b + c) / x + 
9 * (4 / x + (9 + x) / y) 

Though Java has its own way to evaluate an expression behind the scene, the result of a Java 
expression and its corresponding arithmetic expression are the same. Therefore, you can 
evaluating an expression safely apply the arithmetic rule for evaluating a Java expression. Operators contained within 

pairs of parentheses are evaluated first. Parentheses can be nested, in which case the expres- 
sion in the inner parentheses is evaluated first. Multiplication, division, and remainder opera- 
tors are applied next. If an expression contains several multiplication, division, and remainder 
operators, they are applied from left to right. Addition and subtraction operators are applied 
last. If an expression contains several addition and subtraction operators, they are applied 
from left to right. Here is an example of how an expression is evaluated: 



3 + 4*4+5* (4 + 3) -1 

t 

3 + 4*4 + 5*7-1 

I 



3 + 16 + 5*7-1 

I 

3+16+35-1 
{ 



19+35-1 
t 



54-1 
t_ 

53 



(1) inside parentheses first 

(2) multiplication 

(3) multiplication 

(4) addition 

(5) addition 

(6) subtraction 
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Listing 2.5 gives a program that converts a Fahrenheit degree to Celsius using the formula 
Celsius = (§)(/ ahrenheit — 32). 

Listing 2.5 Fahrenhei tToCel si us . java 

1 import java. util .Scanner; 

2 

3 public class Fahrenhei tToCel si us { 

4 public static void main(String[] args) { 

5 Scanner input = new Scanner(System.in) ; 
6 

7 System . out . pri nt("Enter a degree in Fahrenheit: "); 

8 double fahrenheit = i nput . nextDoubl e() ; 
9 

10 // Convert Fahrenheit to Celsius 

11 double Celsius = (5.0 / 9) * (fahrenheit - 32); divide 

12 System. out. pri ntl n("Fahrenheit " + fahrenheit + " is " + 

13 Celsius + " in Celsius"); 

14 } 

15 } 



Enter a degree in Fahrenheit: 100 center 
Fahrenheit 100.0 is 37 . 77777777777778" i Tn Celsius 




line# 


fahrenheit 


celsius 


8 


100 




I 1 




37.77777777777778 



Be careful when applying division. Division of two integers yields an integer in Java. | is trans- integer vs. decimal division 
lated to 5 . / 9 instead of 5 / 9 in line 11, because 5/9 yields in Java. 

2.9 Problem: Displaying the Current Time 

Vid60 Not€ 

The problem is to develop a program that displays the current time in GMT (Greenwich Mean ^ operators / and °/ 
Time) in the format hour:minute:second, such as 13:19:8. 

The currentTimeMillis method in the System class returns the current time in mil- currentTimeMillis 
liseconds elapsed since the time 00 : 00 : 00 on January 1 , 1970 GMT, as shown in Figure 2.2. 
This time is known as the Unix epoch, because 1970 was the year when the Unix operating Unix epoch 
system was formally introduced. 





Elapsed 




time 









Time 



Unix Epoch Current Time 

01-01-1970 System.currentTimeMillis() 
00:00:00 GMT 



Figure 2.2 The System. currentTimeMil 1 is() returns the number of milliseconds 
since the Unix epoch. 



You can use this method to obtain the current time, and then compute the current second, 
minute, and hour as follows. 
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1. Obtain the total milliseconds since midnight, Jan 1, 1970, in total Milliseconds by 
invoking System. currentTimeMill is() (e.g., 1203183086328 milliseconds). 

2. Obtain the total seconds total Seconds by dividing total Milliseconds by 1000 
(e.g., 1203183086328 milliseconds / 1000 = 1203183086 seconds). 

3. Compute the current second from total Seconds % 60 (e.g., 1203183086 seconds 
% 60 = 26, which is the current second). 

4. Obtain the total minutes total Minutes by dividing total Seconds by 60 (e.g., 
1203183086 seconds / 60 = 20053051 minutes). 

5. Compute the current minute from total Minutes % 60 (e.g., 20053051 minutes % 
60 = 31, which is the current minute). 

6. Obtain the total hours total Hours by dividing total Minutes by 60 (e.g., 
20053051 minutes / 60 = 334217 hours). 

7. Compute the current hour from total Hours % 24 (e.g., 334217 hours % 24 = 17, 
which is the current hour). 

Listing 2.6 gives the complete program. 

Listing 2.6 ShowCurrentTime. java 

1 public class ShowCurrentTime { 

2 public static void main(String[] args) { 

3 // Obtain the total milliseconds since midnight, Dan 1, 1970 

4 long total Mi 1 1 i seconds = System. currentTimeMi 11 i s() ; 
5 

6 // Obtain the total seconds since midnight, Dan 1, 1970 

7 long totalSeconds = totalMilliseconds / 1000; 
8 

9 // Compute the current second in the minute in the hour 

10 long currentSecond = (int) (total Seconds % 60); 
11 

12 // Obtain the total minutes 

13 long totalMinutes = totalSeconds / 60; 
14 

15 // Compute the current minute in the hour 

16 long currentMi nute = totalMinutes % 60; 
17 

18 // Obtain the total hours 

19 long totalHours = totalMinutes / 60; 
20 

21 // Compute the current hour 

22 long currentHour = totalHours % 24; 
23 

24 // Display results 

25 System. out. pri ntl n("Current time is " + currentHour + ":" 

26 + currentMi nute + ":" + currentSecond + " GMT"); 

27 } 

28 } 



total Milli seconds 



totalSeconds 



currentSecond 



totalMinutes 



currentMinute 



total Hours 



currentHour 




Current time is 17:31:26 CMT 
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Iine# 

variables ^^-^^ 


4 


7 


10 


13 


16 


19 


22 


totalMilliseconds 


1203183086328 














totalSeconds 




1203183086 












currentSecond 






26 










total Minutes 








20053051 








currentMinute 










31 






totalHours 












3342 1 7 




currentHour 














17 



When System. currentTimeMil 1 is() (line 4) is invoked, it returns the difference, 
measured in milliseconds, between the current GMT and midnight, January 1, 1970 GMT. 
This method returns the milliseconds as a 1 ong value. So, all the variables are declared as the 
1 ong type in this program. 

2.10 Shorthand Operators 

Very often the current value of a variable is used, modified, and then reassigned back to the 
same variable. For example, the following statement adds the current value of i with 8 and 
assigns the result back to i : 

i=i+8; 

Java allows you to combine assignment and addition operators using a shorthand operator. For 
example, the preceding statement can be written as: 

i += ; 

The += is called the addition assignment operator. Other shorthand operators are shown in addition assignment operator 
Table 2.4. 



Table 2.4 


Shorthand Operators 






Operator 


Name 


Example 


Equivalent 


+= 


Addition assignment 


i += 8 


i = i+8 




Subtraction assignment 


i -= 8 


i = i-8 




Multiplication assignment 


i *= 8 


i = i*8 


/= 


Division assignment 


i /= 8 


i = i/8 


%= 


Remainder assignment 


i %= 8 


i = i % 8 
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Caution 

There are no spaces in the shorthand operators. For example, + = should be +=. 



Note 

Like the assignment operator (=), the operators (+=, -=, *=, /=, %=) can be used to form an 
assignment statement as well as an expression. For example, in the following code, x += 2 is a 
statement in the first line and an expression in the second line. 



x += 2 ; // Statement 
System, out. print~ln(x += 



2) ; // Expression 



There are two more shorthand operators for incrementing and decrementing a variable by 1. 
These are handy, because that's often how much the value needs to be changed. The two opera- 
tors are ++ and — . For example, the following code increments i by 1 and decrements j by 1. 



int i=3, 

// i 
j— ; // j 



j = 3; 

becomes 4 
becomes 2 



The ++ and — operators can be used in prefix or suffix mode, as shown in Table 2.5. 
Table 2.5 Increment and Decrement Operators 



Operator 


Name 


Description 


Example ( assume i 


= 1) 




++var 


preincrement 


Increment var by 1 and 


int j = ++i ; 


// 


j "is 


2, 






use the new var value 


// i is 2 








var++ 


postincrement 


Increment var by 1, but 


int j = i++; 


// 


j "is 


1, 






use the original var value 


// i is 2 








--var 


predecrement 


Decrement var by 1 and 


int j = --i ; 


// 


j "is 


0, 






use the new var value 


// i is 








var-- 


postdecrement 


Decrement var by 1 and 


int j = ++i ; 


// 


j "is 


1, 






use the original var value 


// i is 









preincrement, predecrement 
postincrement, postdecrement 



If the operator is before (prefixed to) the variable, the variable is incremented or decremented 
by 1, then the new value of the variable is returned. If the operator is after (suffixed to) the vari- 
able, then the variable is incremented or decremented by 1, but the original old value of the vari- 
able is returned. Therefore, the prefixes ++x and — x are referred to, respectively, as the 
preincrement operator and the predecrement operator, and the suffixes x++ and x — are referred 
to, respectively, as the postincrement operator and the postdecrement operator. The prefix form 
of ++ (or — ) and the suffix form of ++ (or — ) are the same if they are used in isolation, but they 
cause different effects when used in an expression. The following code illustrates this: 



int i = 10; 
int newNum = 



10 



Same effect as 


int newNum = 10 * i ; 






i=i+l; 



In this case, i is incremented by 1, then the old value of i is returned and used in the mul- 
tiplication. So newNum becomes 100. If i++ is replaced by ++i as follows, 



int i = 10; 
int newNum = 10 



(++i); 



Same effect as 



i = i +1; 
int newNum 



10 



2.11 Numeric Type Conversions 



i is incremented by 1, and the new value of i is returned and used in the multiplication. Thus 
newNum becomes 110. 
Here is another example: 

double x = 1.0; 
double y = 5.0; 
double z = x — + (++y) ; 

After all three lines are executed, y becomes 6 . 0, z becomes 7 . 0, and x becomes . 0. 

The increment operator ++ and the decrement operator — can be applied to all integer and 
floating-point types. These operators are often used in loop statements. A loop statement is a 
construct that controls how many times an operation or a sequence of operations is performed 
in succession. This construct, and the topic of loop statements, are introduced in Chapter 4, 
"Loops." 

# Tip 

Using increment and decrement operators makes expressions short, but it also makes them com- 
plex and difficult to read. Avoid using these operators in expressions that modify multiple vari- 
ables or the same variable multiple times, such as this one: int k = ++i + i. 



2.1 1 Numeric Type Conversions 

Can you perform binary operations with two operands of different types? Yes. If an integer 
and a floating-point number are involved in a binary operation, Java automatically converts 
the integer to a floating-point value. So, 3 * 4 . 5 is same as 3 . * 4 . 5. 

You can always assign a value to a numeric variable whose type supports a larger range of 
values; thus, for instance, you can assign a 1 ong value to a f 1 oat variable. You cannot, how- 
ever, assign a value to a variable of a type with smaller range unless you use type casting. 
Casting is an operation that converts a value of one data type into a value of another data type. 
Casting a variable of a type with a small range to a variable of a type with a larger range is 
known as widening a type. Casting a variable of a type with a large range to a variable of a 
type with a smaller range is known as narrowing a type. Widening a type can be performed 
automatically without explicit casting. Narrowing a type must be performed explicitly. 

The syntax is the target type in parentheses, followed by the variable's name or the value to 
be cast. For example, the following statement 

System . out . pri ntl n((int) 1.7); 

displays 1. When a double value is cast into an int value, the fractional part is truncated. 
The following statement 

System. out. print~ln((double)l / 2); 

displays 0.5, because 1 is cast to 1 . first, then 1 . is divided by 2. However, the statement 

System. out. print~ln(l / 2); 
displays 0, because 1 and 2 are both integers and the resulting value should also be an integer. 

fjgP Caution 

Casting is necessary if you are assigning a value to a variable of a smaller type range, such as possible loss of precision 

assigning a double value to an int variable. A compile error will occur if casting is not used in 
situations of this kind. Be careful when using casting. Loss of information might lead to 
inaccurate results. 



widening a type 
narrowing a type 

type casting 



42 Chapter 2 Elementary Programming 



Note 

Casting does not change the variable being cast. For example, d is not changed after casting in 
the following code: 

double d = 4.5; 

int i = (int)d; // i becomes 4, but d is not changed, still 4.5 
Note 

To assign a variable of the int type to a variable of the short or byte type, explicit casting 
must be used. For example, the following statements have a compile error: 

int i=l; 

byte b = i; // Error because explicit casting is required 

However, so long as the integer literal is within the permissible range of the target variable, 
explicit casting is not needed to assign an integer literal to a variable of the short or byte type. 
Please refer to §2.8.2, "Numeric Literals." 

Listing 2.7 gives a program that displays the sales tax with two digits after the decimal point. 



Listing 2.7 SalesTax. java 



1 import java. util .Scanner; 
2 

3 public class SalesTax { 

4 public static void main(String[] args) { 

5 Scanner input = new Scanner(System.in) ; 
6 

7 System . out . pri nt("Enter purchase amount: ") ; 

8 double purchaseAmount = i nput . nextDoubl e() ; 
9 

casting 10 double tax = purchaseAmount * 0.06; 

11 System. out. println("Sales tax is " + (int)(tax * 100) / 100.0) 

12 } 

13 } 




Enter purchase amount: 197.55 ^Enter 
Sales tax is 11.85 



line# 


purchaseAmount 


tax 


output 


8 


197.55 






10 




1 1.853 




1 1 






1 1.85 



formatting numbers Variable purchaseAmount is 197 . 55 (line 8). The sales tax is 6% of the purchase, so the 

tax is evaluated as 11.853 (line 10). Note that 

tax * 100 is 1185.3 

(int) (tax * 100) is 1185 

(int) (tax * 100) / 100.0 is 11.85 

So, the statement in line 1 1 displays the tax 11.85 with two digits after the decimal point. 



2.12 Problem: Computing Loan Payments 



2.12 Problem: Computing Loan Payments 

The problem is to write a program that computes loan payments. The loan can be a car loan, a 

student loan, or a home mortgage loan. The program lets the user enter the interest rate, num- n 

° ° r ° Program computations 

ber of years, and loan amount, and displays the monthly and total payments. 

The formula to compute the monthly payment is as follows: 

loanAmount X monthly Inter est Rate 



monthly Payment = \ 

(1 + monthlyInterestRate) number ° fYearsXn 

You don't have to know how this formula is derived. Nonetheless, given the monthly interest 
rate, number of years, and loan amount, you can use it to compute the monthly payment. 

In the formula, you have to compute (1 + mont hly Inter est Rat e) m " nber0fYearsX 12 . The 
pow(a, b) method in the Math class can be used to compute a h . The Math class, which pow(a, b) method 
comes with the Java API, is available to all Java programs. For example, 

System. out. println (Math. pow(2, 3)); // Display 8 
System. out. println (Math. pow(4, 0.5)); // Display 4 

(1 + monthly I nterestRate) number0fYearsXU can be computed using Math.pow(l + 
monthlylnterestRate, numberOf Years * 12). 

Here are the steps in developing the program: 

1. Prompt the user to enter the annual interest rate, number of years, and loan amount. 

2. Obtain the monthly interest rate from the annual interest rate. 

3. Compute the monthly payment using the preceding formula. 

4. Compute the total payment, which is the monthly payment multiplied by 12 and multi- 
plied by the number of years. 

5. Display the monthly payment and total payment. 
Listing 2.8 gives the complete program. 

Listing 2.8 ComputeLoan . j ava 

1 import java.util .Scanner; importclass 
2 

3 public class ComputeLoan { 

4 public static void main(String[] args) { 

5 // Create a Scanner 

6 Scanner input = new Scanner(System . i n) ; create a Scanner 
7 

8 // Enter yearly interest rate 

9 System. out. print("Enter yearly interest rate, for example 8.25: ") ; 

10 double annual InterestRate = input. nextDouble() ; enter interest rate 

11 

12 // Obtain monthly interest rate 

13 double monthlylnterestRate = annual InterestRate / 1200; 
14 

15 // Enter number of years 

16 System. out. print( 

17 "Enter number of years as an integer, for example 5: ") ; 

18 int numberOfYears = i nput . nextlnt() ; enter years 
19 

20 // Enter loan amount 

21 System . out . pri nt("Enter loan amount, for example 120000.95: ") ; 
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enter loan amount 

monthlyPayment 
total Payment 

casting 
casting 



22 
23 
24 
25 
26 
27 
28 
29 
30 
31 
32 
33 
34 

35 } 



double "loanAmount = i nput . nextDoubl e() ; 

// Calculate payment 

double monthl yPayment = loanAmount * monthl ylnterestRate / (1 
- 1 / Math.pow(l + monthlylnterestRate, numberOfYears * 12)); 
double totalPayment = monthlyPayment * numberOfYears * 12; 

// Display results 
System. out. println("The monthly payment is " + 

(int) (monthlyPayment * 100) / 100.0); 
System. out. println("The total payment is " + 

(int) (total Payment * 100) / 100.0); 

} 



Enter yearly interest rate, for example 8.25: 5.75 
Enter number of years as an integer, for example 5: 15 
Enter loan amount, for example 120000.95: 2 50000 f^] 
The monthly payment is 2076.02 
The total payment is 373684.53 



^^^^^ Iine# 
variables ^^^^^ 


10 


13 18 


22 


25 


27 


annuallnterestRate 


5.75 










monthlylnterestRate 




0.0047916666666 








numberOfYears 




15 








loanAmount 






250000 






monthlyPayment 








2076.0252175 




totalPayment 










373684.539 



Line 10 reads the yearly interest rate, which is converted into monthly interest rate in line 
13. If you entered an input other than a numeric value, a runtime error would occur. 

Choose the most appropriate data type for the variable. For example, numberOfYears is 
best declared as an i nt (line 18), although it could be declared as a 1 ong, f 1 oat, or doubl e. 
Note that byte might be the most appropriate for numberOfYears. For simplicity, however, 
the examples in this book will use i nt for integer and doubl e for floating-point values. 

The formula for computing the monthly payment is translated into Java code in lines 25-27. 

Casting is used in lines 31 and 33 to obtain a new monthl yPayment and total Payment 
with two digits after the decimal point. 

The program uses the Scanner class, imported in line 1 . The program also uses the Math class; 
j ava . 1 ang package why isn't it imported? The Math class is in the j ava . 1 ang package. All classes in the j ava . 1 ang 

package are implicitly imported. So, there is no need to explicitly import the Math class. 



2.13 Character Data Type and Operations 

char type The character data type, char, is used to represent a single character. A character literal is 

enclosed in single quotation marks. Consider the following code: 



char letter = 'A' ; 
char numChar = '4' ; 



2.13 Character Data Type and Operations 



The first statement assigns character A to the char variable letter. The second statement 
assigns digit character 4 to the char variable numChar. 

tf| Caution 

A string literal must be enclosed in quotation marks. A character literal is a single character char literal 

enclosed in single quotation marks. So "A" is a string, and 'A' is a character. 



2.13.1 Unicode and ASCII code 



Computers use binary numbers internally. A character is stored in a computer as a sequence of 
Os and Is. Mapping a character to its binary representation is called encoding. There are differ- 
ent ways to encode a character. How characters are encoded is defined by an encoding scheme. 

Java supports Unicode, an encoding scheme established by the Unicode Consortium to 
support the interchange, processing, and display of written texts in the world's diverse lan- 
guages. Unicode was originally designed as a 16-bit character encoding. The primitive data 
type char was intended to take advantage of this design by providing a simple data type that 
could hold any character. However, it turned out that the 65,536 characters possible in a 16- 
bit encoding are not sufficient to represent all the characters in the world. The Unicode stan- 
dard therefore has been extended to allow up to 1 , 112 , 064 characters. Those characters that 
go beyond the original 16-bit limit are called supplementary characters. Java supports sup- 
plementary characters. The processing and representing of supplementary characters are 
beyond the scope of this book. For simplicity, this book considers only the original 16-bit 
Unicode characters. These characters can be stored in a char type variable. 

A 16-bit Unicode takes two bytes, preceded by \u, expressed in four hexadecimal digits that 
run from 1 \u0000 ' to ' \uFFFF ' . For example, the word "welcome" is translated into Chinese 
using two characters, >0CiQl ■ The Unicodes of these two characters are "\u6B22\u8FCE". 

Listing 2.9 gives a program that displays two Chinese characters and three Greek letters. 



character encoding 



Unicode 



original Unicode 



supplementary Unicode 



Listing 2.9 DisplayUnicode. java 



1 import javax . swi ng . JOpti onPane ; 
2 
3 
4 
5 
6 
7 
8 
9 

10 } 



public class DisplayUnicode { 

public static void main(String[] args) 
JOpti onPane . showMessageDi al og(nulJ 

"\u6B22\u8FCE \u03bl \u03b2-\u03b3' 
"\u6B22\u8FCE Welcome 
lOpti onPane . INFORMATIONLMESSAGE) ; 

} 



I&& Welcome 


2£l 











If no Chinese font is installed on your system, you will not be able to see the Chinese char- 
acters. The Unicodes for the Greek letters a /3 y are \u03bl \u03b2 \u03b3. 

Most computers use ASCII (American Standard Code for Information Interchange), a 7-bit ASCII 
encoding scheme for representing all uppercase and lowercase letters, digits, punctuation 
marks, and control characters. Unicode includes ASCII code, with '\u0000' to '\u007F' 
corresponding to the 128 ASCII characters. (See Appendix B, "The ASCII Character Set," for 
a list of ASCII characters and their decimal and hexadecimal codes.) You can use ASCII char- 
acters such as ' X 1 , ' 1 ' , and ' $ 1 in a Java program as well as Unicodes. Thus, for example, 
the following statements are equivalent: 

char letter = 'A' ; 

char letter = '\u0041'; // Character A's Unicode is 0041 
Both statements assign character A to char variable 1 etter. 
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char increment and 
decrement 



backslash 



Note 

The increment and decrement operators can also be used on char variables to get the next or 
preceding Unicode character. For example, the following statements display character b. 

char ch = 'a' ; 

System. out. pri nt~l n(++ch) ; 

2. 1 3.2 Escape Sequences for Special Characters 

Suppose you want to print a message with quotation marks in the output. Can you write a 
statement like this? 

System. out. pri nt~l n("He said "Java is fun""); 

No, this statement has a syntax error. The compiler thinks the second quotation character is 
the end of the string and does not know what to do with the rest of characters. 

To overcome this problem, Java defines escape sequences to represent special characters, 
as shown in Table 2.6. An escape sequence begins with the backslash character (\) followed 
by a character that has a special meaning to the compiler. 

Table 2.6 Java Escape Sequences 



Character Escape Sequence 



Name 



Unicode Code 



\b 
\t 
\n 
\f 
\r 
\\ 
V 
V 



Backspace 
Tab 

Linefeed 
Formfeed 
Carriage Return 
Backslash 
Single Quote 
Double Quote 



\u0008 
\u0009 
\u000A 
\u000C 
\u000D 
\u005C 
\u0027 
\u0022 



So, now you can print the quoted message using the following statement: 
System. out. println("He said Y'Java is fun\""); 
The output is 

He said "Java is fun" 



2.13.3 Casting between char and Numeric Types 

A char can be cast into any numeric type, and vice versa. When an integer is cast into a 
char, only its lower 16 bits of data are used; the other part is ignored. For example: 

char ch = (char)0XAB0041 ; // the lower 16 bits hex code 0041 is 

// assigned to ch 
System. out. println(ch) ; // ch is character A 

When a floating-point value is cast into a char, the floating-point value is first cast into an 
int, which is then cast into a char. 

char ch = (char)65.25; // decimal 65 is assigned to ch 
System. out. println(ch) ; // ch is character A 
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When a char is cast into a numeric type, the character's Unicode is cast into the specified 
numeric type. 

int i = (int) 'A'; // the Unicode of character A is assigned to i 
System. out. println(i) ; // i is 65 

Implicit casting can be used if the result of a casting fits into the target variable. Otherwise, 
explicit casting must be used. For example, since the Unicode of ' a ' is 97, which is within 
the range of a byte, these implicit castings are fine: 

byte b = ' a ' ; 
int i = 'a' ; 

But the following casting is incorrect, because the Unicode \uFFF4 cannot fit into a byte: 

byte b = '\uFFF4' ; 
To force assignment, use explicit casting, as follows: 

byte b = (byte) '\uFFF4' ; 

Any positive integer between and FFFF in hexadecimal can be cast into a character implic- 
itly. Any number not in this range must be cast into a char explicitly. 

|p Note 

All numeric operators can be applied to char operands. A char operand is automatically cast numeric operators on 

into a number if the other operand is a number or a character. If the other operand is a string, the characters 
character is concatenated with the string. For example, the following statements 

int i = '2' + '3'; // (int)' 2' is 50 and (int)' 3' is 51 
System. out. println("i is " + i); // i is 101 

int j = 2 + 'a'; // (int)'a' is 97 
System . out . pri ntl n("j is " + j); // j is 99 
System. out. println(j + " is the Unicode for character " 
+ (char)j); 

System. out. pri ntl n ("Chapter " + '2'); 

display 

i is 101 
j is 99 

99 is the Unicode for character c 
Chapter 2 

|§| Note 

The Unicodes for lowercase letters are consecutive integers starting from the Unicode for 'a', 

then for 'b', 'c' and 'z'. The same is true for the uppercase letters. Furthermore, the 

Unicode for ' a ' is greater than the Unicode for ' A ' . So ' a ' - ' A 1 is the same as ' b ' - ' B ' . 
For a lowercase letter eh, its corresponding uppercase letter is (char) ('A' + (ch - 'a')). 

2.14 Problem: Counting Monetary Units 

Suppose you want to develop a program that classifies a given amount of money into smaller 
monetary units. The program lets the user enter an amount as a doubl e value representing a 
total in dollars and cents, and outputs a report listing the monetary equivalent in dollars, quar- 
ters, dimes, nickels, and pennies, as shown in the sample run. 

Your program should report the maximum number of dollars, then the maximum number 
of quarters, and so on, in this order. 
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import class 



enter input 



dollars 



quarters 



dimes 



nickels 



pennies 



prepare output 



Here are the steps in developing the program: 

1. Prompt the user to enter the amount as a decimal number, such as 11 . 56. 

2. Convert the amount (e.g., 11 . 56) into cents (1156). 

3. Divide the cents by 100 to find the number of dollars. Obtain the remaining cents using 
the cents remainder 100. 

4. Divide the remaining cents by 25 to find the number of quarters. Obtain the remaining 
cents using the remaining cents remainder 25. 

5. Divide the remaining cents by 10 to find the number of dimes. Obtain the remaining 
cents using the remaining cents remainder 10. 

6. Divide the remaining cents by 5 to find the number of nickels. Obtain the remaining 
cents using the remaining cents remainder 5. 

7. The remaining cents are the pennies. 

8. Display the result. 

The complete program is given in Listing 2. 10. 

Listing 2.10 ComputeChange. java 



i 

2 
3 
4 
5 
6 
7 
8 
9 
10 
11 
12 
13 
14 
15 
16 
17 
18 
19 
20 
21 
22 
23 
24 
25 
26 
27 
28 
29 
30 
31 
32 
33 
34 
35 



import java. util .Scanner; 

public class ComputeChange { 

public static void main(String[] args) { 

// Create a Scanner 

Scanner input = new Scanner(System.in) ; 

// Receive the amount 
System. out. print( 

"Enter an amount in double, for example 11.56: ") ; 
double amount = i nput . nextDoubl e() ; 

int remai ni ngAmount = (int)(amount * 100); 

// Find the number of one dollars 

int numberOfOneDol 1 ars = remai ni ngAmount / 100; 

remai ni ngAmount = remai ni ngAmount % 100; 

// Find the number of quarters in the remaining amount 
int numberOfQuarters = remai ni ngAmount / 25; 
remai ni ngAmount = remai ni ngAmount % 25; 

// Find the number of dimes in the remaining amount 
int numberOfDi mes = remai ni ngAmount / 10; 
remai ni ngAmount = remai ni ngAmount % 10; 

// Find the number of nickels in the remaining amount 
int numberOfNi ckel s = remai ni ngAmount / 5; 
remai ni ngAmount = remai ni ngAmount % 5; 

// Find the number of pennies in the remaining amount 
int numberOf Penni es = remai ni ngAmount ; 

// Display results 

System. out. pri ntl n("Your amount " + amount + " consists of \n" + 
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36 "\t" + numberOfOneDollars + " dollars\n" + 

37 "\t" + numberOfQuarters + " quarters\n" + 

38 "\t" + numberOf Dimes + " dimes\n" + 

39 "\t" + numberOfNickels + " nickel s\n" + 

40 "\t" + numberOfPennies + " pennies") ; 



41 } 

42 } 



Enter an amount in double, 


for example 11.56: 11.56 ^Enter 


Your amount 11.56 consists 


of 


11 dollars 




2 quarters 




dimes 




1 nickels 




1 pennies 





c9L 



Iine# 

variables ^^^^ 


1 1 


13 


16 


17 


20 


21 


24 


25 


28 


29 


32 


Amount 


1 1.56 






















remainingAmount 




1 156 




56 




6 




6 




1 




numberOfOneDollars 






1 1 


















numberOfQuarters 










2 














numberOfDimes 

























numberOfNickles 


















1 






numberOfPennies 






















1 



The variable amount stores the amount entered from the console (line 1 1). This variable is 
not changed, because the amount has to be used at the end of the program to display the 
results. The program introduces the variable remai ni ngAmount (line 13) to store the chang- 
ing remainingAmount. 

The variable amount is a doubl e decimal representing dollars and cents. It is converted to 
an int variable remainingAmount, which represents all the cents. For instance, if amount 
is 11. 56, then the initial remainingAmount is 1156. The division operator yields the inte- 
ger part of the division. So 1156 / 100 is 11. The remainder operator obtains the remainder 
of the division. So 1156 % 100 is 56. 

The program extracts the maximum number of singles from the total amount and obtains the 
remaining amount in the variable remainingAmount (lines 16-17). It then extracts the maxi- 
mum number of quarters from remainingAmount and obtains a new remainingAmount 
(lines 20-21). Continuing the same process, the program finds the maximum number of dimes, 
nickels, and pennies in the remaining amount. 

One serious problem with this example is the possible loss of precision when casting a loss of precision 
double amount to an int remainingAmount. This could lead to an inaccurate result. If you 
try to enter the amount 10 . 03, 10 . 03 * 100 becomes 1002 . 9999999999999. You will find 
that the program displays 10 dollars and 2 pennies. To fix the problem, enter the amount as an 
integer value representing cents (see Exercise 2.9). 
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As shown in the sample run, dimes, 1 nickels, and 1 pennies are displayed in the result. 
It would be better not to display dimes, and to display 1 nickel and 1 penny using the sin- 
gular forms of the words. You will learn how to use selection statements to modify this pro- 
gram in the next chapter (see Exercise 3.7). 

2.15 The String Type 

The char type represents only one character. To represent a string of characters, use the data 
type called Stri ng. For example, the following code declares the message to be a string with 
value "Welcome to Java". 

String message = "Welcome to Java"; 

String is actually a predefined class in the Java library just like the classes System, 
JOptionPane, and Scanner. The String type is not a primitive type. It is known as a 
reference type. Any Java class can be used as a reference type for a variable. Reference data 
types will be thoroughly discussed in Chapter 8, "Objects and Classes." For the time being, 
you need to know only how to declare a String variable, how to assign a string to the vari- 
able, and how to concatenate strings. 

As first shown in Listing 2.1, two strings can be concatenated. The plus sign (+) is the 
concatenation operator if one of the operands is a string. If one of the operands is a nonstring 
(e.g., a number), the nonstring value is converted into a string and concatenated with the other 
string. Here are some examples: 

// Three strings are concatenated 
String message = "Welcome " + "to " + "Java"; 

// String Chapter is concatenated with number 2 
String s = "Chapter" +2; // s becomes Chapter2 

// String Supplement is concatenated with character B 
String si = "Supplement" + 'B'; // si becomes SupplementB 

If neither of the operands is a string, the plus sign (+) is the addition operator that adds two 
numbers. 

The shorthand += operator can also be used for string concatenation. For example, the fol- 
lowing code appends the string "and Java is fun" with the string "Welcome to Java" in 
message. 

message += " and Java is fun"; 

So the new message is "Welcome to Java and Java is fun". 

Suppose that i = 1 and j = 2, what is the output of the following statement? 

System. out. println("i + j is " + i + j); 

The output is "i + j is 12" because "i + j is " is concatenated with the value of i first. To 
force i + j to be executed first, enclose i + j in the parentheses, as follows: 

System. out. println("i + j is " + ( i + j) ) ; 

reading strings To read a string from the console, invoke the next() method on a Scanner object. For 

example, the following code reads three strings from the keyboard: 

Scanner input = new Scanner(System.in) ; 
System. out. pri ntl n("Enter three strings: ") ; 
String si = input. nextQ; 



concatenating strings and 
numbers 
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String s2 = input. next() ; 
String s3 = input. next() ; 
System. out. println("sl is " + si); 
System. out. println("s2 is " + s2) ; 
System. out. println("s3 is " + s3) ; 



Enter a string: Welcome to Java |^ Enter 
si is Welcome 
s2 is to 
s3 is Java 



The next() method reads a string that ends with a whitespace character (i.e., ' ', '\t', 
'\f\ '\r',or '\n'). 

You can use the nextLineO method to read an entire line of text. The nextLineO 
method reads a string that ends with the Enter key pressed. For example, the following state- 
ments read a line of text. 

Scanner input = new Scanner(System.in) ; 
System. out. pri ntl n("Enter a string: ") ; 
String s = i nput . nextLi ne() ; 

System. out. println("The string entered is " + s) ; 



Enter a string: Welcome to lava |^ Enter ! 
The string entered is "Welcome to lava" 



|y| Important Caution 

To avoid input errors, do not use nextLineO after nextByteO, nextShortO, nextlnt(), avoiding input errors 

nextLongO, nextFloatO, nextDoubleO, and next(). The reasons will be explained in 
§9.7.3, "How Does Scanner Work?" 

2.1 6 Programming Style and Documentation 

Programming style deals with what programs look like. A program can compile and run prop- 
erly even if written on only one line, but writing it all on one line would be bad programming 
style because it would be hard to read. Documentation is the body of explanatory remarks and 
comments pertaining to a program. Programming style and documentation are as important as 
coding. Good programming style and appropriate documentation reduce the chance of errors 
and make programs easy to read. So far you have learned some good programming styles. 
This section summarizes them and gives several guidelines. More detailed guidelines can be 
found in Supplement I.D, "Java Coding Style Guidelines," on the Companion Website. 

2.16.1 Appropriate Comments and Comment Styles 

Include a summary at the beginning of the program to explain what the program does, its key 
features, and any unique techniques it uses. In a long program, you should also include com- 
ments that introduce each major step and explain anything that is difficult to read. It is 
important to make comments concise so that they do not crowd the program or make it diffi- 
cult to read. 

In addition to line comment // and block comment /*, Java supports comments of a spe- 
cial type, referred to as javadoc comments, javadoc comments begin with /** and end with javadoc comment 
*/. They can be extracted into an HTML file using JDK's javadoc command. For more 
information, see java.sun.com/j2se/javadoc. 





programming style 
documentation 
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Use javadoc comments (/** . . . */) for commenting on an entire class or an entire 
method. These comments must precede the class or the method header in order to be extracted 
in a javadoc HTML file. For commenting on steps inside a method, use line comments (//). 



naming variables and 
methods 
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naming constants 



2.16.2 Naming Conventions 

Make sure that you choose descriptive names with straightforward meanings for the variables, 
constants, classes, and methods in your program. Names are case sensitive. Listed below are 
the conventions for naming variables, methods, and classes. 

■ Use lowercase for variables and methods. If a name consists of several words, con- 
catenate them into one, making the first word lowercase and capitalizing the first let- 
ter of each subsequent word — for example, the variables radius and area and the 
method showInputDialog. 

■ Capitalize the first letter of each word in a class name — for example, the class names 
ComputeArea, Math, and DOptionPane. 

■ Capitalize every letter in a constant, and use underscores between words — for exam- 
ple, the constants PI and MAX_VALUE. 

It is important to follow the naming conventions to make programs easy to read. 



naming classes 



Caution 

Do not choose class names that are already used in the Java library. For example, since the Math 
class is defined in Java, you should not name your class Math. 



using full descriptive names 



Tip 

Avoid using abbreviations for identifiers. Using complete words is more descriptive. For example, 
numberOfStudents is better than numStuds, numOfStuds, or numOfStudents. 



2.16.3 Proper Indentation and Spacing 

A consistent indentation style makes programs clear and easy to read, debug, and maintain, 
indent code Indentation is used to illustrate the structural relationships between a program's components 

or statements. Java can read the program even if all of the statements are in a straight line, but 
humans find it easier to read and maintain code that is aligned properly. Indent each subcom- 
ponent or statement at least two spaces more than the construct within which it is nested. 

A single space should be added on both sides of a binary operator, as shown in the follow- 
ing statement: 



int i= 3+4 * 4; 



inti =3+4*4; 



Bad style 
Good style 



A single space line should be used to separate segments of the code to make the program 
easier to read. 

2.16.4 Block Styles 

A block is a group of statements surrounded by braces. There are two popular styles, next-line 
style and end-of-line style, as shown below. 
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public class Test 
{ 

public static void main(String[] args) 
{ 

System. out. println("Block Styles") ; 

} 

} 



Next-line style 



public class Test { 

public static void main(String[] args) { 
System. out . pri ntl n(" Block Styl es") ; 

} 

} 



End-of-line style 



The next-line style aligns braces vertically and makes programs easy to read, whereas the 
end-of-line style saves space and may help avoid some subtle programming errors. Both are 
acceptable block styles. The choice depends on personal or organizational preference. You 
should use a block style consistently. Mixing styles is not recommended. This book uses the 
end-of-line style to be consistent with the Java API source code. 



2.17 Programming Errors 

Programming errors are unavoidable, even for experienced programmers. Errors can be cate- 
gorized into three types: syntax errors, runtime errors, and logic errors. 



2.17.1 Syntax Errors 

Errors that occur during compilation are called syntax errors or compile errors. Syntax errors syntax errors 
result from errors in code construction, such as mistyping a keyword, omitting some necessary 
punctuation, or using an opening brace without a corresponding closing brace. These errors are 
usually easy to detect, because the compiler tells you where they are and what caused them. 
For example, the following program has a syntax error, as shown in Figure 2.3. 



Compile 



& 1 Command Prompt 



C:Sbook>jauac ShowSyntaxErrors . jaua 

R hn f jS y n t a vFi^n i\i . ja u a : 4 : n^nnnt: re sn 1 ue s^inhn 1 

s_ypibol : variable i 

]nn?tinn : nlass S li n uSy n f. a -x Frrn rs 

i = 38; 

ShouSyntaxErrors . jaua : 5 : cannot resolve 5_ymbol 
symbol : uariahle i 
location: class SJiowSyntaxErrors 
System . nut .print In K i + 4}; 

2 evrnrs 

Cl:\hnnJt> 

±J I 




Figure 2.3 The compiler reports syntax errors. 



1 // ShowSyntaxErrors . java: The program contains syntax errors 

2 public class ShowSyntaxErrors { 

3 public static void main(String[] args) { 

4 i = 30 ; syntax error 

5 System. out. println(i + 4); 

6 } 

7 } 

Two errors are detected. Both are the result of not declaring variable i . Since a single error 
will often display many lines of compile errors, it is a good practice to start debugging from 
the top line and work downward. Fixing errors that occur earlier in the program may also fix 
additional errors that occur later. 
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2.17.2 Runtime Errors 

runtime errors Runtime errors are errors that cause a program to terminate abnormally. They occur while a 

program is running if the environment detects an operation that is impossible to carry out. 
Input errors typically cause runtime errors. 

An input error occurs when the user enters an unexpected input value that the program 
cannot handle. For instance, if the program expects to read in a number, but instead the user 
enters a string, this causes data-type errors to occur in the program. To prevent input errors, 
the program should prompt the user to enter values of the correct type. It may display a mes- 
sage such as "Please enter an integer" before reading an integer from the keyboard. 

Another common source of runtime errors is division by zero. This happens when the divi- 
sor is zero for integer divisions. For instance, the following program would cause a runtime 
error, as shown in Figure 2.4. 





'-'■■I Command Prompt 






Z - Sbo o k > j a u a S ho uRun t ime Erro rs a| 
Exception in thread "main" jaua. Ian g - . Arithmetic Except ion : / by zero 

at ShowRun time Errors . mainCShauRunt imeErrors . jaua : 4) | 

C:Sbook> zl 

<i i -r 





Figure 2.4 The runtime error causes the program to terminate abnormally. 



1 // ShowRunti meErrors . java: Program contains runtime errors 

2 public class ShowRunti meErrors { 

3 public static void main(String[] args) { 
runtime error 4 int i = 1 / ; 

5 } 

6 } 



2.17.3 Logic Errors 

Logic errors occur when a program does not perform the way it was intended to. Errors of this 
kind occur for many different reasons. For example, suppose you wrote the following pro- 
gram to add numberl to number2. 

// ShowLogi cErrors . java: The program contains a logic error 
public class ShowLogi cErrors { 

public static void main(String[] args) { 

// Add numberl to number2 

int numberl = 3; 

int number2 = 3; 

number2 += numberl + number2; 

System . out . pri ntl n("number2 is " + number2); 

} 

} 

The program does not have syntax errors or runtime errors, but it does not print the correct 
result for number2. See if you can find the error. 

2.17.4 Debugging 

In general, syntax errors are easy to find and easy to correct, because the compiler gives indi- 
cations as to where the errors came from and why they are wrong. Runtime errors are not dif- 
ficult to find, either, since the reasons and locations of the errors are displayed on the console 
when the program aborts. Finding logic errors, on the other hand, can be very challenging. 
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Logic errors are called bugs. The process of finding and correcting errors is called 
debugging. A common approach is to use a combination of methods to narrow down to the 
part of the program where the bug is located. You can hand-trace the program (i.e., catch 
errors by reading the program), or you can insert print statements in order to show the values 
of the variables or the execution flow of the program. This approach might work for a short, 
simple program. But for a large, complex program, the most effective approach is to use a 
debugger utility. 

^|| Pedagogical NOTE 

An IDE not only helps debug errors but also is an effective pedagogical tool. Supplement II shows learning tool 

you how to use a debugger to trace programs and how debugging can help you to learn Java 

effectively. 

2.18 (GUI) Getting Input from Input Dialogs 

You can obtain input from the console. Alternatively, you may obtain input from an input dialog 

box by invoking the JOptionPane . showInputDial og method, as shown in Figure 2.5. JOptionPane class 



bugs 

debugging 
hand traces 



^^^^^^^^^^^^^^ String input = 
ES3B *J JOpti onPane. showInputDial og( 
|~7~| Eiita an«]piii ■ < "Enter an input"); 

Click OK to accept 1- ok 1 1 cancel- Click Cancel to dismiss the 

input and dismiss the I dialog without input 

dialog 

Figure 2.5 The input dialog box enables the user to enter a string. 



When this method is executed, a dialog is displayed to enable you to enter an input value. 
After entering a string, click OK to accept the input and dismiss the dialog box. The input is 
returned from the method as a string. 

There are several ways to use the showInputDial og method. For the time being, you need showInputDial og method 
to know only two ways to invoke it. 

One is to use a statement like this one: 

JOptionPane. showInputDia"log(x) ; 

where x is a string for the prompting message. 

The other is to use a statement such as the following: 

String string = JOpti onPane.showInputDialog (null , x, 
y, JOptionPane. QUESTION_MESSAGE) ; 

where x is a string for the prompting message and y is a string for the title of the input dialog 
box, as shown in the example below. 



Input Dialog Demo 




OK Cancel 



String input = 

JOpti on Pane . showInputDi al og (nul 1 , 

'Enter an input", 
'Input Dialog Demo", 
JOpti on Pane . QUESTION_MESSACE) ; 
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2.18.1 Converting Strings to Numbers 

The input returned from the input dialog box is a string. If you enter a numeric value such as 123, 
it returns " 123". You have to convert a string into a number to obtain the input as a number. 
Integer. parselnt method To convert a string into an int value, use the parselnt method in the Integer class, as 

follows: 

int intValue = Integer . parselnt(i ntStri ng) ; 

where intString is a numeric string such as "123". 
Double. parseDouble To convert a string into a double value, use the parseDouble method in the Double 

method class, as follows: 

double doubleValue = Double. parseDouble(doubleString) ; 

where doubleString is a numeric string such as "123 .45". 

The Integer and Doubl e classes are both included in the java . 1 ang package, and thus 
they are automatically imported. 

2.18.2 Using Input Dialog Boxes 

Listing 2.8, ComputeLoan.java, reads input from the console. Alternatively, you can use input 
dialog boxes. 

Listing 2.11 gives the complete program. Figure 2.6 shows a sample run of the program. 




I 9 I Enter number of years as an inleuer, 

Mji exdiTi|jlb 5; 



14 



OK Cancel 



(a) 



(b) 



Enter loan amount, for example 120000.95: 

|250000| | 



OK Cancel 



(c) 



{Message 


2£l 


(T} The mont 
" The total | 


i|y pay 
layme 


merit is 2076.03 
It is 373684.54 



(d) 



Figure 2.6 The program accepts the annual interest rate (a), number of years (b), and loan 
amount (c), then displays the monthly payment and total payment (d). 



Listing 2.1 1 ComputeLoanUsi nglnputDi al og . java 



enter interest rate 



convert string to double 



1 
2 
3 
4 
5 
6 
7 
8 
9 
10 
11 
12 



import javax. swi ng . JOpti onPane ; 

public class ComputeLoanllsinglnputDialog { 
public static void main(String[] args) { 

// Enter yearly interest rate 

String annual InterestRateStri ng = DOptionPane.showInputDialog( 
"Enter yearly interest rate, for example 8.25:"); 

// Convert string to double 
double annual InterestRate = 

Doubl e . par seDoubl e (annual InterestRateStri ng) ; 
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13 // Obtain monthly interest rate 

14 double monthl ylnterestRate = annual InterestRate / 1200; 
15 

16 // Enter number of years 

17 String numberOfYearsStri ng = 10ptionPane.showInputDialog( 

18 "Enter number of years as an integer, \nfor example 5:"); 
19 

20 // Convert string to int 

21 int numberOfYears = Integer . parseInt(numberOfYearsStri ng) ; 
22 

23 // Enter loan amount 

24 String loanString = 10ptionPane.showInputDialog( 
2 5 "Enter loan amount, for example 120000.95:"); 

26 

27 // Convert string to double 

28 double loanAmount = Double. parseDouble(loanString) ; 
29 

30 // Calculate payment 

31 double monthl yPayment = loanAmount * monthlylnterestRate / (1 monthl yPayment 

32 - 1 / Math.pow(l + monthlylnterestRate, numberOfYears * 12)); 

33 double total Payment = monthl yPayment * numberOfYears * 12; total Payment 

34 

35 // Format to keep two digits after the decimal point 

36 monthl yPayment = (int) (monthl yPayment * 100) / 100.0; preparing output 

37 total Payment = (int) (total Payment * 100) / 100.0; 

38 

39 // Display results 

40 String output = "The monthly payment is " + monthl yPayment + 

41 "\nThe total payment is " + total Payment ; 

42 JOptionPane.showMessageDialog(null , output); 

43 } 

44 } 

The showInputDialog method in lines 6-7 displays an input dialog. Enter the interest rate 
as a double value and click OK to accept the input. The value is returned as a string that is 
assigned to the String variable annual InterestRateString. The 
Double. parseDouble(annuallnterestRateString) (line 11) is used to convert the 
string into a doubl e value. If you entered an input other than a numeric value or clicked 
Cancel in the input dialog box, a runtime error would occur. In Chapter 13, "Exception Han- 
dling," you will learn how to handle the exception so that the program can continue to run. 

t§|l Pedagogical Note 

For obtaining input you can use DOptionPane or Scanner, whichever is convenient. For con- JOptionPane or Scanner? 

sistency most examples in this book use Scanner for getting input. You can easily revise the 
examples using JOptionPane for getting input. 
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algorithm 24 data type 25 

assignment operator (=) 30 debugger 55 

assignment statement 30 debugging 55 

backslash (\) 46 declaration 30 

byte type 27 decrement operator (--) 41 

casting 41 double type 33 

char type 44 encoding 45 

constant 31 final 31 
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f 1 oat type 35 
floating-point number 33 
expression 3 1 
identifier 29 

increment operator (++) 41 

incremental development and testing 26 

indentation 52 

inttype 34 

literal 35 

logic error 54 

1 ong type 35 

narrowing (of types) 41 

operator 33 



overflow 33 
pseudocode 30 
primitive data type 25 
runtime error 54 
short type 27 
syntax error 53 
supplementary Unicode 45 
underflow 33 
Unicode 45 
Unix epoch 43 
variable 24 
widening (of types) 41 
whitespace 5 1 
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1 . Identifiers are names for things in a program. 

2. An identifier is a sequence of characters that consists of letters, digits, underscores 
(_), and dollar signs ($). 

3. An identifier must start with a letter or an underscore. It cannot start with a digit. 

4. An identifier cannot be a reserved word. 

5 . An identifier can be of any length. 

6. Choosing descriptive identifiers can make programs easy to read. 

7. Variables are used to store data in a program 

8. To declare a variable is to tell the compiler what type of data a variable can hold. 

9. By convention, variable names are in lowercase. 

10. In Java, the equal sign (=) is used as the assignment operator. 

I I . A variable declared in a method must be assigned a value before it can be used. 

12. A named constant (or simply a constant) represents permanent data that never 
changes. 

13. A named constant is declared by using the keyword final . 
14- By convention, constants are named in uppercase. 

1 5 . Java provides four integer types (byte, short, i nt, 1 ong) that represent integers of 
four different sizes. 
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I 6. Java provides two floating-point types (f 1 oat, doubl e) that represent floating-point 
numbers of two different precisions. 

I 7. Java provides operators that perform numeric operations: + (addition), - (subtrac- 
tion), - (multiplication), / (division), and % (remainder). 

1 8. Integer arithmetic (/) yields an integer result. 

1 9. The numeric operators in a Java expression are applied the same way as in an arith- 

metic expression. 

20. Java provides shorthand operators += (addition assignment), -= (subtraction assign- 
ment), *= (multiplication assignment), /= (division assignment), and %= (remainder 
assignment). 

2 I . The increment operator (++) and the decrement operator ( — ) increment or decrement 

a variable by 1. 

22. When evaluating an expression with values of mixed types, Java automatically con- 
verts the operands to appropriate types. 

23. You can explicitly convert a value from one type to another using the (type)exp 
notation. 

24- Casting a variable of a type with a small range to a variable of a type with a larger 
range is known as widening a type. 

25. Casting a variable of a type with a large range to a variable of a type with a smaller 
range is known as narrowing a type. 

26. Widening a type can be performed automatically without explicit casting. Narrowing 
a type must be performed explicitly. 

27. Character type (char) represents a single character. 

28. The character \ is called the escape character. 

29. Java allows you to use escape sequences to represent special characters such as ' \t ' 
and '\n\ 

30. The characters 1 ', '\t', '\f , '\r',and '\n' are known as the whitespace char- 
acters. 

31. In computer science, midnight of January 1, 1970, is known as the Unix epoch. 

32. Programming errors can be categorized into three types: syntax errors, runtime 
errors, and logic errors. 

33. Errors that occur during compilation are called syntax errors or compile errors. 
34- Runtime errors are errors that cause a program to terminate abnormally. 

35. Logic errors occur when a program does not perform the way it was intended to. 
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Sections 2.2-2.7 

2.1 Which of the following identifiers are valid? Which are Java keywords? 

applet, Applet, a++, — a, 4#R, $4, #44, apps 
class, public, int, x, y, radius 

2.2 Translate the following algorithm into Java code: 

■ Step 1: Declare a doubl e variable named mil es with initial value 100; 

■ Step 2: Declare a doubl e constant named MILES_PER_KILOMETER with value 
1.609; 

■ Step 3: Declare a double variable named kilometers, multiply miles and 
MILES_PER_KILOMETER, and assign the result to kilometers. 

■ Step 4: Display kilometers to the console. 

What is kilometers after Step 4? 

2.3 What are the benefits of using constants? Declare an int constant SIZE with 
value 20. 

Sections 2.8-2.10 

2.4 Assume that i nt a = 1 and doubl e d = 1.0, and that each expression is indepen- 
dent. What are the results of the following expressions? 

a = 46 / 9; 

a=46%9+4*4-2; 

a = 45 + 43 % 5 * (23 * 3 % 2) ; 

a %= 3 / a + 3; 

d = 4 + d*d + 4; 

d += 1.5 * 3 + (++a); 

d -= 1.5 * 3 + a++; 

2.5 Show the result of the following remainders. 

56 % 6 
78 % -4 
-34 % 5 
-34 % -5 
5 % 1 
1 % 5 

2.6 If today is Tuesday, what will be the day in 100 days? 

2.7 Find the largest and smallest byte, short, int, long, float, and double. 

Which of these data types requires the least amount of memory? 

2.8 What is the result of 25 / 4? How would you rewrite the expression if you wished 
the result to be a floating-point number? 

2.9 Are the following statements correct? If so, show the output. 

System. out. println("25 / 4 is " + 25 / 4); 
System. out. println("25 / 4.0 is " + 25 / 4.0); 
System. out. println("3 *2/4 is "+3*2/4); 
System. out. pri ntl n("3 .0 "2/4 is " + 3.0 * 2 / 4) ; 

2.10 How would you write the following arithmetic expression in Java? 

4 3 + d(2 + a) 

— r - 9(a + be) + 

3(7 + 34) v ; a + bd 
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2.11 Suppose m and r are integers. Write a Java expression for mr 2 to obtain a floating- 
point result. 

2.12 Which of these statements are true? 

(a) Any expression can be used as a statement. 

(b) The expression x++ can be used as a statement. 

(c) The statement x = x + 5 is also an expression. 

(d) The statement x = y = x = Ois illegal. 

2.13 Which of the following are correct literals for floating-point numbers? 

12.3, 12.3e+2, 23.4e-2, -334.4, 20, 39F, 40D 

2.14 Identify and fix the errors in the following code: 

1 public class Test { 

2 public void main(string[] args) { 

3 int i; 

4 int k = 100.0; 

5 int j = i + 1; 
6 

7 System. out . pri ntl n("j is " + j + " and 

8 k is " + k); 

9 } 
10 } 

2.1 5 How do you obtain the current minute using the System. currentTimeMill is() 

method? 

Section 2.1 1 

2.16 Can different types of numeric values be used together in a computation? 

2.17 What does an explicit conversion from a doubl e to an i nt do with the fractional 
part of the double value? Does casting change the variable being cast? 

2.18 Show the following output. 

float f = 12. 5F; 
int i = (int)f; 

System. out. pri ntl n("f is " + f ) ; 

System. out. println("i is " + i); 

Section 2. 1 3 

2.19 Use print statements to find out the ASCII code for '1', 'A', 'B', 'a', 'b'.Use 
print statements to find out the character for the decimal code 40, 59, 79, 85, 90. Use 
print statements to find out the character for the hexadecimal code 40, 5A, 71, 72, 7A. 

2.20 Which of the following are correct literals for characters? 

'1', '\u345dE', '\ii3fFa', '\b' , \t 

2.2 I How do you display characters \ and "? 
2.22 Evaluate the following: 

int i = '1' ; 
int j = '1' + '2' ; 
int k = 'a' ; 
char c = 90; 
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2.23 Can the following conversions involving casting be allowed? If so, find the con- 
verted result. 

char c = 'A' ; 
i = (int)c; 
float f = 1000. 34f; 
int "i = (int)f; 

double d = 1000.34; 
int i = (int)d; 

int i = 97; 

char c = (char)i ; 

2.24 Show the output of the following program: 

public class Test { 

public static void man n(Stri ng [] args) { 
char x = 'a' ; 
char y = 'c' ; 

System. out . pri ntl n(++x) ; 
System. out . pri ntl n(y++) ; 
System. out . pri ntl n(x - y) ; 

} 

} 

Section 2. 1 5 

2 .25 Show the output of the following statements (write a program to verify your result): 

System. out. println("l" + 1); 

System . out . pri ntl n( ' 1 ' + 1); 

System . out . pri ntl n("l" + 1 + 1); 

System. out. println("l" + (1 + 1)); 

System . out . pri ntl n( ' 1 ' + 1 + 1); 

2.26 Evaluate the following expressions (write a program to verify your result): 

1 + "Welcome " + 1 + 1 

1 + "Welcome " + (1 + 1) 

1 + "Welcome " + ('\u0001' + 1) 

1 + "Welcome " + 'a' +1 

Sections 2.16-2.17 

2.27 What are the naming conventions for class names, method names, constants, and 
variables? Which of the following items can be a constant, a method, a variable, or 
a class according to the Java naming conventions? 

MAX VALUE, Test, read, readlnt 

2.28 Reformat the following program according to the programming style and docu- 
mentation guidelines. Use the next-line brace style. 

public class Test 
{ 

// Main method 

public static void mai n(Stri ng [] args) { 
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/** Print a line */ 

System. out. println("2 % 3 = "+2%3) ; 

} 

} 

2.29 Describe syntax errors, runtime errors, and logic errors. 
Section 2.18 

2.30 Why do you have to import JOptionPane but not the Math class? 

2.31 How do you prompt the user to enter an input using a dialog box? 

2.32 How do you convert a string to an integer? How do you convert a string to a double? 
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fP Note 

Students can run all exercises by downloading exercise8e.zip from sample runs 

www. cs .armstrong.edu/1 iang/intro8e/exerci se8e.zip and use the command 
java -cp exercise8e.zip Exercise Y_j to run Exerciseij. For example, to run Exer- 
cise2_l, use 

java -cp exercise8e.zip Exercise2_l 

This will give you an idea how the program runs. 

||| Debugging TIP 

The compiler usually gives a reason for a syntax error. If you don't know how to correct it, learn from examples 

compare your program closely, character by character, with similar examples in the text. 

Sections 2.2-2.9 

2.1 (Converting Celsius to Fahrenheit) Write a program that reads a Celsius degree in 
double from the console, then converts it to Fahrenheit and displays the result. The 
formula for the conversion is as follows: 

fahrenheit = (9 / 5) * Celsius + 32 

Hint: In Java, 9 / 5 is 1, but 9 . / 5 is 1 . 8. 
Here is a sample run: 



Enter a degree in 
43 Celsius is 109 



Celsius: 43 
4 Fahrenheit 



2.2 (Computing the volume of a cylinder) Write a program that reads in the radius and 
length of a cylinder and computes volume using the following formulas: 

area = radius * radius * n 
volume = area * length 

Here is a sample run: 
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Enter the radius and length of a cylinder: 5.5 12 
The area is 95.0331 
The volume is 1140.4 



2.3 (Converting feet into meters) Write a program that reads a number in feet, converts it 
to meters, and displays the result. One foot is . 305 meter. Here is a sample run: 



Enter a value for feet: 16 h Enter 
16 feet is 4.88 meters 



2.4 (Converting pounds into kilograms) Write a program that converts pounds into 
kilograms. The program prompts the user to enter a number in pounds, converts it 
to kilograms, and displays the result. One pound is 0.454 kilograms. Here is a 
sample run: 



Enter a number in pounds: 55.5 
55.5 pounds is 25.197 kilograms 



2.5* (Financial application: calculating tips) Write a program that reads the subtotal 
and the gratuity rate, then computes the gratuity and total. For example, if the user 
enters 10 for subtotal and 15% for gratuity rate, the program displays $1 . 5 as gra- 
tuity and $11.5 as total. Here is a sample run: 



Enter the subtotal and a gratuity rate: 15.69 15 
The gratuity is 2.35 and total is 18.04 



2.6** (Summing the digits in an integer) Write a program that reads an integer between 
and 1000 and adds all the digits in the integer. For example, if an integer is 932, 
the sum of all its digits is 14. 

Hint: Use the % operator to extract digits, and use the / operator to remove the 
extracted digit. For instance, 932 % 10 = 2 and 932 / 10 = 93. 

Here is a sample run: 



Enter a number between and 1000: 999 |^ E " ter 
The sum of the digits is 27 



2.7* (Finding the number of years) Write a program that prompts the user to enter the 
minutes (e.g., 1 billion) and displays the number of years and days for the minutes. 
For simplicity, assume a year has 365 days. Here is a sample run: 



Enter the number of minutes: 1000000000 ^ Enter 

1000000000 minutes is approximately 1902 years and 214 days. 
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Section 2.13 

2.8* (Finding the character of an ASCII code) Write a program that receives an ASCII 
code (an integer between and 128) and displays its character. For example, if the 
user enters 97, the program displays character a. Here is a sample run: 



Enter an ASCII code: 69 |^ E "»er 

The character for ASCII code 69 "is E 



2.9* (Financial application: monetary units) Rewrite Listing 2.10, Compute- 
Change.java, to fix the possible loss of accuracy when converting a doubl e value 
to an int value. Enter the input as an integer whose last two digits represent the 
cents. For example, the input 1156 represents 11 dollars and 56 cents. 

Section 2. 1 8 

2.10* (Using the GUI input) Rewrite Listing 2.10, ComputeChange.java, using the GUI 
input and output. 

Comprehensive 

2.1 I * (Financial application: payroll) Write a program that reads the following infor- 
mation and prints a payroll statement: 

Employee's name (e.g., Smith) 

Number of hours worked in a week (e.g., 10) 

Hourly pay rate (e.g., 6.75) 

Federal tax withholding rate (e.g., 20%) 

State tax withholding rate (e.g., 9%) 

Write this program in two versions: (a) Use dialog boxes to obtain input and dis- 
play output; (b) Use console input and output. A sample run of the console input 
and output is shown below: 



Enter employee's name: Smith |^ 

Enter number of hours worked in a week: 10 Renter 

Enter hourly pay rate: 6.75 |^ 

Enter federal tax withholding rate: 0.20 |^ enter 

Enter state tax withholding rate: 0.09 |^ 

Employee Name: Smith 

Hours Worked: 10.0 

Pay Rate: $6.75 

Gross Pay: $67.5 

Deductions : 

Federal Withholding (20.0%): $13.5 

State Withholding (9.0%): $6.07 

Total Deduction: $19.57 
Net Pay: $47.92 



2.12* (Financial application: calculating interest) If you know the balance and the 
annual percentage interest rate, you can compute the interest on the next monthly 
payment using the following formula: 





interest = balance X (annuallnterestRate / 1200) 



66 Chapter 2 Elementary Programming 

Write a program that reads the balance and the annual percentage interest rate and 
displays the interest for the next month in two versions: (a) Use dialog boxes to 
obtain input and display output; (b) Use console input and output. Here is a sam- 
ple run: 



Enter balance and interest rate (e.g., 3 for 3%) : 1000 3.5 enter 
The interest is 2.91667 



2.1 3* {Financial application: calculating the future investment value) Write a program 
that reads in investment amount, annual interest rate, and number of years, and 
displays the future investment value using the following formula: 

futurelnvestmentVal ue = 

investmentAmount x (1 + monthlyInterestRate) number0fYears 12 

For example, if you enter amount 1000, annual interest rate 3 . 2 5%, and number of 
years 1, the future investment value is 1032 . 98. 

Hint: Use the Math . pow(a , b) method to compute a raised to the power of b. 
Here is a sample run: 




Enter investment amount: 1000 I -" 5 "'" 
Enter monthly interest rate: 4.25 
Enter number of years: 1 Renter 
Accumulated value is 1043.34 



2.14* {Health application: computing BMI) Body Mass Index (BMI) is a measure of 
health on weight. It can be calculated by taking your weight in kilograms and 
dividing by the square of your height in meters. Write a program that prompts the 
Video Note user to enter a weight in pounds and height in inches and display the BMI. Note 

Compute BMI t ^ at one p 0un( ] j s 0.45359237 kilograms and one inch is 0.0254 meters. Here is 

a sample run: 



Enter weight in pounds: 95.5 

Enter height in inches: 50 
BMI is 26.8573 




2.15** {Financial application: compound value) Suppose you save $100 each month 
into a savings account with the annual interest rate 5%. So, the monthly interest 
rate is 0.05 / 12 = 0.00417. After the first month, the value in the account 
becomes 

100 * (1 + 0.00417) = 100.417 

After the second month, the value in the account becomes 



(100 + 100.417) * (1 + 0.00417) = 201.252 
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After the third month, the value in the account becomes 

(100 + 201.252) * (1 + 0.00417) = 302.507 

and so on. 

Write a program to display the account value after the sixth month. (In Exercise 
4.30, you will use a loop to simplify the code and display the account value for 
any month.) 

2.16 (Science: calculating energy) Write a program that calculates the energy needed 
to heat water from an initial temperature to a final temperature. Your program 
should prompt the user to enter the amount of water in kilograms and the initial 
and final temperatures of the water. The formula to compute the energy is 

Q = M * (final temperature - initial temperature) * 4184 

where M is the weight of water in kilograms, temperatures are in degrees Celsius, 
and energy Q is measured in joules. Here is a sample run: 







Enter the amount of water in kilograms: 


55.5 |^ Enter 


Enter the initial temperature: 3.5 pEnteT 




Enter the final temperature: 10.5 h 


The energy needed is 1.62548e+06 



2.17* (Science: wind-chill temperature) How cold is it outside? The temperature alone 
is not enough to provide the answer. Other factors including wind speed, relative 
humidity, and sunshine play important roles in determining coldness outside. In 
2001, the National Weather Service (NWS) implemented the new wind-chill 
temperature to measure the coldness using temperature and wind speed. The for- 
mula is given as follows: 

t wc = 35.74 + 0.6215r„ - 35.75?; 016 + 0A275t a v 016 

where t a is the outside temperature measured in degrees Fahrenheit and v is the speed 
measured in miles per hour. t wc is the wind-chill temperature. The formula cannot be 
used for wind speeds below 2 mph or temperatures below — 58°F or above 41°F. 

Write a program that prompts the user to enter a temperature between — 58°F and 
41°F and a wind speed greater than or equal to 2 and displays the wind-chill 
temperature. Use Math . pow(a , b) to compute v 0M . Here is a sample run: 



Enter the temperature in Fahrenheit: 5. 

Enter the wind speed miles per hour: 6 p enter 
The wind chill index is -5.56707 




2.18 (Printing a table) Write a program that displays the following table: 



a 


b 


pow(a, b) 


1 


2 


1 


2 


3 


8 


3 


4 


81 


4 


5 


1024 


5 


6 


15625 
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2.19 (Random character) Write a program that displays a random uppercase letter 
using the System. CurrentTimeMill is() method. 

2.20 (Geometry: distance of two points) Write a program that prompts the user to enter 
two points (xl , yl) and (x2 , y2) and displays their distances. The formula for 

computing the distance is \f{x 2 — *i) 2 + (y 2 ~ Ji) 2 '■ Note you can use the 

Math . pow(a , . 5) to compute Va . Here is a sample run: 



Enter xl and 


yi 


1.5 "3.4 |- Enter 


Enter x2 and 


y2 


4 5 |* Enter 


The distance 


of 


the two points is 8.764131445842194 



2.21* (Geometry: area of a triangle) Write a program that prompts the user to enter 
three points (xl , yl), (x2 , y2), (x3, y3) of a triangle and displays its area. The 
formula for computing the area of a triangle is 

s = (sidel + side! + side3) /2; 
area = \A(s — side\)(s — side2)(s — side3) 
Here is a sample run. 



Enter three points for a triangle: 1-5 -3.4 4.6 5 9.5 -3.4 
The area of the triangle is 33.6 



2.22 (Geometry: area of a hexagon) Write a program that prompts the user to enter the 
side of a hexagon and displays its area. The formula for computing the area of a 
hexagon is 

Area = s 2 , 

2 

where s is the length of a side. Here is a sample run: 



Enter the side: 5.5 h Enter I 

The area of the hexagon is 78.5895 



2.23 (Physics: acceleration) Average acceleration is defined as the change of velocity 
divided by the time taken to make the change, as shown in the following formula: 

a = 

t 

Write a program that prompts the user to enter the starting velocity Vq in 
meters/second, the ending velocity V[ in meters/second, and the time span t in sec- 
onds, and displays the average acceleration. Here is a sample run: 
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Enter vO, vl, and t: 5.5 50.9 4.5 H-ner 
The average acceleration is 10.0889 



2.24 (Physics: finding runway length) Given an airplane's acceleration a and take-off 
speed v, you can compute the minimum runway length needed for an airplane to 
take off using the following formula: 

v 2 

length = — 
2a 

Write a program that prompts the user to enter v in meters/second (m/s) and the 
acceleration a in meters/second squared (m/s 2 ), and displays the minimum run- 
way length. Here is a sample run: 



Enter v and a: 60 3.5 Renter 

The minimum runway length for this airplane is 514.286 



2.25* (Current time) Listing 2.6, ShowCurrentTime.java, gives a program that displays 
the current time in GMT. Revise the program so that it prompts the user to enter 
the time zone offset to GMT and displays the time in the specified time zone. Here 
is a sample run: 



Enter the time zone offset to GMT: 
The current time is 4:50:34 
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Selections 

Objectives 

■ To declare bool ean type and write Boolean expressions using comparison operators (§3.2). 

■ To program Addi tionQui z using Boolean expressions (§3.3). 

■ To implement selection control using one-way i f 
statements (§3.4) 

■ To program the GuessBi rthday game using one-way 

if statements (§3.5). 

■ To implement selection control using two-way i f 
statements (§3.6). 

■ To implement selection control using nested i f 
statements (§3.7). 

■ To avoid common errors in i f statements (§3.8). 

■ To program using selection statements for a variety of 
examples(SubtractionQuiz, BMI, ComputeTax) (§3.9-3.11). 

■ To generate random numbers using the Math . random () 

method (§3.9). 

■ To combine conditions using logical operators (&&, | | , 
and !) (§3.12). 

■ To program using selection statements with combined 
conditions (LeapYear, Lottery) (§§3.13-3.14). 

■ To implement selection control using switch 
statements (§3.15). 

■ To write expressions using the conditional operator (§3.16). 

■ To format output using the System. out .printf 

method and to format strings using the Str i ng . format 
method (§3.17). 

■ To examine the rules governing operator precedence and 
associativity (§3.18). 

■ (GUI) To get user confirmation using confirmation 
dialogs (§3.19). 
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3.1 Introduction 

If you enter a negative value for radius in Listing 2.2, ComputeAreaWithConsolelnput.java, 
the program prints an invalid result. If the radius is negative, you don't want the program to 
problem compute the area. How can you deal with this situation? 

Like all high-level programming languages, Java provides selection statements that let you 
choose actions with two or more alternative courses. You can use the following selection 
statement to replace lines 12-17 in Listing 2.2: 

if (radius < 0) 

System. out. pri ntl n ("Incorrect input") ; 
else { 

area = radius * radius * 3.14159; 
System. out. pri ntl n("Area is " + area); 

} 

Selection statements use conditions. Conditions are Boolean expressions. This chapter first 
introduces Boolean types, values, comparison operators, and expressions. 

3.2 boolean Data Type 

How do you compare two values, such as whether a radius is greater than 0, equal to 0, or less 
comparison operators than 0? Java provides six comparison operators (also known as relational operators), shown 

in Table 3.1, which can be used to compare two values (assume radius is 5 in the table). 



Table 3.1 Comparison Operators 



Operator 


Name 


Example 




Result 


< 


less than 


radius 


< 


false 


<= 


less than or equal to 


radius 


<= 


false 


> 


greater than 


radius 


> 


true 


>= 


greater than or equal to 


radius 


>= 


true 




equal to 


radius 


== 


false 


\ = 


not equal to 


radius 


!= 


true 



Note 

compare characters You can also compare characters. Comparing characters is the same as comparing their Unicodes. 

For example, 'a' is larger than 'A' because the Unicode of 'a' is larger than the Unicode of 
' A' . See Appendix B, "The ASCII Character Sets," to find the order of characters. 

f|| Caution 

= = vs. = The equality comparison operator is two equal signs (==), not a single equal sign (=). The latter 

symbol is for assignment. 

The result of the comparison is a Boolean value: true or fal se. For example, the following 
statement displays true: 

double radius = 1; 

System. out. pri ntl n(radi us > 0); 



Boolean variable 



A variable that holds a Boolean value is known as a Boolean variable. The bool ean data type 
is used to declare Boolean variables. A bool ean variable can hold one of the two values: 
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true and fal se. For example, the following statement assigns true to the variable 
lightsOn: 

boolean lightsOn = true; 

true and fal se are literals, just like a number such as 10. They are reserved words and can- Boolean literals 
not be used as identifiers in your program. 



3.3 Problem: A Simple Math Learning Tool 

Suppose you want to develop a program to let a first-grader practice addition. The program 
randomly generates two single-digit integers, number 1 and number2, and displays to the stu- 
dent a question such as "What is 7 + 9?", as shown in the sample run. After the student types 
the answer, the program displays a message to indicate whether it is true or false. 

There are several ways to generate random numbers. For now, generate the first integer using 
System. currentTimeMillis() % 10 and the second using System. currentTimeMill is() 
* 7 % 10. Listing 3.1 gives the program. Lines 5-6 generate two numbers, numberl and 
number2. Line 14 obtains an answer from the user. The answer is graded in line 18 using a 
Boolean expression numberl + number2 == answer. 



Video Note 

Program addition quiz 



Listing 3.1 Addi tionQuiz. java 



1 import java. util .Scanner; 

2 

3 public class AdditionQuiz { 

4 public static void main(String[] args) { 
int numberl = (int) (System. currentTi meMi 1 1 i s() % 10); 
int number2 = (int) (System. currentTi meMi 1 1 i s() * 7 % 10) ; 



5 

6 

7 

8 

9 
10 
11 
12 
13 
14 
15 
16 
17 
18 
19 

20 } 



// Create a Scanner 

Scanner input = new Scanner(System.in) ; 

System . out . pri nt( 

"What is " + numberl + " + " + number2 + "? ") ; 

int answer = i nput . nextlnt() ; 

System . out . pri ntl n ( 

numberl + " + " + number2 + " = " + answer + " is 
(numberl + number2 == answer)); 



generate numberl 
generate number2 



show question 



display result 



What is 1 + 7? 8 
1 + 7 = 8 is true 



What is 4 + 8? 9 
4 + 8 = 9 is false 



line# 


numberl 


number2 


answer 


output 


5 


4 








6 




8 






14 






9 




16 








4 + 8 = 9 is false 



Ox 
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3.4 if Statements 

The preceding program displays a message such as "6 + 2 = 7 is false." If you wish the message 
why i f statement? to be "6 + 2 = 7 is incorrect," you have to use a selection statement to carry out this minor change. 

This section introduces selection statements. Java has several types of selection statements: 
one-way if statements, two-way if statements, nested if statements, switch statements, 
and conditional expressions. 

3.4-1 One-Way if Statements 

A one-way if statement executes an action if and only if the condition is true. The syntax 
for a one-way i f statement is shown below: 

ifstatement -jf (bool ean-expressi on) { 

statement(s) ; 

} 

The execution flow chart is shown in Figure 3.1(a). 



f 



boolean- 
expression 



false 




(radius >= 0) 



false 



true 



area = radius * radius * PI; 

System. out. pri ntl n("The area for the circle of" + 
"radius" + radius + "is" + area); 



T 



(a) (b) 
Figure 3.1 An i f statement executes statements if the bool ean-expression evaluates to true. 



If the bool ean-expression evaluates to true, the statements in the block are executed. 
As an example, see the following code: 

if (radius >= 0) { 

area = radius * radius * PI; 

System. out. pri ntl n("The area for the circle of radius " + 
radius + " is " + area); 

} 

The flow chart of the preceding statement is shown in Figure 3.1(b). If the value of radius 
is greater than or equal to 0, then the area is computed and the result is displayed; otherwise, 
the two statements in the block will not be executed. 

The boolean-expression is enclosed in parentheses. For example, the code in (a) 
below is wrong. It should be corrected, as shown in (b). 



if i > { 

System. out. println("i is positive"); 

} 



if (i > 0) { 

System. out. println("i is positive"); 

} 



(a) Wrong 



(b) Correct 
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The block braces can be omitted if they enclose a single statement. For example, the follow- 
ing statements are equivalent. 



if (i > 0) { 

System . out . pri ntl n("i is positive"); 

} 



Equivalent 



if (i > 0) 

System. out. pri ntl n("i is positive"); 



(a) 



(b) 



Listing 3.2 gives a program that prompts the user to enter an integer. If the number is a multi- 
ple of 5, print Hi Five. If the number is divisible by 2, print Hi Even. 

Listing 3.2 Si mpl elf Demo, java 

1 import java. util .Scanner; 

2 

3 public class Si mpl elf Demo { 

4 public static void main(String[] args) { 
Scanner input = new Scanner(System.in) ; 
System. out. pri ntl n("Enter an integer: ") ; 
int number = i nput . nextlntQ ; 



5 

6 

7 

8 

9 
10 
11 
12 
13 
14 

15 } 



if (number % 5 == 0) 

System. out .pri ntl n ("Hi Five") ; 

if (number % 2 == 0) 

System. out . pri ntl n ("Hi Even") ; 



enter input 
check 5 

check even 



Enter an integer: 4 )^ enter 
Hi Even 



Enter an integer: 30 JEnter 
Hi Five 
Hi Even 



The program prompts the user to enter an integer (line 7) and displays Hi Five if it is divisi- 
ble by 5 (lines 9-10) and Hi Even if it is divisible by 2 (lines 12-13). 

3.5 Problem: Guessing Birthdays 

You can find out the date of the month when your friend was born by asking five questions. 
Each question asks whether the day is in one of the five sets of numbers. 



r 



: 19 



3 5 7 

9 11 13 15 

17 19 21 23 

25 27 29 31 

Setl 



|~2~1 3 6 7 

10 11 14 15 

18 19 22 23 

26 27 30 31 

Set2 



4 5 6 7 

12 13 14 15 

20 21 22 23 

28 29 30 31 

Set3 



8 9 10 11 

12 13 14 15 

24 25 26 27 

28 29 30 31 

Set4 



[l6| 17 18 19 

20 21 22 23 

24 25 26 27 

28 29 30 31 

Set5 
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The birthday is the sum of the first numbers in the sets where the day appears. For exam- 
ple, if the birthday is 19, it appears in Setl, Set2, and Set5. The first numbers in these three 
sets are 1, 2, and 16. Their sum is 19. 

Listing 3.3 gives a program that prompts the user to answer whether the day is in Setl 
(lines 41^7), in Set2 (lines 50-56), in Set3 (lines 59-65), in Set4 (lines 68-74), and in Set5 
(lines 77-83). If the number is in the set, the program adds the first number in the set to day 
(lines 47, 56, 65, 74, 83). 



Listing 3.3 GuessBi rthday . java 

1 import java. util .Scanner; 
2 

3 public class GuessBi rthday { 

4 public static void main(String[] args) { 

5 String setl = 

6 "13 5 7\n" + 

7 " 9 11 13 15\n" + 

8 "17 19 21 23\n" + 

9 "25 27 29 31"; 
10 

11 String set2 = 

12 "236 7\n" + 

13 "10 11 14 15\n" + 

14 "18 19 22 23\n" + 

15 "26 27 30 31"; 
16 

17 String set3 = 

18 "456 7\n" + 

19 "12 13 14 15\n" + 

20 "20 21 22 23\n" + 

21 "28 29 30 31"; 
22 

23 String set4 = 

24 "89 10 ll\n" + 

25 "12 13 14 15\n" + 

26 "24 25 26 27\n" + 

27 "28 29 30 31"; 
28 

29 String set5 = 

30 "16 17 18 19\n" + 

31 "20 21 22 23\n" + 

32 "24 25 26 27\n" + 

33 "28 29 30 31"; 



34 

day to be determined 35 intday = 0; 



36 

37 // Create a Scanner 

38 Scanner input = new Scanner(System . i n) ; 
39 

40 // Prompt the user to answer questions 

41 System . out . pri nt("Is your birthday in Setl?\n") ; 

42 System . out . pri nt(setl) ; 

43 System . out . pri nt("\nEnter for No and 1 for Yes: ") ; 

44 int answer = i nput . nextlntQ ; 



45 

in Setl? 46 if (answer == 1) 

47 day += 1; 

48 
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49 // Prompt the user to answer questions 

50 System . out . pri nt("\nls your birthday in Set2?\n" ); 

51 System . out . pri nt(set2) ; 

52 System . out . pri nt("\nEnter for No and 1 for Yes: ") ; 

53 answer = input. nextlntO ; 
54 

55 if (answer == 1) inSet2? 

56 day += 2; 
57 

58 // Prompt the user to answer questions 

59 System . out . pri nt("Is your birthday in Set3?\n") ; 

60 System . out . pri nt(set3) ; 

61 System . out . pri nt("\nEnter for No and 1 for Yes: ") ; 

62 answer = input. nextlntO ; 
63 

64 if (answer == 1) inSet3? 

65 day += 4; 
66 

67 // Prompt the user to answer questions 

68 System . out . pri nt("\nls your birthday in Set4?\n") ; 

69 System . out . pri nt(set4) ; 

70 System . out . pri nt("\nEnter for No and 1 for Yes: ") ; 

71 answer = input. nextlntO ; 
72 

73 if (answer == 1) in Set4? 

74 day += 8; 
75 

76 // Prompt the user to answer questions 

77 System . out . pri nt("\nls your birthday in Set5?\n") ; 

78 System . out . pri nt(set5) ; 

79 System . out . pri nt("\nEnter for No and 1 for Yes: ") ; 

80 answer = input. nextlntO ; 
81 

82 if (answer == 1) inSet5? 

83 day += 16; 
84 

85 System. out. pri ntl n("\nYour birthday is " + day + "!"); 

86 } 

87 } 



Is your birthday in Setl? 
13 5 7 
9 11 13 15 

17 19 21 23 

25 27 29 31 

Enter for No and 1 for Yes: 1 |^ Enter 

Is your birthday in Set2? 

2 3 6 7 

10 11 14 15 

18 19 22 23 

26 27 30 31 

Enter for No and 1 for Yes: 1 |^ 

Is your birthday in Set3? 

4 5 6 7 
12 13 14 15 
20 21 22 23 
28 29 30 31 

Enter for No and 1 for Yes: 1^ Enter 
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Is your birthday in Set4? 




8 9 10 11 




12 13 14 15 




24 25 26 27 




28 29 30 31 




Enter for No and 1 for Yes: 


^ Enter 


Is your birthday in Set5? 




16 17 18 19 




20 21 22 23 




24 25 26 27 




28 29 30 31 




Enter for No and 1 for Yes: 


1 1^ Enter 


Your birthday is 19 





line# 


day 


answer 


output 


35 









44 




1 




47 


1 






53 




1 




56 


3 






62 









71 









80 




1 




83 


19 




Your birthday is 1 9 



mathematics behind the game 



The game is easy to program. You may wonder how the game was created. The mathematics 
behind the game is actually quite simple. The numbers are not grouped together by accident. 
The way they are placed in the five sets is deliberate. The starting numbers in the five sets are 1, 
2, 4, 8, and 16, which correspond to 1, 10, 100, 1000, and 10000 in binary. A binary number 
for decimal integers between 1 and 31 has at most five digits, as shown in Figure 3.2(a). Let it 
be b^b A b^b 2 b x ■ So, b 5 b A b^b 2 bx = b 5 0000 + b 4 000 + b 3 00 + b 2 + b x , as shown in 
Figure 3.2(b). If a day's binary number has a digit 1 in , the number should appear in Set/c. For 
example, number 19 is binary 10011, so it appears in Setl, Set2, and Set5. It is binary 1 + 10 + 
10000 = 10011 or decimal 1 + 2 + 16 = 19. Number 31 is binary 11111, so it appears in Setl, 
Set2, Set3, Set4, and Set5. It is binary 1 + 10 + 100 + 1000 + 10000 = 11111 or decimal 1 + 2 
+ 4 + 8+16 = 31. 



Decimal 


Binary 


1 


00001 


2 


00010 


3 


00011 


19 


10011 


31 


11111 



(a) 



b 5 
b 4 
h 
b 2 

- h 

£> 5 £> 4 63 b 2 by 





10000 




1000 


10000 


100 


10 


10 


1 


+ 1 


10011 


11111 



19 



(b) 



31 



Figure 3.2 (a) A number between 1 and 31 can be represented using a 5-digit binary 
number, (b) A 5-digit binary number can be obtained by adding binary numbers 1, 10, 
100, 1000, or 10000. 



3.6 Two-Way i f Statements 



3.6 Two-Way i f Statements 

A one-way i f statement takes an action if the specified condition is true. If the condition is 
f al se, nothing is done. But what if you want to take alternative actions when the condition is 
f al se? You can use a two-way i f statement. The actions that a two-way i f statement spec- 
ifies differ based on whether the condition is true or fal se. 
Here is the syntax for a two-way i f statement: 

if (boolean-expression) { 

statement(s)-for-the-true-case ; 

} 

else { 

statement (s) -for-the-fal se-case ; 

} 

The flow chart of the statement is shown in Figure 3.3. 



true boolean- false 




Statement(s) for the true case I Statement(s) for the false case 



Figure 3.3 An i f . . . el se statement executes statements for the true case if the 
boolean-expression evaluates to true; otherwise, statements for the false case are 
executed. 



If the bool ean-expression evaluates to true, the statement(s) for the true case are exe- 
cuted; otherwise, the statement(s) for the false case are executed. For example, consider the 
following code: 

if (radius >= 0) { two-way i f statement 

area = radius * radius * PI; 

System. out. println("The area for the circle of radius " + 
radius + " is " + area); 

} 

else { 

System. out. pri ntl n("Negative input") ; 

} 

If radius >= is true, area is computed and displayed; if it is false, the message 
"Negative input" is printed. 

As usual, the braces can be omitted if there is only one statement within them. The braces 
enclosing the System. out. println("Negative input") statement can therefore be 
omitted in the preceding example. 
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Here is another example of using the if ... el se statement. The example checks 
whether a number is even or odd, as follows: 

if (number % 2 == 0) 

System. out. pri ntl n(number + " is even."); 
el se 

System. out. pri ntl n(number + " is odd."); 



3.7 Nested i f Statements 

The statement in an i f or i f . . . el se statement can be any legal Java statement, including 
another i f or i f . . . el se statement. The inner i f statement is said to be nested inside the 
outer i f statement. The inner i f statement can contain another i f statement; in fact, there is 
no limit to the depth of the nesting. For example, the following is a nested i f statement: 

if (i > k) { 

nested i f statement if (j > k) 

System . out . pri ntl n("i and j are greater than k") ; 

} 

el se 

System. out. println("i is less than or equal to k") ; 

The i f C j > k) statement is nested inside the i f (i > k) statement. 

The nested i f statement can be used to implement multiple alternatives. The statement 
given in Figure 3.4(a), for instance, assigns a letter grade to the variable grade according to 
the score, with multiple alternatives. 



if (score >= 90.0) 

grade = 'A' ; 
el se 

if (score >= 80.0) 

grade = ' B ' ; 
el se 

if (score >= 70.0) 

grade = 'C ; 
el se 

if (score >= 60.0) 
grade = 'D' ; 

el se 

grade = ' F' ; 



Equivalent 



This is better 



if (score >= 90.0) 






grade = 'A' ; 






else if (score >= 


80 


0) 


grade = ' B ' ; 






else if (score >= 


70 


0) 


grade = 'C ; 






else if (score >= 


60 


0) 


grade = 'D' ; 






el se 






grade = ' F' ; 







(a) 



(b) 



Figure 3.4 A preferred format for multiple alternative i f statements is shown in (b). 



The execution of this if statement proceeds as follows. The first condition (score >= 
90.0) is tested. If it is true, the grade becomes 'A'. If it is false, the second condition 
(score >= 80 . 0) is tested. If the second condition is true, the grade becomes ' B ' . If that 
condition is f al se, the third condition and the rest of the conditions (if necessary) continue 
to be tested until a condition is met or all of the conditions prove to be f al se. If all of the 
conditions are f al se, the grade becomes ' F ' . Note that a condition is tested only when all of 
the conditions that come before it are fal se. 

The i f statement in Figure 3.4(a) is equivalent to the i f statement in Figure 3.4(b). In fact, 
Figure 3.4(b) is the preferred writing style for multiple alternative if statements. This style 
avoids deep indentation and makes the program easy to read. 
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fl Tip 

Often, to assign a test condition to a boolean variable, new programmers write code as in (a) assign boolean variable 

below: 



if (number % 2 == 0) 

even = true; 
el se 

even = false; 



Equivalent 



This is shorter - 



boolean even 

= number % 2 == 0; 



(a) (b) 
The code can be simplified by assigning the test value directly to the variable, as shown in (b). 



3.8 Common Errors in Selection Statements 

The following errors are common among new programmers. 
Common Error 1: Forgetting Necessary Braces 

The braces can be omitted if the block contains a single statement. However, forgetting the 
braces when they are needed for grouping multiple statements is a common programming 
error. If you modify the code by adding new statements in an i f statement without braces, 
you will have to insert the braces. For example, the code in (a) below is wrong. It should be 
written with braces to group multiple statements, as shown in (b). 



if (radius >= 0) if (radius >= 0) { 

area = radius * radius * PI; area = rad -j us * ra dius * PI; 

System. out. pnntln("The area " System. out. println ("The area 

+ " is " + area); + is - + area ) ; 

} 

(a) Wrong (b) Correct 

Common Error 2: Wrong Semicolon at the i f Line 

Adding a semicolon at the i f line, as shown in (a) below, is a common mistake. 



Logic Error 



/Empty Block 



if (radius >= 0) 



{ 



area = radius * radius * PI; 
System. out. println("The area 
+ " i s " + area) ; 



Equivalent 



if (radius >= 0) { }; 
{ 

area = radius * radius * PI; 
System. out. pri ntl n("The area 
+ " i s " + area) ; 

} 



(a) 



(b) 



This mistake is hard to find, because it is neither a compilation error nor a runtime error; it 
is a logic error. The code in (a) is equivalent to that in (b) with an empty block. 

This error often occurs when you use the next-line block style. Using the end-of-line block 
style can help prevent the error. 

Common Error 3: Redundant Testing of Boolean Values 

To test whether a bool ean variable is true or f al se in a test condition, it is redundant to 
use the equality comparison operator like the code in (a): 



if (even == true) 
System . out .pri ntl n ( 

"It i s even . ") ; 



(a) 



Equivalent 



This is better 



if (even) 

System . out . pri ntl n ( 

"It i s even . ") ; 



(b) 
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Instead, it is better to test the bool ean variable directly, as shown in (b). Another good 
reason for doing this is to avoid errors that are difficult to detect. Using the = operator instead 
of the == operator to compare equality of two items in a test condition is a common error. It 
could lead to the following erroneous statement: 

if (even = true) 

System. out. println("It is even."); 

This statement does not have syntax errors. It assigns true to even, so that even is always true. 
Common Error 4: Dangling el se Ambiguity 

The code in (a) below has two i f clauses and one el se clause. Which i f clause is matched 
by the el se clause? The indentation indicates that the el se clause matches the first i f clause. 
However, the el se clause actually matches the second i f clause. This situation is known as 
the dangling-else ambiguity. The el se clause always matches the most recent unmatched i f 
clause in the same block. So, the statement in (a) is equivalent to the code in (b). 



int i = 1; 




int j = 2; 




int k = 3; 




if (i > j) 




if (i > k) 




System. out 


pri ntl n("A") ; 


el se 




System. out 


println("B") ; 



Equivalent 



This is better 
with correct - 
indentation 



int i = 1; 




int j = 2; 




int k = 3; 




if (i > j) 




if (i > k) 


pri ntl n("A") ; 


*" System. out 


el se 




System. out 


pri ntl n("B") ; 



(a) 



(b) 



Since (i > j) is false, nothing is printed from the statement in (a) and (b). To force the 
el se clause to match the first i f clause, you must add a pair of braces: 

int i=l, j=2,k=3; 

if (i > j) { 
if (i > k) 

System. out. pri ntl n("A") ; 

} 

else 

System. out. println("B") ; 



This statement prints B. 



Video Note 

Program subtraction quiz 

random () method 



3.9 Problem: An Improved Math Learning Tool 

Suppose you want to develop a program for a first-grader to practice subtraction. The program 
randomly generates two single-digit integers, numberl and number2, with numberl > = 
number2 and displays to the student a question such as "What is 9 — 2?" After the student 
enters the answer, the program displays a message indicating whether it is correct. 

The previous programs generate random numbers using System. currentTimeMil 1 is(). 
A better approach is to use the random () method in the Math class. Invoking this method 
returns a random double value d such that 0.0 £ i < 1.0. So, (int) (Math . random () * 
10) returns a random single-digit integer (i.e., a number between and 9). 

The program may work as follows: 

■ Generate two single-digit integers into numberl and number2. 



If numberl < number2, swap numberl with number2. 



3.9 Problem: An Improved Math Learning Tool 



■ Prompt the student to answer "What is numberl - number2?" 

■ Check the student's answer and display whether the answer is correct. 
The complete program is shown in Listing 3.4. 

Listing 3.4 Subtract! onQuiz. java 

1 import java. util .Scanner; 
2 

3 public class SubtractionQuiz { 

4 public static void main(String[] args) { 

// 1. Generate two random single-digit integers 
int numberl = (int) (Math . randomO * 10); 
int number2 = (int) (Math . randomO * 10); 



5 

6 

7 

8 

9 
10 
11 
12 
13 
14 
15 
16 
17 
18 
19 
20 
21 
22 
23 
24 
25 
26 
27 
28 

29 } 



random numbers 



1/2. If numberl < number2, swap numberl with number2 
if (numberl < number2) { 

int temp = numberl; 

numberl = number2; 

number2 = temp; 

} 

// 3. Prompt the student to answer "What is numberl - number2?" 
System. out. print 

("What is " + numberl + " - " + number2 + "? ") ; 
Scanner input = new Scanner(System . i n) ; 
int answer = i nput . nextlnt() ; 

// 4. Grade the answer and display the result 
if (numberl - number2 == answer) 

System. out . pri ntl n ("You are correct!"); 
el se 

System. out. pri ntl n("Your answer is wrong\n" + numberl + " - " 
+ number2 + " should be " + (numberl - number2)); 



get answer 



check the answer 



What is 6 - 6? 
You are correct! 



What is 9 - 2? 5 
Your answer is wrong 
9-2 should be 7 



line# 


numberl 


number2 


temp 


answer 


output 


6 


2 










7 




9 








1 1 






2 






12 


9 










13 




2 








20 








5 




26 










Your answer is wrong 
9-2 should be 7 
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To swap two variables number 1 and number2, a temporary variable temp (line 1 1) is used 
to first hold the value in numberl. The value in number2 is assigned to numberl (line 12), 
and the value in temp is assigned to number2 (line 13). 

3.10 Problem: Computing Body Mass Index 

Body Mass Index (BMI) is a measure of health on weight. It can be calculated by taking your 
weight in kilograms and dividing by the square of your height in meters. The interpretation of 
BMI for people 16 years or older is as follows: 



BMI 


Interpretation 


below 16 


seriously underweight 


16-18 


underweight 


18-24 


normal weight 


24-29 


overweight 


29-35 


seriously overweight 


above 35 


gravely overweight 



input weight 



input height 



compute bmi 



display output 



Write a program that prompts the user to enter a weight in pounds and height in inches and 
display the BMI. Note that one pound is 0.45359237 kilograms and one inch is 0.0254 
meters. Listing 3.5 gives the program. 

Listing 3.5 ComputeBMI . j ava 

import java.util .Scanner; 



1 
2 
3 
4 
5 
6 
7 
8 
9 
10 
11 
12 
13 
14 
15 
16 
17 
18 
19 
20 
21 
22 
23 
24 
25 
26 
27 
28 
29 
30 
31 



public class ComputeAndlnterpretBMI { 
public static void main(String[] args) { 
Scanner input = new Scanner(System.in) ; 

// Prompt the user to enter weight in pounds 
System . out . pri nt("Enter weight in pounds: ") ; 
double weight = i nput . nextDoubl e() ; 

// Prompt the user to enter height in inches 
System . out . pri nt("Enter height in inches: ") ; 
double height = i nput . nextDoubl e() ; 

final double KIL0GRAMS_PER_P0UND = 0.45359237; // Constant 
final double METERS_PER_INCH = 0.0254; // Constant 

// Compute BMI 

double weightlnKilograms = weight * KIL0GRAMS_PER_P0UND; 
double heightlnMeters = height * METERS„PER_INCH ; 
double bmi = weightlnKilograms / 
(heightlnMeters * heightlnMeters); 

// Display result 

System. out. pri ntf ("Your BMI is %5.2f\n", bmi); 
if (bmi < 16) 

System. out. println("You are seriously underweight"); 
else if (bmi < 18) 

System. out . pri ntl n("You are underweight"); 
else if (bmi < 24) 

System. out . pri ntl n("You are normal weight"); 
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32 else if (bmi < 29) 

33 System. out. pri nt~l n("You are overweight") ; 

34 else if (bmi < 35) 

35 System. out . pri ntl n("You are seriously overweight"); 

36 else 

37 System. out. pri ntl n("You are gravely overweight"); 

38 } 

39 } 



Enter weight in pounds: 146 
Enter height in inches: 70 
Your BMI is 20.948603801493316 
You are normal weight 



line# weight 


height 


WeightlnKilograms 


heightlnMeters 


bmi 


output 


9 146 












13 


70 










19 




66.22448602 








20 






1.778 






21 








20.9486 




25 










Your BMI 
is 20.95 


31 










You are 
normal 
weight 



Two constants KILOGRAMS_PER_POUND and METERS_PER_INCH are defined in lines 
15-16. Using constants here makes programs easy to read. 



3.11 Problem: Computing Taxes 

The United States federal personal income tax is calculated based on filing status and taxable 
income. There are four filing statuses: single filers, married filing jointly, married filing sepa- 
rately, and head of household. The tax rates vary every year. Table 3.2 shows the rates for 
2009. If you are, say, single with a taxable income of $10,000, the first $8,350 is taxed at 10% 
and the other $1,650 is taxed at 15%. So, your tax is $1,082.5 



Table 3.2 2009 U.S. Federal Personal Tax Rates 

Marginal Married Filing Jointly 

Tax Rate Single or Qualified Widow(er) Married Filing Separately Head of Household 



10% 


$0 - $8,350 


$0 - $16,700 


$0 - $8,350 


$0 - $11,950 


15% 


$8,351 - $33,950 


$16,701 - $67,900 


$8,351 - $33,950 


$11,951 - $45,500 


25% 


$33,951 - $82,250 


$67,901 - $137,050 


$33,951 - $68,525 


$45,501 - $117,450 


28% 


$82,251 - $171,550 


$137,051 - $208,850 


$68,525 - $104,425 


$117,451 - $190,200 


33% 


$171,551 - $372,950 


$208,851 - $372,950 


$104,426 - $186,475 


$190,201 - $372,950 


35% 


$372,951+ 


$372,951+ 


$186,476+ 


$372,951 + 




Video Note 

Use multiple alternative 
if statements 
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You are to write a program to compute personal income tax. Your program should prompt 
the user to enter the filing status and taxable income and compute the tax. Enter for single 
filers, 1 for married filing jointly, 2 for married filing separately, and 3 for head of household. 

Your program computes the tax for the taxable income based on the filing status. The filing 
status can be determined using i f statements outlined as follows: 

if (status == 0) { 

// Compute tax for single filers 

} 

else if (status == 1) { 

// Compute tax for married filing jointly 

} 

else if (status == 2) { 

// Compute tax for married filing separately 

} 

else if (status == 3) { 

// Compute tax for head of household 

} 

else { 

// Display wrong status 

} 

For each filing status there are six tax rates. Each rate is applied to a certain amount of taxable 
income. For example, of a taxable income of $400,000 for single filers, $8,350 is taxed at 
10%, (33,950 - 8,350) at 15%, (82,250 - 33,950) at 25%, (171,550 - 82,250) at 28%, 
(372,950 - 171,550) at 33%, and (400,000 - 372,950) at 35%. 

Listing 3.6 gives the solution to compute taxes for single filers. The complete solution is 
left as an exercise. 

Listing 3.6 ComputeTax . j ava 

1 import java.util .Scanner; 

2 

3 public class ComputeTax { 

4 public static void main(String[] args) { 

5 // Create a Scanner 

6 Scanner input = new Scanner(System.in) ; 
7 

8 // Prompt the user to enter filing status 

9 System. out. print( 

10 "(0-single filer, 1-married jointly, \n" + 

11 "2-married separately, 3-head of household) \n" + 

12 "Enter the filing status: ") ; 

13 int status = i nput . nextlnt() ; 
14 

15 // Prompt the user to enter taxable income 

16 System . out . pri nt("Enter the taxable income: ") ; 

17 double income = i nput . nextDoubl e() ; 
18 

19 // Compute tax 

20 double tax = 0; 
21 

22 if (status == 0) { // Compute tax for single filers 

23 if (income <= 8350) 

24 tax = income * 0.10; 

25 else if (income <= 33950) 

26 tax = 8350 * 0.10 + (income - 8350) * 0.15; 

27 else if (income <= 82250) 

28 tax = 8350 * 0.10 + (33950 - 8350) * 0.15 + 



input status 



input income 



compute tax 
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29 (income - 33950) * 0.25; 

30 else if (income <= 171550) 

31 tax = 8350 * 0.10 + (33950 - 8350) * 0.15 + 

32 (82250 - 33950) * 0.25 + (income - 82250) * 0.28; 

33 else if (income <= 372950) 

34 tax = 8350 * 0.10 + (33950 - 8350) * 0.15 + 

35 (82250 - 33950) * 0.25 + (171550 - 82250) * 0.28 + 

36 (income - 171550) * 0.35; 

37 else 



z> o 
30 


tax = 8350 * 0.10 + 


(33950 - 8350) * 0.15 + 




39 




(82250 - 33950) * 


0.25 + (171550 - 82250) * 


.28 + 


40 




(372950 - 171550) 


* 0.33 + (income - 372950) 


* 0.35; 


41 


} 








42 


el se 


if (status == 1) { 


// Compute tax for married 


file jointly 


43 


// 


Left as exercise 






44 


} 








45 


else 


if (status == 2) { 


// Compute tax for married 


separatel y 


46 


// 


Left as exercise 






47 


} 








48 


el se 


if (status == 3) { 


// Compute tax for head of 


househol d 


49 


// 


Left as exercise 






50 


} 








51 


el se 


{ 







52 System. out. println("Error: invalid status"); 

53 System, exi t(0) ; exit program 

54 } 
55 

56 // Display the result 

57 System. out. println("Tax is " + (int)(tax * 100) / 100.0); display output 

58 } 

59 } 



(0-single filer, 1-married jointly, 
2-married separately, 3-head of household) 
Enter the filing status: |^ E "ter 
Enter the taxable income: 400000 |^ E " ter 
Tax is 117683.5 



line# 


status 


income 


tax 


output 


13 











17 




400000 






20 











38 






1 17683.5 




57 








Tax is 1 17683.5 



The program receives the filing status and taxable income. The multiple alternative i f 
statements (lines 22, 42, 45, 48, 51) check the filing status and compute the tax based on the 
filing status. 

System. exi t(0) (line 53) is defined in the System class. Invoking this method termi- System. exi t(0) 
nates the program. The argument indicates that the program is terminated normally. 

An initial value of is assigned to tax (line 20). A syntax error would occur if it had no 
initial value, because all of the other statements that assign values to tax are within the i f 
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statement. The compiler thinks that these statements may not be executed and therefore 
reports a syntax error. 

test all cases To test a program, you should provide the input that covers all cases. For this program, 

your input should cover all statuses (0, 1, 2, 3). For each status, test the tax for each of the six 
brackets. So, there are a total of 24 cases. 

|Sf Tip 

For all programs, you should write a small amount of code and test it before moving on to add 
incremental development and more code. This is called incremental development and testing. This approach makes debugging 

testing easier, because the errors are likely in the new code you just added. 

3.12 Logical Operators 

Sometimes, whether a statement is executed is determined by a combination of several condi- 
tions. You can use logical operators to combine these conditions. Logical operators, also known 
as Boolean operators, operate on Boolean values to create a new Boolean value. Table 3.3 gives 
a list of Boolean operators. Table 3.4 defines the not ( ! ) operator. The not ( ! ) operator negates 
true to f al se and fal se to true. Table 3.5 defines the and (&&) operator. The and (&&) of 
two Boolean operands is true if and only if both operands are true. Table 3.6 defines the or 
(||) operator. The or ( | | ) of two Boolean operands is true if at least one of the operands is 
true. Table 3.7 defines the exclusive or (a) operator. The exclusive or (A) of two Boolean 
operands is true if and only if the two operands have different Boolean values. 



Table 3.3 Boolean Operators 



Operator 



Name 



Description 



i 

&& 
II 

A 



not 
and 
or 

exclusive or 



logical negation 
logical conjunction 
logical disjunction 
logical exclusion 



Table 3.4 Truth Table for Operator ! 



Example (assume age = 24, gender = 'F) 



true 
false 



false 
true 



!(age > 18) is false, because (age > 18) is true. 

! (gender == ' M ' ) is true, because (gender == ' M ' ) 
is fal se. 



Table 3.5 Truth Table for Operator && 



pi p2 pi && p2 

fal se fal se fal se 

false true false 

true false false 

true true true 



Example (assume age = 24, gender = 'F'J 

(age > 18) && (gender == 1 F') is true, 
because (age > 18) and (gender == ' F') are 
both true. 

(age > 18) && (gender ! = ' F ' ) is f al se, 
because (gender != ' F") is false. 



3.12 Logical Operators 

Table 3.6 Truth Table for Operator | | 

pi p2 pi \\p2 Example (assume age = 24, gender = 'F'J 

false false false (age > 34) || (gender ==' F') is true, because (gender ==' F') 
is true. 

false true true 

true false true (age > 34) || (gender == 'M') is fal se, because (age > 34) and 

(gender == ' M ' ) are both fal se. 

true true true 



Table 3.7 Truth Table for Operator a 



pi p2 pl A p2 Example (assume age = 24, gender = 'F'J 

false false false (age > 34) a (gender == ' F') is true, because (age > 34) is 
false but (gender == ' F') is true. 

false true true 

true false true (age > 34) || (gender == 'M') is fal se, because (age > 34) and 

(gender == ' M ' ) are both fal se. 

true true false 



Listing 3.7 gives a program that checks whether a number is divisible by 2 and 3, by 2 or 
3, and by 2 or 3 but not both: 

Listing 3.7 TestBool eanOperators . java 

1 import java. util .Scanner; importclass 
2 

3 public class TestBool eanOperators { 

4 public static void main(String[] args) { 



5 // Create a Scanner 

6 Scanner input = new Scanner(System.in) ; 
7 

8 // Receive an input 

9 System . out . pri nt("Enter an integer: ") ; 

10 int number = i nput . nextlntO ; input 
11 

12 System. out. println("Is " + number + 

13 "\n\tdivisible by 2 and 3? " + 

14 (number % 2 == && number % 3 == ) and 

15 + "\n\tdi visible by 2 or 3? " + 

16 (number % 2 == | | number % 3 == ) + or 

17 "\n\tdivisible by 2 or 3, but not both? " 

18 + (number % 2 == a number % 3 == )); exclusiveor 



19 } 

20 } 



Enter an integer 


18 |^ Enter 


Is 18 




divisible by 2 


and 3? true 


divisible by 2 


or 3? true 


divisible by 2 


or 3, but not both? false 
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A long string is formed by concatenating the substrings in lines 12-18. The three \n charac- 
ters display the string in four lines, (number % 2 == && number % 3 == 0) (line 14) checks 
whether the number is divisible by 2 and 3. (number % 2 == | | number % 3 == 0) (line 16) 
checks whether the number is divisible by 2 or 3. (number % 2 == A number % 3 == 0) (line 
20) checks whether the number is divisible by 2 or 3, but not both. 



incompatible operands 



Caution 

In mathematics, the expression 

1 <= numberOfDaysInAMonth <= 31 

is correct. However, it is incorrect in Java, because 1 <= numberOfDaysInAMonth is evaluated 
to a boolean value, which cannot be compared with 31. Here, two operands (a boolean value 
and a numeric value) are incompatible. The correct expression in Java is 

(1 <= numberOfDaysInAMonth) && (numberOfDaysInAMonth <= 31) 



cannot cast bool ean 



Note 

As shown in the preceding chapter, a char value can be cast into an int value, and vice versa. 
A boolean value, however, cannot be cast into a value of another type, nor can a value of 
another type be cast into a boolean value. 



De Morgan's law 



conditional operator 
short-circuit operator 



Note 

De Morgan's law, named after Indian-born British mathematician and logician Augustus De Morgan 
( 1 806- 1 87 1 ), can be used to simplify Boolean expressions. The law states 

! (conditionl && condi tion2) issameas Iconditionl || !condition2 
! (conditionl || condi tion2) issameas ! conditionl && !condition2 



For example, 

! (n == 2 
! (n % 2 = 



| n == 3) is same as n != 2 && n != 3 
&& n % 3 == 0) is same as n % 2 != 



n % 3 != 



If one of the operands of an && operator is fal se, the expression is fal se; if one of the 
operands of an | | operator is true, the expression is true. Java uses these properties to 
improve the performance of these operators. When evaluating pi && p2, Java first evaluates 
pi and then, if pi is true, evaluates p2; if pi is fal se, it does not evaluate p2. When eval- 
uating pi | | p2, Java first evaluates pi and then, if pi is fal se, evaluates p2; if pi is true, 
it does not evaluate p2. Therefore, && is referred to as the conditional or short-circuit AND 
operator, and 1 1 is referred to as the conditional or short-circuit OR operator. 



3.13 Problem: Determining Leap Year 

leap year A year is a leap year if it is divisible by 4 but not by 100 or if it is divisible by 400. So you 

can use the following Boolean expressions to check whether a year is a leap year: 

// A leap year is divisible by 4 
boolean isLeapYear = (year % 4 ==0); 

// A leap year is divisible by 4 but not by 100 
isLeapYear = isLeapYear && (year % 100 != 0) ; 

// A leap year is divisible by 4 but not by 100 or divisible by 400 
isLeapYear = isLeapYear | | (year % 400 == 0); 

or you can combine all these expressions into one like this: 

isLeapYear = (year % 4 == && year % 100 != 0) | | (year % 400 == 0); 



3.14 Problem: Lottery 



Listing 3.8 gives the program that lets the user enter a year and checks whether it is a leap 
year. 

Listing 3.8 LeapYear. java 

1 import java. util .Scanner; 

2 

3 public class LeapYear { 

4 public static void main(String[] args) { 

5 // Create a Scanner 

6 Scanner input = new Scanner(System.in) ; 

7 System . out . pri nt("Enter a year: "); 

8 int year = i nput . nextlntO ; 
9 

10 // Check if the year is a leap year 

11 boolean isLeapYear = 

12 (year % 4 == && year % 100 != 0) | | (year % 400 == 0) ; 
13 

14 // Display the result 

15 System. out. println(year + " is a leap year? " + isLeapYear); 

16 } 

17 } 



Enter a year: 2008 .- J Enter 
2008 is a leap year? true 

Enter a year: 2002 h Enter 
2002 is a leap year? false 



3.14 Problem: Lottery 

Suppose you want to develop a program to play lottery. The program randomly generates a 
lottery of a two-digit number, prompts the user to enter a two-digit number, and determines 
whether the user wins according to the following rule: 

1. If the user input matches the lottery in exact order, the award is $10,000. 

2. If all the digits in the user input match all the digits in the lottery, the award is $3,000. 

3. If one digit in the user input matches a digit in the lottery, the award is $1,000. 
The complete program is shown in Listing 3.9. 

Listing 3.9 Lottery, java 

1 import java. util .Scanner; 
2 

3 public class Lottery { 

4 public static void main(String[] args) { 

5 // Generate a lottery 

6 int lottery = (int) (Math . randomO * 100); 
7 

8 // Prompt the user to enter a guess 

9 Scanner input = new Scanner(System . i n) ; 

10 System . out . pri nt("Enter your lottery pick (two digits): ") ; 

11 int guess = i nput . nextlnt () ; 
12 

13 // Get digits from lottery 

14 int lotteryDigitl = lottery / 10; 



input 



leap year? 



display result 




generate a lottery 



enter a guess 
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exact match? 
match all digits? 

match one digit? 



15 
16 
17 
18 
19 
20 
21 
22 
23 
24 
25 
26 
27 
28 
29 
30 
31 
32 
33 
34 
35 
36 

37 } 



int lotteryDigit2 = lottery % 10; 

// Get digits from guess 

int guessDigitl = guess / 10; 

int guessDigit2 = guess % 10; 

System. out. pri ntl n("The lottery number is 

// Check the guess 



+ lottery) ; 



System. out . pri ntl n( 


"Exact match: you 


else if (guessDigit2 


== 1 otteryDi gi tl 




&& guessDigitl 


== 1 otteryDi git2) 


System. out . pri ntl n( 


"Match all digits 


else i 


f (guessDigitl 


== 1 otteryDi gi tl 




| | guessDigitl 


== 1 otteryDi gi t2 




| | guessDigit2 


== 1 otteryDi gi tl 




| | guessDigit2 


== 1 otteryDi git2) 



you win $3,000"); 



you win $1,000") ; 



el se 

System. out . pri ntl n("Sorry, no match"); 



Enter your lottery pick (two digits): 45 ^ Enter 
The lottery number is 12 
Sorry, no match 



Enter your lottery pick: 23 |^ Ente r 

The lottery number is 34 

Match one digit: you win $1,000 



^\Iine# 6 
variable^ 


II 14 15 18 19 33 


lottery 34 




guess 


23 


lotteryDigitl 


3 


lotteryDigit2 


4 


guessDigitl 


2 


guessDigit2 


3 


output 


Match one digit: 




you win $1,000 


The program generates a lottery using the random () method (line 6) and prompts the user to 
enter a guess (line 11). Note that guess % 10 obtains the last digit from guess and guess / 10 
obtains the first digit from guess, since guess is a two-digit number (lines 18-19). 

The program checks the guess against the lottery number in this order: 



1. First check whether the guess matches the lottery exactly (line 24). 

2. If not, check whether the reversal of the guess matches the lottery (lines 26-27). 




3.15 switch Statements 
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3. If not, check whether one digit is in the lottery (lines 29-32). 

4. If not, nothing matches. 

3.15 switch Statements 

The if statement in Listing 3.6, ComputeTax.java, makes selections based on a single true 
or f al se condition. There are four cases for computing taxes, which depend on the value of 
status. To fully account for all the cases, nested i f statements were used. Overuse of nested 
i f statements makes a program difficult to read. Java provides a swi tch statement to handle 
multiple conditions efficiently. You could write the following switch statement to replace 
the nested i f statement in Listing 3.6: 

switch (status) { 

case 0: compute taxes for single filers; 
break; 

case 1: compute taxes for married filing jointly; 
break; 

case 2: compute taxes for married filing separately; 
break; 

case 3: compute taxes for head of household; 
break; 

default: System. out. println("Errors: invalid status"); 
System . exi t(0) ; 

} 

The flow chart of the preceding switch statement is shown in Figure 3.5. 



status is 



status is 1 



status is 2 



status is 3 



Compute tax for single filers 



h. 



break 



Compute tax for married file jointly | -»- break | 
Compute tax for married file separately break | 



default 




Default actions 





Figure 3.5 The switch statement checks all cases and executes the statements in the 
matched case. 

This statement checks to see whether the status matches the value 0, 1, 2, or 3, in that 
order. If matched, the corresponding tax is computed; if not matched, a message is displayed. 
Here is the full syntax for the switch statement: 

switch (switch-expression) { 
case valuel: statement(s)l; 
break; 



switch statement 
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case value2: statement(s)2 ; 
break; 

case valueN: statement(s)N ; 
break; 

defaul t : statement (s) -f or-def aul t ; 

} 



The switch statement observes the following rules: 

■ The switch-expression must yield a value of char, byte, short, or int type 
and must always be enclosed in parentheses. 

■ The val uel, . . . , and val ueN must have the same data type as the value of the 
switch-expression. Note that val uel, . . . , and valueN are constant expres- 
sions, meaning that they cannot contain variables, such as 1 + x. 

■ When the value in a case statement matches the value of the swi tch-expression , 

the statements starting from this case are executed until either a break statement or 
the end of the switch statement is reached. 

■ The keyword break is optional. The break statement immediately ends the 
switch statement. 

■ The defaul t case, which is optional, can be used to perform actions when none of 
the specified cases matches the switch-expression. 

■ The case statements are checked in sequential order, but the order of the cases 
(including the default case) does not matter. However, it is good programming 
style to follow the logical sequence of the cases and place the default case at the 
end. 

|Bt Caution 

without break Do not forget to use a break statement when one is needed. Once a case is matched, the state- 

ments starting from the matched case are executed until a break statement or the end of the 

fall-through behavior switch statement is reached. This is referred to as fall-through behavior. For example, the fol- 

lowing code prints character a three times if ch is ' a ' : 



switch (ch) { 



case a 
case 'b' 
case 'c' 



System. out. pri ntln(ch) ; 
System. out. println(ch) ; 
System. out . pri ntl n(ch) ; 




System 


out 


pri ntl n(ch) 1 




System 


out 


pri ntl n(ch) 1 


I 


System 


out 


pri ntl n(ch) | 



#Tip 

To avoid programming errors and improve code maintainability, it is a good idea to put a com- 
ment in a case clause if break is purposely omitted. 
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3.16 Conditional Expressions 

You might want to assign a value to a variable that is restricted by certain conditions. For 
example, the following statement assigns 1 to y if x is greater than 0, and - 1 to y if x is less 
than or equal to 0. 

if (x > 0) 

y = i; 

el se 

y = -l; 

Alternatively, as in this example, you can use a conditional expression to achieve the same 
result. 

y = (x > 0) ? 1 1 -1; 

Conditional expressions are in a completely different style, with no explicit i f in the state- 
ment. The syntax is shown below: 

boolean-expression ? expressionl : expression2; 

The result of this conditional expression is expressionl if boolean-expression is true; conditional expression 
otherwise the result is expression2. 

Suppose you want to assign the larger number between variable numl and num2 to max. 
You can simply write a statement using the conditional expression: 

max = (numl > num2) ? numl : num2; 

For another example, the following statement displays the message "num is even" if num is 
even, and otherwise displays "num is odd." 

System. out. pri nt~l n((num % 2 == 0) ? "num is even" : "num is odd"); 
§ Note 

The symbols ? and : appear together in a conditional expression. They form a conditional oper- 
ator. It is called a ternary operator because it uses three operands. It is the only ternary operator 
in Java. 

3.17 Formatting Console Output 

If you wish to display only two digits after the decimal point in a floating-point value, you 
may write the code like this: 

double x = 2.0 / 3; 

System. out. print~ln("x is " + (int)(x * 100) / 100.0); 



x is 0.66 




However, a better way to accomplish this task is to format the output using the printf printf 
method. The syntax to invoke this method is 

System . out . pri ntf (format , iteml, item2 item/c) 

where format is a string that may consist of substrings and format specifiers. 
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specifier A format specifier specifies how an item should be displayed. An item may be a numeric 

value, a character, a Boolean value, or a string. A simple specifier consists of a percent sign 
(%) followed by a conversion code. Table 3.8 lists some frequently used simple specifiers: 

Table 3.8 Frequently Used Specifiers 



Specifier Output Example 

%b a Boolean value true or false 

%c a character 'a' 

%d a decimal integer 200 

%f a floating-point number 45.460000 

a number in standard scientific notation 4.556000e+01 

%s a string "Java is cool" 



Here is an example: 



int count = 5; items 
double amount = 45.56; 

System. out. printf ("count is %d and amount is %f " , count, amount); 




display count is 5 and amount is 45.560000 



Items must match the specifiers in order, in number, and in exact type. For example, the 
specifier for count is %d and for amount is %f . By default, a floating-point value is displayed 
with six digits after the decimal point. You can specify the width and precision in a specifier, 
as shown in the examples in Table 3.9. 



Table 3.9 Examples of Specifying Width and Precision 

Example Output 



%5c Output the character and add four spaces before the character item. 

%6b Output the Boolean value and add one space before the false value and two spaces before 

the true value. 

%5d Output the integer item with width at least 5. If the number of digits in the item is < 5, 

add spaces before the number. If the number of digits in the item is > 5, the width is 
automatically increased. 

%10 . 2f Output the floating-point item with width at least 10 including a decimal point and two 
digits after the point. Thus there are 7 digits allocated before the decimal point. If the 
number of digits before the decimal point in the item is < 7, add spaces before the 
number. If the number of digits before the decimal point in the item is > 7, the width is 
automatically increased. 

%10 . 2e Output the floating-point item with width at least 10 including a decimal point, two digits 
after the point and the exponent part. If the displayed number in scientific notation has 
width less than 10, add spaces before the number. 

%12s Output the string with width at least 12 characters. If the string item has less than 12 char- 

acters, add spaces before the string. If the string item has more than 12 characters, the 
width is automatically increased. 
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The code presented in the beginning of this section for displaying only two digits after the 
decimal point in a floating-point value can be revised using the printf method as follows: 



double x = 2.0 / 3; 

System. out. printf ("x is %4.2f", x) ; 

display x is 0.67 



% \4\ . 

— Tp jr-)^- 1 



format specifier 



field width 



conversion code 



precision 



By default, the output is right justified. You can put the minus sign (-) in the specifier to left justify 
specify that the item is left justified in the output within the specified field. For example, the 
following statements 

System. out. printf ("%8d%8s%8.1f\n", 1234, "Java", 5.6); 
System. out. printf ("%-8d%-8s%-8 . If \n", 1234, "lava", 5.6); 

display 



! characters 



i characters 



! characters 



! J 



Caution 

The items must match the specifiers in exact type. The item for the specifier %f or %e must be a 
floating-point type value such as 40.0, not 40. Thus an i nt variable cannot match %f or %e. 



Tip 

The % sign denotes a specifier. To output a literal % in the format string, use %%. 



3.18 Operator Precedence and Associativity 

Operator precedence and associativity determine the order in which operators are evaluated. 
Suppose that you have this expression: 

3 + 4 * 4 > 5 * (4 + 3) - 1 

What is its value? What is the execution order of the operators? 

Arithmetically, the expression in the parentheses is evaluated first. (Parentheses can be 
nested, in which case the expression in the inner parentheses is executed first.) When evaluat- 
ing an expression without parentheses, the operators are applied according to the precedence 
rule and the associativity rule. 

The precedence rule defines precedence for operators, as shown in Table 3.10, which contains precedence 
the operators you have learned so far. Operators are listed in decreasing order of precedence from 
top to bottom. Operators with the same precedence appear in the same group. (See Appendix C, 
"Operator Precedence Chart," for a complete list of Java operators and their precedence.) 

If operators with the same precedence are next to each other, their associativity determines associativity 
the order of evaluation. All binary operators except assignment operators are left associative. 
For example, since + and - are of the same precedence and are left associative, the expression 

a - b + c - d equivalent (Ca - b) + c) - d 
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Table 3.10 Operator Precedence Chart 



Precedence Operator 



var++ and var-- (Postfix) 

+, - (Unary plus and minus), ++var and - -var (Prefix) 
(type) (Casting) 
! (Not) 

*, /, % (Multiplication, division, and remainder) 

+, - (Binary addition and subtraction) 

<, <=, >, >= (Comparison) 

==, ! = (Equality) 

a (Exclusive OR) 

&& (AND) 

I I (OR) 

=, +=, - =, *=, /=, %= (Assignment operator) 



Assignment operators are right associative. Therefore, the expression 

equivalent 



a = b += c = 5 



a = (b += (c = 5)) 



Suppose a, b, and c are 1 before the assignment; after the whole expression is evaluated, a 
becomes 6, b becomes 6, and c becomes 5. Note that left associativity for the assignment 
operator would not make sense. 



behind the scenes 



Note 

Java has its own way to evaluate an expression internally. The result of a Java evaluation is the 
same as that of its corresponding arithmetic evaluation. Interested readers may refer to Supple- 
ment III.B for more discussions on how an expression is evaluated in Java behind the scenes. 



3.19 (GUI) Confirmation Dialogs 



You have used showMessageDialog to display a message dialog box and 
showInputDi al og to display an input dialog box. Occasionally it is useful to answer a ques- 
tion with a confirmation dialog box. A confirmation dialog can be created using the following 
statement: 



int option = 

DOptionPane.showConfi rmDiaJo 
(null , "Conti nue 




When a button is clicked, the method returns an option value. The value is 
J0ptionPane.YES_0PTI0N (0) for the Fes button, J0ptionPane.N0_0PTI0N (1) fortheTVo 
button, and JOptionPane . CANCEL_0PTI0N (2) for the Cancel button. 

You may rewrite the guess-birthday program in Listing 3.3 using confirmation dialog 
boxes, as shown in Listing 3.10. Figure 3.6 shows a sample run of the program for the 
day 19. 
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Is your hirthuate in thesQ numbers? 
13 5 7 
911 1315 
1719 2123 
25 27 29 31 



Yes 



Cancel 



she 

on 




*1 



Is your birthdate in these numbers? 
2 3 6 7 
10 11 14 15 
18 19 22 23 
26 27 30 31 



Yes 



Cancel 



Select an Option 



Is your birthilote in these numbers? 
4 5 6 7 
12 13 14 15 

20 21 22 23 
23 29 30 31 



| lies | 


NO 


Cancel 









(a) 



(b) 



(c) 



2d 



Is your birthciate in these numbers? 
8 9 10 11 
121314 15 
24 25 26 27 
28 20 30 31 



Yes 



Cancel 



Select an Option 



S 



Is your birthdate in these nu ml) ers? 
16 17 18 19 

20 21 22 23 
24 25 2fi 27 
26 29 30 31 



Yes 



No 



Cancel 




(d) (e) (f) 

Figure 3.6 Click Yes in (a), Yes in (b), No in (c), No in (d), and Yes in (e). 



Listing 3.I0 GuessBi rthdayUsingConfi rmationDialog. java 

1 import javax. swing. JOpti onPane ; importclass 
2 

3 public class GuessBi rthdayUsingConfi rmationDialog { 

4 public static void main(String[] args) { 

5 String setl = setl 

6 "13 5 7\n" + 

7 " 9 11 13 15\n" + 

8 "17 19 21 23\n" + 

9 "25 27 29 31"; 
10 

11 String set2 = set2 

12 " 2 3 6 7\n" + 

13 "10 11 14 15\n" + 

14 "18 19 22 23\n" + 

15 "26 27 30 31"; 
16 

17 String set3 = set3 

18 " 4 5 6 7\n" + 

19 "12 13 14 15\n" + 

20 "20 21 22 23\n" + 

21 "28 29 30 31"; 
22 

23 String set4 = set4 

24 "89 10 ll\n" + 

25 "12 13 14 15\n" + 

26 "24 25 26 27\n" + 

27 "28 29 30 31"; 
28 

29 String set5 = set5 

30 "16 17 18 19\n" + 

31 "20 21 22 23\n" + 

32 "24 25 26 27\n" + 

33 "28 29 30 31"; 
34 
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35 int day = 0; 

36 

37 // Prompt the user to answer questions 

confirmation dialog 38 int answer = JOpti onPane . showConf i rmDi al og (nul 1 , 

39 "Is your birthday in these numbers?\n" + setl) ; 
40 

insetl? 41 if (answer == J0ptionPane.YES_0PTI0N) 

42 day += 1; 
43 

44 answer = JOpti onPane. showConf i rmDi alog (null , 

45 "Is your birthday in these numbers?\n" + set2) ; 
46 

inset2? 47 if (answer == J0ptionPane.YES_0PTI0N) 

48 day += 2; 
49 

50 answer = JOpti onPane. showConf i rmDi alog (null , 

51 "Is your birthday in these numbers?\n" + set3) ; 
52 

inset3? 53 if (answer == J0ptionPane.YES_0PTI0N) 

54 day += 4; 
55 

56 answer = JOpti onPane. showConf i rmDi alog (null , 

57 "Is your birthday in these numbers?\n" + set4) ; 
58 

inset4? 59 if (answer == J0ptionPane.YES_0PTI0N) 

60 day += 8; 
61 

62 answer = JOpti onPane . showConf i rmDi alog (null , 

63 "Is your birthday in these numbers?\n" + set5) ; 
64 

inset5? 65 if (answer == J0ptionPane.YES_0PTI0N) 

66 day += 16; 
67 

68 JOptionPane.showMessageDi alog (null , "Your birthday is " + 

69 day + "!"); 

70 } 

71 } 

The program displays confirmation dialog boxes to prompt the user to answer whether a 
number is in Setl (line 38), Set2 (line 44), Set3 (line 50), Set4 (line 56), and Set5 (line 62). If 
the answer is Yes, the first number in the set is added to day (lines 42, 48, 54, 60, and 66). 
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Chapter Summary 

1 . A bool ean variable stores a true or f al se value. 

2. The relational operators (<, <=, ==, ! =, >, >=) work with numbers and characters, and 
yield a Boolean value. 
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3. The Boolean operators &&, | | , ! , and a operate with Boolean values and variables. 

4. When evaluating pi && p2, Java first evaluates pi and then evaluates p2 if pi is true; 
if pi is fal se, it does not evaluate p2. When evaluating pi 1 1 p2, Java first evaluates 
pi and then evaluates p2 if pi is fal se; if pi is true, it does not evaluate p2. There- 
fore, && is referred to as the conditional or short-circuit AND operator, and 1 1 is 
referred to as the conditional or short-circuit OR operator. 

5. Selection statements are used for programming with alternative courses. There are 
several types of selection statements: i f statements, if... el se statements, nested 
if statements, switch statements, and conditional expressions. 

6. The various i f statements all make control decisions based on a Boolean expression. 
Based on the true or fal se evaluation of the expression, these statements take one 
of two possible courses. 

7. The switch statement makes control decisions based on a switch expression of type 
char, byte, short, or int. 

8. The keyword break is optional in a switch statement, but it is normally used at the 
end of each case in order to terminate the remainder of the swi tch statement. If the 
break statement is not present, the next case statement will be executed. 



Review Questions 

Section 3.2 

3 . 1 List six comparison operators. 

3.2 Can the following conversions involving casting be allowed? If so, find the con- 
verted result. 

boolean b = true; 
i = (int)b; 

int i = 1; 

boolean b = (boolean) i ; 
Sections 3.3-3.1 1 

3.3 What is the printout of the code in (a) and (b) if number is 30 and 35, respec- 
tively? 



if (number % 2 == 0) 

System. out. println(number + " is even."); 

System. out. println(number + " is odd."); 



(a) 



if (number % 2 == 0) 




System. out. pri ntl n(number + 


"is even . ") ; 


el se 




System. out. pri ntl n(number + 


" is odd."); 


(b) 



3.4 Suppose x = 3 and y = 2; show the output, if any, of the following code. What is 
the output if x = 3 and y = 4? What is the output if x = 2 and y = 2? Draw a flow 
chart of the code: 



if (x > 2) { 
if (y > 2) { 
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3.5 



z = x + y; 

System. out . pri ntl n("z is " + z) ; 

} 

} 

el se 

System. out. print"ln("x is " + x) ; 

Which of the following statements are equivalent? Which ones are correctly 
indented? 



if (i > 0) if 
(j > 0) 
x = 0; else 
if (k > 0) y = 
el se z = ; 



; 



(a) 



if (i > 0) { 
if (j > 0) 

x = 0; 
else if (k > 0) 

y = 0; 

} 

el se 

z = 0; 



(b) 



if (i > 0) 
if (j > 0) 

x = 0; 
else if (k > 0) 

y = 0; 
el se 

z = 0; 



(c) 



if (i > 0) 
if (j > 0) 

x = 0; 
else if (k > 0) 

y = 0; 

else 

z = 0; 



(d) 



3.6 Suppose x = 2 and y = 3. Show the output, if any, of the following code. What is 
the output if x = 3 and y = 2? What is the output if x = 3 and y = 3? 

(Hint: Indent the statement correctly first.) 

if (x > 2) 
if (y > 2) { 
int z = x + y; 

System. out . pri ntl n("z is " + z) ; 

} 

el se 

System . out . pri ntl n("x is " + x) ; 

3.7 Are the following two statements equivalent? 



if (income <= 10000) 

tax = income * 0.1; 
else if (income <= 20000) 

tax = 1000 + 

(income - 10000) * 0.15; 



if (income <= 10000) 
tax = income * 0.1; 
else if (income > 10000 && 
income <= 20000) 
tax = 1000 + 

(income - 10000) * 0.15; 



3.8 Which of the following is a possible output from invoking 
Math. random ()? 

323.4, 0.5, 34, 1.0, 0.0, 0.234 



3.9 How do you generate a random integer i such that ^ < 20? How 
do you generate a random integer i such that 10 ^ (' < 20? How do 
you generate a random integer i such that 10 s f < 50? 

3.10 Write an i f statement that assigns 1 to x if y is greater than 0. 

3.11 (a) Write an i f statement that increases pay by 3% if score is greater 
than 90. (b) Write an i f statement that increases pay by 3% if score 
is greater than 90, otherwise increases pay by 1%. 
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3.12 What is wrong in the following code? 

if (score >= 60.0) 

grade = 'D' ; 
else if (score >= 70.0) 

grade = 'C ; 
else if (score >= 80.0) 

grade = 'B' ; 
else if (score >= 90.0) 

grade = 'A' ; 
el se 

grade = ' F' ; 

3.13 Rewrite the following statement using a Boolean expression: 

if (count % 10 == 0) 

newLine = true; 
el se 

newLine = false; 



Sections 3.12-3.14 

3.14 Assuming that x is 1, show the result of the following Boolean expressions. 

(true) && (3 > 4) 

!(x > 0) && (x > 0) 
(x > 0) || (x < 0) 
(x != 0) || (x == 0) 
(x >= 0) || (x < 0) 
(x != 1) == !(x == 1) 

3.15 Write a Boolean expression that evaluates to true if a number stored in variable 
num is between 1 and 100. 

3.16 Write a Boolean expression that evaluates to true if a number stored in variable 
num is between 1 and 100 or the number is negative. 

3.17 Assume that x and y are int type. Which of the following are legal Java expres- 
sions? 

x > y > 
x = y && y 
x /= y 
x or y 
x and y 

(x != 0) || (x = 0) 

3.18 Suppose that x is 1. What is x after the evaluation of the following expression? 

(x >= 1) && (x++ > 1) 
(x > 1) && (x++ > 1) 

3.19 What is the value of the expression ch >= 'A' && ch <= 'Z' if ch is 'A', 'p', 
'E\ or '5'? 

3.20 Suppose, when you run the program, you enter input 2 3 6 from the console. What 
is the output? 

public class Test { 

public static void man n(Stri ng [] args) { 

java. uti 1 . Scanner input = new java.util .Scanner(System.in) ; 
double x = i nput . nextDoubl e() ; 
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double y = i nput . nextDoubl e() ; 
double z = i nput . nextDoubl e() ; 

System. out. pri ntl n("(x <y&&y<z)is"+(x<y&&y< z)) ; 
System. out. println("(x < y || y < z) is " + (x < y || y < z)) ; 
System. out . pri ntl n(" ! (x < y) is " + ! (x < y)); 
System. out . pri ntl n("(x + y < z) is " + (x + y < z)); 
System. out . pri ntl n("(x + y < z) is " + (x + y < z)); 

} 

} 

3.2 1 Write a Boolean expression that evaluates true if age is greater than 13 and less 
than 18. 

3.22 Write a Boolean expression that evaluates true if weight is greater than 50 or 
height is greater than 160. 

3.23 Write a Boolean expression that evaluates true if weight is greater than 50 and 
height is greater than 160. 

3.24 Write a Boolean expression that evaluates true if either weight is greater than 
50 or height is greater than 160, but not both. 

Section 3.15 

3.25 What data types are required for a swi tch variable? If the keyword break is not 
used after a case is processed, what is the next statement to be executed? Can you 
convert a swi tch statement to an equivalent i f statement, or vice versa? What are 
the advantages of using a switch statement? 

3.26 What is y after the following swi tch statement is executed? 

x = 3; y = 3; 
switch (x + 3) { 

case 6: y = 1; 

default: y += 1; 

} 

3.27 Use a swi tch statement to rewrite the following i f statement and draw the flow 
chart for the swi tch statement: 



if (a == 1) 




x += 5 ; 




else if (a == 


) 


x += 10; 




else if (a == 


) 


x += 16; 




else if (a == 


) 


x += 34; 





3.28 Write a switch statement that assigns a String variable dayName with Sunday, 
Monday, Tuesday, Wednesday, Thursday, Friday, Saturday, if day is 0, 1, 2, 3, 4, 
5, 6, accordingly. 

Section 3.16 

3.29 Rewrite the following i f statement using the conditional operator: 

if (count % 10 == 0) 

System . out . pri nt(count + "\n") ; 
el se 

System . out . pri nt(count + " ") ; 
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3.30 Rewrite the following statement using a conditional expression: 

if (temperature > 90) 

pay = pay * 1.5; 
el se 

pay = pay * 1.1; 

Section 3. 1 7 

3.31 What are the specifiers for outputting a Boolean value, a character, a decimal inte- 
ger, a floating-point number, and a string? 

3.32 What is wrong in the following statements? 

(a) System. out. pri ntf ("%5d %d", 1, 2, 3); 

(b) System. out. pri ntf ("%5d %f", 1); 

(c) System. out. pri ntf ("%5d %f", 1, 2); 

3.33 Show the output of the following statements. 

(a) System. out. printf ("amount is %f %e\n", 32.32, 32.32); 

(b) System. out. pri ntf ("amount is %5 .4f %5 .4e\n" , 32.32, 32.32); 

(c) System. out. pri ntf ("%6b\n", (1 > 2)); 

(d) System. out. pri ntf ("%6s\n", "Java"); 

(e) System.out.printf("%-6b%s\n", (1 > 2) , "Java"); 

(f) System. out. pri ntf ("%6b%-s\n", (1 > 2) , "Java"); 

3.34 How do you create a formatted string? 
Section 3.18 

3.35 List the precedence order of the Boolean operators. Evaluate the following expres- 
sions: 

true | | true && false 
true && true | | false 

3.36 True or false? All the binary operators except = are left associative. 

3.37 Evaluate the following expressions: 

2*2-3>2&&4-2>5 
2*2-3>2||4-2>5 

3.38 Is (x>0 &&x<10) thesameas ((x>0) && (x<10))?Is (x>0 ||x<10) 
the same as ((x > 0) | | (x < 10))? Is (x > | | x < 10 && y < 0) the same as 
(x >0 | | (x< 10 &&y<0))? 

Section 3.19 

3.39 How do you display a confirmation dialog? What value is returned when invoking 
JOptionPane . showConf i rmDi al og? 

Programming Exercises 



Pedagogical Note 

For each exercise, students should carefully analyze the problem requirements and design 

strategies for solving the problem before coding. think before coding 
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Pedagogical Note 

document analysis and design Instructors may ask students to document analysis and design for selected exercises. Students 

should use their own words to analyze the problem, including the input, output, and what 
needs to be computed, and describe how to solve the problem in pseudocode. 



Debugging Tip 

Before you ask for help, read and explain the program to yourself, and trace it using several 
representative inputs by hand or using an IDE debugger. You learn how to program by debug- 
learn from mistakes ging your own mistakes. 

Section 3.2 

3.1* (Algebra: solving quadratic equations) The two roots of a quadratic equation 
ax 2 + bx + c = can be obtained using the following formula: 



-b + Vb 2 - 4ac -b - Vb 2 - 4ac 

r\ = and r2 = 

2a 2a 

b 2 — 4ac is called the discriminant of the quadratic equation. If it is positive, the 
equation has two real roots. If it is zero, the equation has one root. If it is negative, 
the equation has no real roots. 

Write a program that prompts the user to enter values for a, b, and c and displays 
the result based on the discriminant. If the discriminant is positive, display two 
roots. If the discriminant is 0, display one root. Otherwise, display "The equation 
has no real roots". 

Note you can use Math.pow(x, 0.5) to compute Vx. Here are some sample 





Enter a, b, c: 1.0 3 1 


Enter 


The roots are -0.381966 


and -2.61803 



Enter a, b, c: 1 2.0 1 ^ Enter 
The root is -1 



Enter a, b, c: 1 2 3 |^ Enter 
The equation has no real roots 



3.2 (Checking whether a number is even) Write a program that reads an integer and 
checks whether it is even. Here are the sample runs of this program: 



Enter an integer: 
Is 25 an even number? false 



Enter an integer: 2000 ^Enter 
Is 2000 an even number? true 
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Sections 3.3-3.8 

3.3* (Algebra: solving 2X2 linear equations) You can use Cramer's rule to solve the 
following 2X2 system of linear equation: 

ax + by = e ed — bf af — ec 

x = — y = — 

cx + dy = f ad — be ad — be 

Write a program that prompts the user to enter a, b, c, d, e, and f and display the 
result. If ad — be is 0, report that "The equation has no solution". 



Enter a, b, c, d, e, f: 9.0 4.0 3.0 -5.0 -6.0 -21.0 -Enter 
x is -2.0 and y is 3.0 




Enter a, b, c, d, e, f: 1.0 2.0 2.0 4.0 4.0 5.0 
The equation has no solution 



3.4** (Game: learning addition) Write a program that generates two integers under 100 and 
prompts the user to enter the sum of these two integers. The program then reports true 
if the answer is correct, false otherwise. The program is similar to Listing 3.1. 

3.5** (Game: addition for three numbers) The program in Listing 3.1 generates two 
integers and prompts the user to enter the sum of these two integers. Revise the 
program to generate three single-digit integers and prompt the user to enter the 
sum of these three integers. 

3.6* (Health application: BMP) Revise Listing 3.5, ComputeBMI.java, to let the user 
enter weight, feet, and inches. For example, if a person is 5 feet and 10 inches, you 
will enter 5 for feet and 10 for inches. 

3.7 (Financial application: monetary units) Modify Listing 2.10, ComputeChange.java, 
to display the nonzero denominations only, using singular words for single units 
such as 1 dollar and 1 penny, and plural words for more than one unit such as 2 dol- 
lars and 3 pennies. (Use input 23 . 67 to test your program.) Video Note 

3.8* (Sorting three integers) Write a program that sorts three integers. The integers are Sort three integers 
entered from the input dialogs and stored in variables numl, num2, and num3, 
respectively. The program sorts the numbers so that numl < numl < numl. 

3.9 (Business: checking ISBN) An ISBN (International Standard Book Number) con- 
sists of 10 digits d^djd^d \{d $d fad ~jd%dgd \o . The last digit c/ 10 is a checksum, which 
is calculated from the other nine digits using the following formula: 

(di X 1 + d 2 X 2 + d-i X 3 + d 4 X 4 + d 5 X 5 + 
d 6 X 6 + d 7 X 7 + d% X 8 + d 9 X 9) % 11 



If the checksum is 10, the last digit is denoted X according to the ISBN convention. 
Write a program that prompts the user to enter the first 9 digits and displays the 10- 
digit ISBN (including leading zeros). Your program should read the input as an inte- 
ger. For example, if you enter 013601267, the program should display 0136012671. 

3.10* (Game: addition quiz) Listing 3.4, SubtractionQuiz.java, randomly generates a 
subtraction question. Revise the program to randomly generate an addition ques- 
tion with two integers less than 100. 
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Sections 3.9-3.19 

3.11* (Finding the number of days in a month) Write a program that prompts the user 
to enter the month and year and displays the number of days in the month. For 
example, if the user entered month 2 and year 2000, the program should display 
that February 2000 has 29 days. If the user entered month 3 and year 2005, the 
program should display that March 2005 has 3 1 days. 

3.12 (Checking a number) Write a program that prompts the user to enter an integer 
and checks whether the number is divisible by both 5 and 6, or neither of them, 
or just one of them. Here are some sample runs for inputs 10, 30, and 23. 

10 is divisible by 5 or 6, but not both 

30 is divisible by both 5 and 6 

23 is not divisible by either 5 or 6 

3.13 (Financial application: computing taxes) Listing 3.6, ComputeTax.java, gives 
the source code to compute taxes for single filers. Complete Listing 3.6 to give 
the complete source code. 

3.14 (Game: head or tail) Write a program that lets the user guess the head or tail of 
a coin. The program randomly generates an integer or 1, which represents 
head or tail. The program prompts the user to enter a guess and reports whether 
the guess is correct or incorrect. 

3.15* (Game: lottery) Revise Listing 3.9, Lottery.java, to generate a lottery of a three- 
digit number. The program prompts the user to enter a three-digit number and 
determines whether the user wins according to the following rule: 

1. If the user input matches the lottery in exact order, the award is $10,000. 

2. If all the digits in the user input match all the digits in the lottery, the award is 
$3,000. 

3. If one digit in the user input matches a digit in the lottery, the award is 
$1,000. 

3.16 (Random character) Write a program that displays a random uppercase letter 
using the Math . random () method. 

3.17* (Game: scissor, rock, paper) Write a program that plays the popular scissor- 
rock-paper game. (A scissor can cut a paper, a rock can knock a scissor, and a 
paper can wrap a rock.) The program randomly generates a number 0, 1, or 2 
representing scissor, rock, and paper. The program prompts the user to enter a 
number 0, 1, or 2 and displays a message indicating whether the user or the 
computer wins, loses, or draws. Here are sample runs: 



scissor (0), rock (1), paper (2): 1 |^ Enter 

The computer is scissor. You are rock. You won 



scissor (0), rock (1), paper (2): 2 |^ Enter 

The computer is paper. You are paper too. It is a draw 



3.18* (Using the input dialog box) Rewrite Listing 3.8, LeapYear.java, using the input 
dialog box. 

3.19 (Validating triangles) Write a program that reads three edges for a triangle and 
determines whether the input is valid. The input is valid if the sum of any two 
edges is greater than the third edge. Here are the sample runs of this program: 
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Enter three edges: 12.51 |- Enter 

Can edges 1, 2.5, and 1 form a triangle? false 



Enter three edges: 2.5 2 1 -Enter 

Can edges 2.5, 2, and 1 form a triangle? true 



3.20* (Science: wind-chill temperature) Exercise 2.17 gives a formula to compute the 
wind-chill temperature. The formula is valid for temperature in the range between 
— 58°F and 41°F and wind speed greater than or equal to 2. Write a program that 
prompts the user to enter a temperature and a wind speed. The program displays 
the wind-chill temperature if the input is valid, otherwise displays a message indi- 
cating whether the temperature and/or wind speed is invalid. 

Comprehensives 

3.2 1 ** (Science: day of the week) Zeller's congruence is an algorithm developed by 
Christian Zeller to calculate the day of the week. The formula is 



q + 



26(m + 1) 
10 



+ k + 



+ 



+ 5j % 7 



where 



h is the day of the week (0: Saturday, 1: Sunday, 2: Monday, 3: Tuesday, 4: 
Wednesday, 5: Thursday, 6: Friday), 
q is the day of the month. 

m is the month (3: March, 4: April, . . . , 12: December). January and February 
are counted as months 13 and 14 of the previous year. 
year 



j is the century (i.e., 



100 



■ k is the year of the century (i.e., year % 1). 

Write a program that prompts the user to enter a year, month, and day of the 
month, and displays the name of the day of the week. Here are some sample runs: 



2002 



Enter year: (e.g., 2008): 
Enter month: 1-12: 3 |- Enter 

Enter the day of the month: 1-31: 
Day of the week is Tuesday 



Enter year: (e.g., 2008): 2011 -Enter 
Enter month: 1-12: 5 |- Enter 

Enter the day of the month: 1-31: 2 
Day of the week is Thursday 



(Hint: [n\ = (int)n for a positive n. January and February are counted as 13 and 
14 in the formula. So you need to convert the user input 1 to 13 and 2 to 14 for 
the month and change the year to the previous year.) 
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3.22** (Geometry: point in a circle?) Write a program that prompts the user to enter a 
point (x, y) and checks whether the point is within the circle centered at (0, 0) 
with radius 10. For example, (4, 5) is inside the circle and (9, 9) is outside the cir- 
cle, as shown in Figure 3.7(a). 

(Hint: A point is in the circle if its distance to (0, 0) is less than or equal to 10. The 

formula for computing the distance is V / (x 2 — xj) 2 + (y 2 — yi) 2 -) Two sample 
runs are shown below.) 



_y-axis t 


(9,9) 

(4,5)\ 


y-axis i 




(6,4) 

• 






.(2,2) 




(0, 0) / x-axis 




(0,0) 


x-axis 













(a) (b) 

Figure 3.7 (a) Points inside and outside of the circle; (b) Points inside and outside of the 
rectangle. 



Enter a point with two coordinates: 4 5 
Point (4.0, 5.0) is in the circle 


Enter 




Enter a point with two coordinates: 9 9 
Point (9.0, 9.0) is not in the circle 


p Enter 



3.23** (Geometry: point in a rectangle?) Write a program that prompts the user to enter a 
point (x , y) and checks whether the point is within the rectangle centered at (0, 0) 
with width 10 and height 5. For example, (2, 2) is inside the rectangle and (6, 4) is 
outside the circle, as shown in Figure 3.7(b). 

(Hint: A point is in the rectangle if its horizontal distance to (0, 0) is less than or 
equal to 10 / 2 and its vertical distance to (0, 0) is less than or equal to 5 / 2.] Here 
are two sample runs. Two sample runs are shown below.) 



Enter a point with two coordinates: 2 2 
Point (2.0, 2.0) is in the rectangle 



Enter a point with two coordinates: 6 4 ^Enter 
Point (6.0, 4.0) is not in the rectangle 



3.24** (Game: picking a card) Write a program that simulates picking a card from a 
deck of 52 cards. Your program should display the rank (Ace, 2, 3, 4, 5, 6, 7, 8, 
9, 10, Jack, Queen, King) and suit (Clubs, Diamonds, Hearts, Spades) of 
the card. Here is a sample run of the program: 
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The card you picked is Jack of Hearts 




3.25** (Computing the perimeter of a triangle) Write a program that reads three edges 
for a triangle and computes the perimeter if the input is valid. Otherwise, display 
that the input is invalid. The input is valid if the sum of any two edges is greater 
than the third edge. 

3.26 (Using the &&, | | and A operators) Write a program that prompts the user to enter 
an integer and determines whether it is divisible by 5 and 6, whether it is divisible 
by 5 or 6, and whether it is divisible by 5 or 6, but not both. Here is a sample run 
of this program: 



Enter 


an integer: 10 


—J Enter 


Is 10 


divisible by 5 


and 6? false 


Is 10 


divisible by 5 


or 6? true 


Is 10 


divisible by 5 


or 6, but not both? true 



3.27** (Geometry: points in triangle?) Suppose a right triangle is placed in a plane as 
shown below. The right-angle point is placed at (0, 0), and the other two points 
are placed at (200, 0), and (0, 100). Write a program that prompts the user to enter 
a point with x- and y-coordinates and determines whether the point is inside the 
triangle. Here are the sample runs: 




(200, 0) 



Enter a point's x- and y-coordinates: 100.5 25.5 
The point is in the triangle 


-J Enter 






Enter a point's x- and y-coordinates: 100.5 50.5 
The point is not in the triangle 


• — ' Enter 




3.28** (Geometry: two rectangles) Write a program that prompts the 


user 


to enter the 



center x-, y-coordinates, width, and height of two rectangles and determines 
whether the second rectangle is inside the first or overlaps with the first, as shown 
in Figure 3.8. 



H'l 







w2 




hi 


hi 


m 


'(xl,yl) 






(xl,yl) 













hi 



wl 



>(xl,yl) 



1,2 



w2 



i(x2, y2) 



(a) (b) 
Figure 3.8 (a) A rectangle is inside another one. (b) A rectangle overlaps another one. 
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Here are the sample runs: 



Enter 


rl's center x-, 


y-coordi nates , 


wi dth , 


and 


hei ght : 


2.5 


4 2.5 43 |^ Enter | 


Enter 


r2's center x- , 


y-coordi nates , 


wi dth , 


and 


hei ght : 


1.5 


5 0.5 3 pnTeT] 










r2 is 


inside rl 











Enter rl's center x-, 


y-coordi nates , 


wi dth , 


and 


hei ght : 


1 2 3 5.5 -J Enter 










Enter r2's center x-, 


y-coordi nates , 


wi dth , 


and 


hei ght : 


3 4 4.5 5 PnTeT 










r2 overlaps rl 











Enter rl's center x-, y-coordi nates , 


wi dth , 


and 


hei ght : 


1 2 3 3 J Enter 








Enter r2's center x-, y-coordi nates , 


wi dth , 


and 


hei ght : 


40 45 3 2 f^T\ 








r2 does not overlap rl 



3.29** (Geometry: two circles) Write a program that prompts the user to enter the center 
coordinates and radii of two circles and determines whether the second circle is 
inside the first or overlaps with the first, as shown in Figure 3.9. 

(Hint: circle2 is inside circle 1 if the distance between the two centers < = | rl - r2 | 
and circle2 overlaps circle 1 if the distance between the two centers <= rl + r2.) 




(a) (b) 
Figure 3.9 (a) A circle is inside another circle, (b) A circle overlaps another circle. 



Here are the sample runs: 



Enter circlel's center x-, 


y- 


coordi nates , 


and 


radi us : 


0.5 5.1 13 p^eT] 










Enter circle2's center x-, 


y- 


coordi nates , 


and 


radi us : 


1 1.7 4.5 |^ Enter 










circle2 is inside circlel 
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Enter circlel's center x-, 


y-coordi nates , 


and 


radi us : 


3.4 5.7 5.5 |^ Enter 








Enter circle2's center x-, 


y-coordi nates , 


and 


radi us : 


6.7 3.5 3 ° ' Enter 








circle2 overlaps circlel 









Enter circlel's center x- 


, y-coordi nates , 


and 


radi us : 


3.4 5.5 1 








Enter circle2's center x- 


, y-coordi nates , 


and 


radi us : 


5.5 7.2 1 pTT] 


ci rcl el 






circle2 does not overlap 
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Chapter 



4 



Loops 



Objectives 



To write programs for executing statements repeatedly using a whi 1 e loop (§4.2). 

To develop a program for GuessNumber (§4.2.1). 

To follow the loop design strategy to develop loops (§4.2.2). 

To develop a program for SubtractionQuizLoop (§4.2.3). 

To control a loop with a sentinel value (§4.2.4). 

To obtain large input from a file using input redirection 
rather than typing from the keyboard (§4.2.4). 

To write loops using do-while statements (§4.3). 

To write loops using for statements (§4.4). 

To discover the similarities and differences of three 
types of loop statements (§4.5). 

To write nested loops (§4.6). 

To learn the techniques for minimizing numerical errors (§4.7). 

To learn loops from a variety of examples (GCD, 
FutureTuition, MonteCarloSimulation) (§4.8). 

To implement program control with break 
and continue (§4.9). 

(GUI) To control a loop with a confirmation 
dialog (§4.10). 
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4.1 Introduction 

Suppose that you need to print a string (e.g., "Welcome to Java!") a hundred times. It 
would be tedious to have to write the following statement a hundred times: 

r System. out. print! n ("Wei come to Java!"); 
100 times J System . out . pri ntl n ("Wei come to Java!"); 

L System. out. pri ntl n ("Wei come to Java!"); 



problem So, how do you solve this problem? 

why loop? Java provides a powerful construct called a loop that controls how many times an operation 

or a sequence of operations is performed in succession. Using a loop statement, you simply 
tell the computer to print a string a hundred times without having to code the print statement 
a hundred times, as follows: 



int count = 0; 

while (count < 100) { 

System. out. pri ntl n ("Wei come to Java!"); 

count++; 

} 



The variable count is initially 0. The loop checks whether (count < 100) is true. If so, it 
executes the loop body to print the message "Wei come to Java ! " and increments count by 
1. It repeatedly executes the loop body until (count < 100) becomes f al se. When (count < 
100) is f al se (i.e., when count reaches 100), the loop terminates and the next statement 
after the loop statement is executed. 

Loops are constructs that control repeated executions of a block of statements. The concept 
of looping is fundamental to programming. Java provides three types of loop statements: 
while loops, do-while loops, and for loops. 



4.2 The while Loop 

The syntax for the whil e loop is as follows: 

whileloop while (loop-continuation-condition) { 

// Loop body 
Statement(s) ; 

} 

Figure 4. 1(a) shows the whi 1 e-loop flow chart. The part of the loop that contains the statements 
loop body to be repeated is called the loop body. A one-time execution of a loop body is referred to as an 

iteration iteration of the loop. Each loop contains a loop-continuation-condition, a Boolean expression that 

controls the execution of the body. It is evaluated each time to determine if the loop body is exe- 
cuted. If its evaluation is true, the loop body is executed; if its evaluation is fal se, the entire 
loop terminates and the program control turns to the statement that follows the whi 1 e loop. 

The loop for printing Wei come to Java ! a hundred times introduced in the preceding 
section is an example of a while loop. Its flow chart is shown in Figure 4.1(b). The 
loop-continuation-condition is (count < 100) and loop body contains two state- 
ments as shown below: ^ loop-continuation-condition 

int count = 0; 
while (count < 100) { 

System. out. pri ntl n ("Wei come to Java!"); V l°°pbody 

count++; J 

} 
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(a) 




false 



count = 0;| 
1 

^(count < 100) 

true 



System, out. pn'ntln ("Wei come to Java!"); 

count++; 



f 

(b) 



Figure 4-1 The whi 1 e loop repeatedly executes the statements in the loop body when the 
loop-continuation-condition evaluates to true. 



In this example, you know exactly how many times the loop body needs to be executed. So a 
control variable count is used to count the number of executions. This type of loop is known 

as a counter-controlled loop. counter-controlled loop 

HH Note 

The loop-continuation-condition must always appear inside the parentheses. The 
braces enclosing the loop body can be omitted only if the loop body contains one or no 
statement. 

Here is another example to help understand how a loop works. 

int sum =0, i = 1; 
while (i < 10) { 

sum = sum + i ; 

i++; 

} 

System. out. println ("sum is " + sum); // sum is 45 

If i < 10 is true, the program adds i to sum. Variable i is initially set to 1, then incremented 
to 2, 3, and up to 10. When i is 10, i < 10 is f al se, the loop exits. So, the sum is 1 + 2 + 3 
+ ... + 9 = 45. 

What happens if the loop is mistakenly written as follows: 

int sum =0, i = 1; 
while (i < 10) { 

sum = sum + i ; 

} 

This loop is infinite, because i is always 1 and i < 10 will always be true, 
tjjl Caution 

Make sure that the loop-continuation-condition eventually becomes false so that 
the program will terminate. A common programming error involves infinite loops. That is, the 
program cannot terminate because of a mistake in the loop-continuation-condition. 

Programmers often make mistakes to execute a loop one more or less time. This is commonly 
known as the off-by-one error. For example, the following loop displays Welcome to Java 101 
times rather than 100 times. The error lies in the condition, which should be count < 100 rather 
than count <= 100. 



infinite loop 



off-by-one error 



int count = 0; 

while (count <= 100) { 

System. out. print! n ("Wei come to Java!"); 

count++; 

} 

4.2.1 Problem: Guessing Numbers 

The problem is to guess what a number a computer has in mind. You will write a program that 
randomly generates an integer between and 100, inclusive. The program prompts the user to 
enter a number continuously until the number matches the randomly generated number. For 
each user input, the program tells the user whether the input is too low or too high, so the user 
can make the next guess intelligently. Here is a sample run: 



Guess a magic number between and 100 


Enter your 


guess : 


50 


h — ' Enter 


Your guess 


i s too 


hi gh 


Enter your 


guess : 


25 


-< Enter 


Your guess 


i s too 


hi gh 


Enter your 


guess : 


12 


-i Enter 


Your guess 


i s too 


high 


Enter your 


guess : 


6 


- 1 Enter 


Your guess 


i s too 


1 ow 




Enter your 


guess : 


9 


Enter 


Yes, the number is 


9 





The magic number is between and 100. To minimize the number of guesses, enter 50 first. 
If your guess is too high, the magic number is between and 49. If your guess is too low, the 
magic number is between 51 and 100. So, you can eliminate half of the numbers from further 
consideration after one guess. 

How do you write this program? Do you immediately begin coding? No. It is important to 
think before coding. Think how you would solve the problem without writing a program. You 
need first to generate a random number between and 100, inclusive, then to prompt the user 
to enter a guess, and then to compare the guess with the random number. 

It is a good practice to code incrementally one step at a time. For programs involving loops, 
if you don't know how to write a loop right away, you may first write the code for executing 
the loop one time, and then figure out how to repeatedly execute the code in a loop. For this 
program, you may create an initial draft, as shown in Listing 4.1: 

Listing 4.1 GuessNumberOneTime . java 

1 import java. util .Scanner; 

2 

3 public class GuessNumberOneTime { 

4 public static void main(String[] args) { 

5 // Generate a random number to be guessed 

6 int number = (int) (Math . random() * 101); 
7 

8 Scanner input = new Scanner(System . i n) ; 

9 System. out. println ("Guess a magic number between and 100"); 
10 

11 // Prompt the user to guess the number 

12 System . out . pri nt("\nEnter your guess: ") ; 

13 int guess = i nput . nextlnt () ; 
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14 

15 if (guess == number) 

16 System. out. println("Yes, the number is " + number); 

17 else if (guess > number) 

18 System. out. pri nt~l n("Your guess is too high"); 

19 else 

20 System. out . pri ntl n("Your guess is too low"); 

21 } 

22 } 

When you run this program, it prompts the user to enter a guess only once. To let the user 
enter a guess repeatedly, you may put the code in lines 1 1-20 in a loop as follows: 

while (true) { 

// Prompt the user to guess the number 
System. out. pri nt("\nEnter your guess: ") ; 
guess = i nput . nextlnt() ; 

if (guess == number) 

System . out . pri ntl n("Yes , the number is " + number); 
else if (guess > number) 

System . out . pri ntl n("Your guess is too high"); 
el se 

System . out . pri ntl n("Your guess is too low"); 

} // End of loop 

This loop repeatedly prompts the user to enter a guess. However, this loop is not correct, 
because it never terminates. When guess matches number, the loop should end. So, the loop 
can be revised as follows: 

while (guess != number) { 

// Prompt the user to guess the number 
System. out. pri nt("\nEnter your guess: ") ; 
guess = i nput . nextlnt() ; 

if (guess == number) 

System . out . pri ntl n("Yes , the number is " + number); 
else if (guess > number) 

System . out . pri ntl n("Your guess is too high"); 
else 

System . out . pri ntl n("Your guess is too low"); 

} // End of loop 

The complete code is given in Listing 4.2. 

Listing 4.2 GuessNumber. java 

1 import java. util .Scanner; 
2 

3 public class GuessNumber { 

4 public static void main(String[] args) { 

5 // Generate a random number to be guessed 

6 int number = (int) (Math . random() * 101); generate a number 
7 

8 Scanner input = new Scanner(System . i n) ; 

9 System. out. pri ntl n ("Guess a magic number between and 100"); 
10 

11 int guess = -1; 

12 while (guess != number) { 



correct guess? 
too high? 
too low? 
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enter a guess 



too high? 
too low? 



13 
14 
15 
16 
17 
18 
19 
20 
21 
22 
23 
24 

25 } 



// Prompt the user to guess the number 
System. out. pri nt("\nEnter your guess: ") ; 
guess = i nput . nextlnt() ; 

if (guess == number) 

System. out. println("Yes, the number is " + number); 
else if (guess > number) 

System. out. pri ntl n ("Your guess is too high"); 
el se 

System. out. pri ntl n("Your guess is too low"); 

} // End of loop 





line# 


number 


guess 


output 




6 
1 1 


8 


-1 




iteration 1 • 


r 15 

20 




50 


Your guess is too high 


iteration 2 • 


f 15 
. 20 




25 


Your guess is too high 


iteration 3 • 


' 15 

■ 20 




12 


Your guess is too high 


iteration 4 • 


f 15 

. 22 




6 


Your guess is too low 


iteration 5 • 


f 15 
. 20 




9 


Yes, the number is 9 



The program generates the magic number in line 6 and prompts the user to enter a guess con- 
tinuously in a loop (lines 12-23). For each guess, the program checks whether the guess is 
correct, too high, or too low (lines 17-22). When the guess is correct, the program exits the 
loop (line 12). Note that guess is initialized to -1. Initializing it to a value between and 100 
would be wrong, because that could be the number to be guessed. 

4.2.2 Loop Design Strategies 

Writing a correct loop is not an easy task for novice programmers. Consider three steps when 
writing a loop. 

Step 1 : Identify the statements that need to be repeated. 

Step 2: Wrap these statements in a loop like this: 

while (true) { 

Statements ; 

} 

Step 3: Code the loop-continuation-condition and add appropriate statements for control- 
ling the loop. 
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while (loop-continuation-condition) { 
Statements ; 

Additional statements for controlling the loop; 

} 



4.2.3 Problem: An Advanced Math Learning Tool 

The Math subtraction learning tool program in Listing 3.4, SubtractionQuiz.java, generates 
just one question for each run. You can use a loop to generate questions repeatedly. How do 
you write the code to generate five questions? Follow the loop design strategy. First identify 
the statements that need to be repeated. These are the statements for obtaining two random 
numbers, prompting the user with a subtraction question, and grading the question. Second, 
wrap the statements in a loop. Third, add a loop control variable and the loop-continuation- 
condition to execute the loop five times. 

Listing 4.3 gives a program that generates five questions and, after a student answers all 
five, reports the number of correct answers. The program also displays the time spent on the 
test and lists all the questions. 



Video Note 

Multiple subtraction quiz 



Listing 4.3 Subtract! onQui zLoop . java 

1 import java. util .Scanner; 
2 

3 public class SubtractionQuizLoop { 

4 public static void main(String[] args) { 



5 final int NUMBER_OF_QUESTIONS = 5; // Number of questions 

6 int correctCount = 0; // Count the number of correct answers 

7 int count = 0; // Count the number of questions 

8 long startTime = System. cur rentTimeMill is() ; get start time 

9 String output = ""; // output string is initially empty 
10 Scanner input = new Scanner(System . i n) ; 

11 

12 while (count < NUMBER_0F_QUESTI0NS) { loop 

13 // 1. Generate two random single-digit integers 

14 int numberl = (int) (Math . randomO * 10); 

15 int number2 = (int) (Math . randomO * 10); 
16 

17 // 2 . If numberl < number2, swap numberl with number2 

18 if (numberl < number2) { 

19 int temp = numberl; 

20 numberl = number2; 

21 number2 = temp; 

22 } 
23 

24 // 3 . Prompt the student to answer "What is numberl - number2?" 

2 5 System, out. pri nt( display a question 

26 "What is " + numberl + " - " + number2 + "? "); 

27 int answer = input. nextlnt() ; 
28 

29 // 4. Grade the answer and display the result 

30 if (numberl - number2 == answer) { grade an answer 

31 System . out . pri ntl n ("You are correct!"); 

32 COrrectCount++; increase correct count 

33 } 

34 else 

35 System. out. println("Your answer is wrong. \n" + numberl 

36 + " - " + number2 + " should be " + (numberl - number2)); 
37 
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38 


// Increase t 


he count 


increase control variable 


39 


count++; 






40 






prepare output 


41 


output += "\n 


" + numberl + "-" + number2 + "=" + answer + 




42 


((numberl - 


number2 == answer) ? " correct" : " wrong"); 


end loop 


43 


} 






44 






get end time 


45 


long endTime = 


System . cu r rentTi meMi 1 1 i s () ; 


test time 


46 


long testTime = 


endTime - startTime; 




47 






display result 


48 


System, out. pn'n 


tln("Correct count is " + correctCount + 




49 


"\nTest time 


is " + testTime / 1000 + " seconds\n" + output); 




50 


} 






51 } 







What is 


9 - 2? 7 




You are 


correct ! 




What is 


3 - 0? 3 


J^^nter^ 


You are 


correct ! 




What is 


3 - 2? 1 


-J Enter 


You are 


correct ! 




What is 


7 - 4? 4 


^ Enter 


Your answer is wrong. 


7-4 should be 3 




What is 


7 - 5? 4 


Lj Enter 


Your answer is wrong. 


7 - 5 should be 2 




Correct 


count is 


3 


Test time is 1021 


seconds 


9-2=7 correct 




3-0=3 correct 




3-2=1 correct 




7-4=4 wrong 




7-5=4 wrong 





The program uses the control variable count to control the execution of the loop, count is 
initially (line 7) and is increased by 1 in each iteration (line 39). A subtraction question is 
displayed and processed in each iteration. The program obtains the time before the test starts 
in line 8 and the time after the test ends in line 45, and computes the test time in line 46. The 
test time is in milliseconds and is converted to seconds in line 49. 

4.2.4 Controlling a Loop with a Sentinel Value 

Another common technique for controlling a loop is to designate a special value when read- 
sentinel value ing and processing a set of values. This special input value, known as a sentinel value, signi- 
fies the end of the loop. A loop that uses a sentinel value to control its execution is called a 
sentinel-controlled loop. 

Listing 4.4 writes a program that reads and calculates the sum of an unspecified number of 
integers. The input signifies the end of the input. Do you need to declare a new variable for 
each input value? No. Just use one variable named data (line 12) to store the input value and 
use a variable named sum (line 15) to store the total. Whenever a value is read, assign it to 
data and, if it is not zero, add it to sum (line 17). 



4.2 The while Loop 123 



Listing 4-4 Sentinel Value, java 

1 import java. util .Scanner; 
2 

3 public class Senti nel Val ue { 

4 /** Main method */ 

5 public static void main(String[] args) { 

6 // Create a Scanner 

7 Scanner input = new Scanner(System.in) ; 
8 

9 // Read an initial data 

10 System. out. print( 

11 "Enter an int value (the program exits if the input is 0): ") ; 

12 int data = i nput . nextlntO ; input 
13 

14 // Keep reading data until the input is 

15 int sum = 0; 

16 while (data != 0) { loop 



17 sum += data; 

18 

19 // Read the next data 

20 System. out. print( 

21 "Enter an int value (the program exits if the input is 0): ") ; 

22 data = input. nextlntO ; 

23 } end of loop 
24 



25 System. out. println("The sum is " + sum); display result 

26 } 

27 } 



Enter an int value (the program exits if the input is 0) 

Enter an int value (the program exits if the input is 0) 

Enter an int value (the program exits if the input is 0) 

Enter an int value (the program exits if the input is 0) 
The sum is 9 



2 |^ Enter 

3 | Enter J 

4 |- Enter 
^ Enter 





line# 


data 


sum output 




12 


2 






15 









f 17 




2 


iteration 1 • 










22 


3 






f 17 




5 


iteration 2 • 










. 22 


4 






f 17 




9 


iteration 3 • 










22 









25 




The sum is 9 



If data is not 0, it is added to sum (line 17) and the next item of input data is read (lines 
20-22). If data is 0, the loop body is no longer executed and the whil e loop terminates. The 
input value is the sentinel value for this loop. Note that if the first input read is 0, the loop 
body never executes, and the resulting sum is 0. 
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Caution 

Don't use floating-point values for equality checking in a loop control. Since floating-point values 
are approximations for some values, using them could result in imprecise counter values and inac- 
curate results. 

Consider the following code for computing 1 + 0.9 + 0.8 + ... + 0.1: 
double item = 1; double sum = 0; 

while (item != 0) { // No guarantee item will be 
sum += item; 
item -= 0.1; 

} 

System. out. println(sum) ; 

Variable item starts with 1 and is reduced by 0. 1 every time the loop body is executed. The 
loop should terminate when item becomes 0. However, there is no guarantee that item will be 
exactly 0, because the floating-point arithmetic is approximated. This loop seems OK on the sur- 
face, but it is actually an infinite loop. 

4.2.5 Input and Output Redirections 

In the preceding example, if you have a large number of data to enter, it would be cumber- 
some to type from the keyboard. You may store the data separated by whitespaces in a text 
file, say input.txt, and run the program using the following command: 

java Sentinel Val ue < input.txt 

input redirection This command is called input redirection. The program takes the input from the file 

input.txt rather than having the user to type the data from the keyboard at runtime. Suppose 
the contents of the file are 

2 3 4 5 6 7 8 9 12 23 32 

23 45 67 89 92 12 34 35 3 1 2 4 

The program should get sum to be 518. 
output redirection Similarly, there is output redirection, which sends the output to a file rather than displaying 

it on the console. The command for output redirection is: 

java ClassName > output.txt 

Input and output redirection can be used in the same command. For example, the following 
command gets input from input.txt and sends output to output.txt: 

java Sentinel Val ue < input.txt > output.txt 

Please run the program and see what contents are in output.txt. 

4.3 The do-while Loop 

The do-whil e loop is a variation of the whil e loop. Its syntax is given below: 

do-while loop do { 

// Loop body; 
Statement(s) ; 
} while (loop-continuation-condition); 

Its execution flow chart is shown in Figure 4.2. 




numeric error 
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Statement(s) 
(loop body) 

T 




Figure 4-2 The do-whi 1 e loop executes the loop body first, then checks the 1 oop- 
continuation-condition to determine whether to continue or terminate the loop. 

The loop body is executed first. Then the loop-continuation-condition is evalu- 
ated. If the evaluation is true, the loop body is executed again; if it is fal se, the do-whi 1 e 
loop terminates. The difference between a while loop and a do-while loop is the order in 
which the loop-continuation-condition is evaluated and the loop body executed. The 
while loop and the do-while loop have equal expressive power. Sometimes one is a more 
convenient choice than the other. For example, you can rewrite the whi 1 e loop in Listing 4.4 
using a do-whi 1 e loop, as shown in Listing 4.5: 

Listing 4-5 TestDoWhile. java 

1 import java. util .Scanner; 

2 

3 public class TestDoWhile { 



4 /** Main method */ 

5 public static void main(String[] args) { 

6 int data; 

7 int sum = 0; 

8 

9 // Create a Scanner 

10 Scanner input = new Scanner(System.in) ; 
11 

12 // Keep reading data until the input is 

13 do { loop 

14 // Read the next data 

15 System. out. print( 

16 "Enter an int value (the program exits if the input is 0): ") ; 

17 data = input. nextlntO ; 
18 

19 sum += data; 

20 } while (data != 0); endloop 
21 

22 System. out. println("The sum is " + sum); 

23 } 



24 } 



Enter an 


int 


val ue 


(the 


program 


exi ts 


if 


the 


i nput 


i s 


0): 


3 


-i Enter 




Enter an 


int 


val ue 


(the 


program 


exi ts 


if 


the 


i nput 


i s 


0): 


5 


Enter 




Enter an 


int 


val ue 


(the 


program 


exi ts 


if 


the 


i nput 


i s 


0): 


6 


Enter 




Enter an 


int 


val ue 


(the 


program 


exi ts 


if 


the 


i nput 


i s 


0): 





j^^nter"" 




The sum 


is 14 
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il Tip 



Use the do-while loop if you have statements inside the loop that must be executed at least 
once, as in the case of the do-while loop in the preceding TestDoWhile program. These 
statements must appear before the loop as well as inside it if you use a while loop. 



for loop 



4-4 The for Loop 

Often you write a loop in the following common form: 

i = initial Value; // Initialize loop control variable 
while (i < endValue) { 

// Loop body 

i++; // Adjust loop control variable 

} 

A for loop can be used to simplify the proceding loop: 

for (i = initial Value; i < endValue; i++) { 

// Loop body 

} 

In general, the syntax of a for loop is as shown below: 

for (i ni ti al -acti on ; loop-continuation-condition; 
action-after-each-iteration) { 

// Loop body; 
Statement(s) ; 

} 

The flow chart of the for loop is shown in Figure 4.3(a). 

1 

Initial-ActionJ 



I 



I 



loop- 
continuation 
condition? 



true 

Statement(s) 
(loop body) 



action-after-each-iteration 



false 



(a) 



(i < 100)? 



true 



false 



System. out. println( 
"Welcome to Java"); 



f 

(b) 



Figure 4-3 A for loop performs an initial action once, then repeatedly executes the 
statements in the loop body, and performs an action after an iteration when the 1 oop- 
continuation-condition evaluates to true. 
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The for loop statement starts with the keyword for, followed by a pair of parentheses 
enclosing the control structure of the loop. This structure consists of initial -action, 
loop-continuation-condition, and action-after-each-iteration. The control 
structure is followed by the loop body enclosed inside braces. The i ni tial -action, 1 oop- 
continuation-condition, and action-after-each-iteration are separated by 
semicolons. 

A for loop generally uses a variable to control how many times the loop body is executed 
and when the loop terminates. This variable is referred to as a control variable. The i ni ti al - 
action often initializes a control variable, the action-after-each-iteration usually 
increments or decrements the control variable, and the loop-continuation-condition 
tests whether the control variable has reached a termination value. For example, the following 
for loop prints Welcome to Java ! a hundred times: 



control variable 



int i ; 

for (i =0; i < 100; { 

System. out. println ("Wei come to Java!"); 

} 



initial-action 



The flow chart of the statement is shown in Figure 4.3(b). The for loop initializes i to 0, then 
repeatedly executes the println statement and evaluates i++ while i is less than 100. 

The initial -action, i = 0, initializes the control variable, i. The loop- 
continuation-condition, i < 100, is a Boolean expression. The expression is evaluated 
right after the initialization and at the beginning of each iteration. If this condition is true, 
the loop body is executed. If it is f al se, the loop terminates and the program control turns to 
the line following the loop. 

The action-after-each-iteration, i++, is a statement that adjusts the control vari- 
able. This statement is executed after each iteration. It increments the control variable. Even- 
tually, the value of the control variable should force the loop-continuation-condition 
to become f al se. Otherwise the loop is infinite. 

The loop control variable can be declared and initialized in the for loop. Here is an example: 

for (int i = 0; i < 100; i++) { 

System. out. println ("Wei come to Java!"); 

} 

If there is only one statement in the loop body, as in this example, the braces can be omitted. omitting braces 



act ion -after-each- 
iteration 



Tip 

The control variable must be declared inside the control structure of the loop or before the loop. If 
the loop control variable is used only in the loop, and not elsewhere, it is good programming prac- 
tice to declare it in the initial -action of the for loop. If the variable is declared inside the 
loop control structure, it cannot be referenced outside the loop. In the preceding code, for exam- 
ple, you cannot reference i outside the for loop, because it is declared inside the for loop. 



declare control variable 



Note 

The initial -action in a for loop can be a list of zero or more comma-separated variable 
declaration statements or assignment expressions. For example, 



for (int i =0, j 

// Do something 

} 







(i + j < 10) ; i++, j++) { 



for loop variations 



The action-after-each-iteration in a for loop can be a list of zero or more comma- 
separated statements. For example, 



for (int i = 1; i < 100; System. out. println(i) , i++); 
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This example is correct, but it is a bad example, because it makes the code difficult to read. Nor- 
mally, you declare and initialize a control variable as an initial action and increment or decrement 
the control variable as an action after each iteration. 

|B| Note 

If the loop-continuation-condition in a for loop is omitted, it is implicitly true. Thus 
the statement given below in (a), which is an infinite loop, is the same as in (b). To avoid confu- 
sion, though, it is better to use the equivalent loop in (c): 



for ( ; ; ) { 

// Do something 
} 

(a) 



Equivalent 



for ( ; true; ) { 

// Do something 

} 



Equivalent 



(b) 



This is better 



while (true) { 

// Do something 

} 



(c) 



pretest loop 
posttest loop 



4.5 Which Loop to Use? 



The while loop and for loop are called pretest loops because the continuation condition is 
checked before the loop body is executed. The do-while loop is called a posttest loop 
because the condition is checked after the loop body is executed. The three forms of loop 
statements, while, do-while, and for, are expressively equivalent; that is, you can write a 
loop in any of these three forms. For example, a whil e loop in (a) in the following figure can 
always be converted into the for loop in (b): 



while (loop-continuation-condi tion) 

// Loop body 

} 



{ 



Equivalent 



(a) 



for ( ; loop-continuation-condition; ) { 

// Loop body 

} 



(b) 



A for loop in (a) in the next figure can generally be converted into the while loop in 
(b) except in certain special cases (see Review Question 4.17 for such a case): 



for (initial-action; 

loop-continuation -condition; 
action-after-each-iteration) { 

// Loop body; 

} 



Equivalent 



initial -action; 

while (loop-continuation-condition) { 

// Loop body; 

action-after-each-iteration; 

} 



(a) 



(b) 



Use the loop statement that is most intuitive and comfortable for you. In general, a for loop 
may be used if the number of repetitions is known in advance, as, for example, when you need to 
print a message a hundred times. A whil e loop may be used if the number of repetitions is not 
fixed, as in the case of reading the numbers until the input is 0. A do-whi 1 e loop can be used to 
replace a whi 1 e loop if the loop body has to be executed before the continuation condition is tested. 



Caution 

Adding a semicolon at the end of the for clause before the loop body is a common mistake, as 
shown below in (a). In (a), the semicolon signifies the end of the loop prematurely. The loop 
body is actually empty, as shown in (b). (a) and (b) are equivalent. 



Error 



r- 



for (int i = 0; i < 10; i++); 

{ 

System. out. println("i is " + i); 

} 



for (int i 

{ 

System. out. println("i is 
} 



Empty Body 

V 



0; i < 10; i++) { }; 

+ i); 



(a) 



(b) 
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Similarly, the loop in (c) is also wrong, (c) is equivalent to (d). 



Error 



int i = 0; j/ 
while (i < 10); 
{ 

System. out. print"! n("i is " + i) 
i++; 

} 



(c) 



Empty Body 



int i = 0; / 
while (i < 10) { }; 

{ 

System. out. println("i is " + i); 
i++; 

} 



(d) 



These errors often occur when you use the next-line block style. Using the end-of-line block style 
can avoid errors of this type. 



In the case of the do-while loop, the semicolon is needed to end the loop. 



int i = 0; 






do { 






System. out 


println("i is 


' + i); 


i++; 






} while (i < 


10);^ 





Correct 



4.6 Nested Loops 

Nested loops consist of an outer loop and one or more inner loops. Each time the outer loop is 
repeated, the inner loops are reentered, and started anew. 

Listing 4.6 presents a program that uses nested for loops to print a multiplication table. 



Listing 4-6 Mul ti pi i cati onTabl e . j ava 

1 public class Mul ti pi i cati onTabl e { 



2 /** Main method */ 

3 public static void main(String[] args) { 

4 // Display the table heading 

5 System. out. println(" Multiplication Table"); table title 
6 

7 // Display the number title 

8 System. out. print(" ") ; 

9 for (int j = 1; j <= 9; j++) 
10 System. out. print(" " + j); 
11 

12 System. out. println("\n ") ; 

13 

14 // Print table body 

15 for (int i = 1; i <= 9; i++) { outer loop 

16 System. out. print(i + " | ") ; 

17 for (int j = 1; j <= 9; j++) { inner loop 

18 // Display the product and align properly 

19 System. out. pri ntf ("%4d" , i * j); 

20 } 

21 System. out. println() 

22 } 

23 } 



24 } 
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Multiplication Table 
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Video Note 

Minimize numeric errors 



The program displays a title (line 5) on the first line in the output. The first for loop (lines 
9-10) displays the numbers 1 through 9 on the second line. A dash (-) line is displayed on the 
third line (line 12). 

The next loop (lines 15-22) is a nested for loop with the control variable i in the outer 
loop and j in the inner loop. For each i , the product i * j is displayed on a line in the inner 
loop, with j being 1, 2, 3, . . . , 9. 

4.7 Minimizing Numeric Errors 

Numeric errors involving floating-point numbers are inevitable. This section discusses how to 
minimize such errors through an example. 

Listing 4.7 presents an example summing a series that starts with 0.01 and ends with 
1 .0. The numbers in the series will increment by . 01, as follows: . 01 + 0.02 + 0.03 
and so on. 



Listing 4-7 TestSum.java 

1 public class TestSum { 

2 public static void main(String[] args) { 

3 // Initialize sum 

4 float sum = 0; 
5 

6 // Add 0.01, 0.02, 0.99, 1 to sum 

loop 7 for (float i = O.Olf; i <= l.Of; i = i + O.Olf) 

8 sum += i ; 
9 

10 // Display result 

11 System. out. println("The sum is " + sum); 

12 } 

13 } 




The sum is 50.499985 



The for loop (lines 7-8) repeatedly adds the control variable i to sum. This variable, which 
begins with 0.01, is incremented by 0.01 after each iteration. The loop terminates when i 
exceeds 1.0. 

The for loop initial action can be any statement, but it is often used to initialize a control 
variable. From this example, you can see that a control variable can be a f 1 oat type. In fact, 
it can be any data type. 
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The exact sum should be 50. 50, but the answer is 50.499985. The result is imprecise 
because computers use a fixed number of bits to represent floating-point numbers, and thus 
they cannot represent some floating-point numbers exactly. If you change f 1 oat in the pro- 
gram to doubl e, as follows, you should see a slight improvement in precision, because a double precision 
doubl e variable takes 64 bits, whereas a f 1 oat variable takes 32. 

// Initialize sum 
double sum = 0; 

// Add 0.01, 0.02, 0.99, 1 to sum 

for (double i =0.01; i <= 1.0; i = i +0.01) 
sum += i ; 

However, you will be stunned to see that the result is actually 49 . 50000000000003. What numeric error 
went wrong? If you print out i for each iteration in the loop, you will see that the last i is 
slightly larger than 1 (not exactly 1). This causes the last i not to be added into sum. The fun- 
damental problem is that the floating-point numbers are represented by approximation. To fix 
the problem, use an integer count to ensure that all the numbers are added to sum. Here is the 
new loop: 

double currentValue = 0.01; 

for (int count = 0; count < 100; count++) { 
sum += currentValue; 
currentValue += 0.01; 

} 

After this loop, sum is 50 . 50000000000003. This loop adds the numbers from small to big. 
What happens if you add numbers from big to small (i.e., 1 . 0, . 99, . 98, . . . , . 02, . 01 
in this order) as follows: 

double currentValue = 1.0; 

for (int count = 0; count < 100; count++) { 
sum += currentValue; 
currentValue -= 0.01; 

} 

After this loop, sum is 50 . 49999999999995. Adding from big to small is less accurate than 
adding from small to big. This phenomenon is an artifact of the finite-precision arithmetic. 
Adding a very small number to a very big number can have no effect if the result requires 
more precision than the variable can store. For example, the inaccurate result of 
100000000 . + . 000000001 is 100000000 . 0. To obtain more accurate results, carefully 
select the order of computation. Adding the smaller numbers before the big numbers is one 
way to minimize error. avoiding numeric error 

4.8 Case Studies 

Loops are fundamental in programming. The ability to write loops is essential in learning Java 
programming. If you can write programs using loops, you know how to program! For this rea- 
son, this section presents three additional examples of solving problems using loops. 

4.8.1 Problem: Finding the Greatest Common Divisor 

The greatest common divisor of two integers 4 and 2 is 2. The greatest common divisor of 
two integers 16 and 24 is 8. How do you find the greatest common divisor? Let the two input 
integers be nl and n2. You know that number 1 is a common divisor, but it may not be the 
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greatest common divisor. So, you can check whether k (for k = 2,3,4, and so on) is a com- 
mon divisor for nl and n2, until k is greater than nl or n2. Store the common divisor in a 
gcd variable named gcd. Initially, gcd is 1. Whenever a new common divisor is found, it becomes 

the new gcd. When you have checked all the possible common divisors from 2 up to nl or n2, 
the value in variable gcd is the greatest common divisor. The idea can be translated into the 
following loop: 

int gcd = 1; // Initial gcd is 1 
int k = 2; // Possible gcd 

while (k <= nl && k <= n2) { 
if (nl % k == && n2 % k == 0) 

gcd = k; // Update gcd 
k++; // Next possible gcd 

} 

// After the loop, gcd is the greatest common divisor for nl and n2 

Listing 4.8 presents the program that prompts the user to enter two positive integers and finds 
their greatest common divisor. 

Listing 4.8 GreatestCommonDi vi sor . j ava 

1 import java.util .Scanner; 

2 

3 public class GreatestCommonDivisor { 

4 /** Main method */ 

5 public static void main(String[] args) { 

6 // Create a Scanner 

7 Scanner input = new Scanner(System.in) ; 
8 

9 // Prompt the user to enter two integers 

10 System . out . pri nt("Enter first integer: ") ; 

11 int nl = input. nextlntO ; 

12 System . out . pri nt("Enter second integer: ") ; 

13 int n2 = input. nextlntO ; 
14 

15 int gcd =1; // Initial gcd is 1 

16 int k = 2; // Possible gcd 

17 while (k <= nl && k <= n2) { 

18 if (nl % k == && n2 % k == 0) 

19 gcd = k; // Update gcd 

20 k++; 

21 } 
22 

23 System. out. println("The greatest common divisor for " + nl + 

24 " and " + n2 + " is " + gcd); 

25 } 

26 } 



input 
input 

gcd 

check divisor 
output 



Enter first integer: 125 h Enter 
Enter second integer: 2525 |^ 

The greatest common divisor for 125 and 2525 is 25 



think before you type 



How did you write this program? Did you immediately begin to write the code? No. It is 
important to think before you type. Thinking enables you to generate a logical solution for the 
problem without concern about how to write the code. Once you have a logical solution, type 
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the code to translate the solution into a Java program. The translation is not unique. For exam- 
ple, you could use a for loop to rewrite the code as follows: 

for (int k = 2; k <= nl && k <= n2; k++) { 
if (nl % k == && n2 % k == 0) 
gcd = k; 

} 

A problem often has multiple solutions. The gcd problem can be solved in many ways. Exer- multiple solutions 
cise 4.15 suggests another solution. A more efficient solution is to use the classic Euclidean 
algorithm. See http://www.cut-the-knot.org/blue/Euclid.shtml for more information. 

You might think that a divisor for a number nl cannot be greater than nl / 2. So you erroneous solutions 
would attempt to improve the program using the following loop: 

for (int k = 2; k <= nl / 2 && k <= n2 / 2 ; k++) { 
if (nl % k == && n2 % k == 0) 
gcd = k; 

} 



This revision is wrong. Can you find the reason? See Review Question 4.14 for the answer. 



4.8.2 Problem: Predicating the Future Tuition 

Suppose that the tuition for a university is $10,000 this year and tuition increases 7% every 
year. In how many years will the tuition be doubled? 

Before you can write a program to solve this problem, first consider how to solve it by 
hand. The tuition for the second year is the tuition for the first year * 1 . 07. The tuition for a 
future year is the tuition of its preceding year * 1.07. So, the tuition for each year can be 
computed as follows: 



double tuition = 10000; 
tuition = tuition * 1.07 
tuition = tuition * 1.07 
tuition = tuition * 1.07 



int year = 1 
year++ ; 
year++; 
year++; 



// Year 1 

// Year 2 

// Year 3 

// Year 4 



Keep computing tuition for a new year until it is at least 20000. By then you will know how 
many years it will take for the tuition to be doubled. You can now translate the logic into the 
following loop: 

double tuition = 10000; // Year 1 

int year = 1; 

while (tuition < 20000) { 

tuition = tuition * 1.07; 

year++ ; 

} 



The complete program is shown in Listing 4.9. 



Listing 4.9 FutureTuition. java 

1 public class FutureTuition { 

2 public static void main(String[] args) { 

3 double tuition = 10000; // Year 1 

4 int year = 1; 

5 while (tuition < 20000) { loop 
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next year's tuition 6 tuition = tuition * 1.07; 

7 year++; 

8 } 
9 

10 System. out. pri ntl n("Tuition will be doubled in " 

11 + year + " years") ; 

12 } 

13 } 




Tuition will be doubled in 12 years 



The whil e loop (lines 5-8) is used to repeatedly compute the tuition for a new year. The loop 
terminates when tuition is greater than or equal to 20000. 



4.8.3 Problem: Problem: Monte Carlo Simulation 

Monte Carlo simulation uses random numbers and probability to solve problems. This 
method has a wide range of applications in computational mathematics, physics, chemistry, 
and finance. This section gives an example of using Monte Carlo simulation for estimating tt. 

To estimate tt using the Monte Carlo method, draw a circle with its bounding square as 
shown below. 





1 












-1 






1 




-1 





generate random points 
check inside circle 

estimate pi 



Assume the radius of the circle is 1. So, the circle area is tt and the square area is 4. Ran- 
domly generate a point in the square. The probability for the point to fall in the circle is 
ci rcl eArea / squareArea = n / 4. 

Write a program that randomly generates 1000000 points in the square and let 
numberOfHits denote the number of points that fall in the circle. So, numberOfHits is 
approximately 1000000 * (ji / 4). tt can be approximated as 4 * numberOfHits / 
1000000. The complete program is shown in Listing 4.10. 

Listing 4- 1 MonteCarl oSi mul ati on . j ava 



i 

2 
3 
4 
5 
6 
7 
8 
9 
10 
11 
12 
13 



public class MonteCarl oSi mul ati on { 

public static void main(String[] args) { 
final int NUMBER_0F_TRIALS = 10000000; 
int numberOfHits = 0; 



0; i 



NUMBER_0F_TRIALS 



i++) { 



for (int 

double x = Math . randomO 
double y = Math . randomO 
if (x * x + y * y <= 1) 
numberOfHi ts++; 

} 



double pi = 4.0 * numberOfHits / NUMBER_0F_TRIALS ; 
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14 System. out. println("PI is " + pi); 

15 } 

16 } 



PI is 3.14124 




The program repeatedly generates a random point (x, y) in the square in lines 7-8: 

double x = Math . random() * 2.0 - 1; 
double y = Math . random() * 2.0 - 1; 

If x 2 + y 2 < 1, the point is inside the circle and numberOfHits is incremented by 1. tt is 
approximately 4 * numberOfHits / NUMBER_OF_TRIALS (line 13). 



4 9 Keywords break and continue 

|fit Pedagogical Note 

Two keywords, break and continue, can be used in loop statements to provide additional 
controls. Using break and continue can simplify programming in some cases. Overusing or 
improperly using them, however, can make programs difficult to read and debug. (Note to instruc- 
tors: You may skip this section without affecting the rest of the book.) 

You have used the keyword break in a swi tch statement. You can also use break in a loop break 
to immediately terminate the loop. Listing 4.11 presents a program to demonstrate the effect 
of using break in a loop. 



Listing 4. 1 1 TestBreak. java 

1 public class TestBreak { 

2 public static void main(String[] args) { 

3 int sum = 0; 

4 int number = 0; 
5 

6 while (number < 20) { 

7 number++; 

8 sum += number; 

9 if (sum >= 100) 

10 f break; break 




11 
12 

13 System. out. pri ntl n("The number is " + number); 

14 System. out. pri ntl n("The sum is " + sum); 

15 } 

16 } 



The number is 14 
The sum is 105 



The program in Listing 4.11 adds integers from 1 to 20 in this order to sum until sum is 
greater than or equal to 100. Without the i f statement (line 9), the program calculates the 
sum of the numbers from 1 to 20. But with the i f statement, the loop terminates when sum 
becomes greater than or equal to 100. Without the i f statement, the output would be: 



The number is 20 
The sum is 210 



You can also use the conti nue keyword in a loop. When it is encountered, it ends the current 
iteration. Program control goes to the end of the loop body. In other words, conti nue breaks 
out of an iteration while the break keyword breaks out of a loop. Listing 4.12 presents a pro- 
gram to demonstrate the effect of using conti nue in a loop. 

Listing 4- 1 2 TestContinue. java 

1 public class TestContinue { 

2 public static void main(String[] args) { 

3 int sum = 0; 

4 int number = 0; 
5 

6 while (number < 20) { 

7 number++; 

8 if (number ==10 | | number == 11) 

9 - — continue; 

10 V^sum += number; 

11 } 
12 

13 System. out. pri ntl n("The sum is " + sum); 

14 } 

15 } 



The sum is 189 



The program in Listing 4.12 adds integers from 1 to 20 except 10 and 11 to sum. With the i f 
statement in the program (line 8), the continue statement is executed when number 
becomes 10 or 11. The continue statement ends the current iteration so that the rest of the 
statement in the loop body is not executed; therefore, number is not added to sum when it is 
10 or 11. Without the i f statement in the program, the output would be as follows: 



The sum is 210 



In this case, all of the numbers are added to sum, even when number is 10 or 11. Therefore, 
the result is 2 10, which is 2 1 more than it was with the i f statement. 

|§| Note 

The continue statement is always inside a loop. In the while and do-while loops, the 
loop-continuation-condition is evaluated immediately after the continue state- 
ment. In the for loop, the action-after-each-iteration is performed, then the 
loop-continuation-condition is evaluated, immediately after the continue 

statement. 

You can always write a program without using break or conti nue in a loop. See Review 
Question 4. 1 8. In general, using break and conti nue is appropriate only if it simplifies cod- 
ing and makes programs easier to read. 

Listing 4.2 gives a program for guessing a number. You can rewrite it using a break state- 
ment, as shown in Listing 4.13. 
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Listing 4.13 CuessNumberUsi ngBreak. java 

1 import java. util .Scanner; 
2 

3 public class GuessNumberUsi ngBreak { 

4 public static void main(String[] args) { 



5 // Generate a random number to be guessed 

6 int number = (int) (Math . randomO * 101); generate a number 
7 

8 Scanner input = new Scanner(System . i n) ; 

9 System. out. println ("Guess a magic number between and 100"); 
10 

11 while (true) { loop continuously 

12 // Prompt the user to guess the number 

13 System. out. print("\nEnter your guess: ") ; enteraguess 

14 int guess = i nput . nextlnt() ; 
15 

16 if (guess == number) { 

17 System . out . pri ntl n("Yes , the number is " + number); 

18 break; break 

19 } 

20 else if (guess > number) 

21 System. out. println("Your guess is too high"); 

22 else 

23 System. out. println("Your guess is too low"); 

24 } // End of loop 



25 } 

26 } 

Using the break statement makes this program simpler and easier to read. However, you 
should use break and continue with caution. Too many break and continue statements 
will produce a loop with many exit points and make the program difficult to read. 

j§ Note 

Some programming languages have a goto statement. The goto statement indiscriminately goto 
transfers control to any statement in the program and executes it. This makes your program vul- 
nerable to errors. The break and continue statements in Java are different from goto state- 
ments. They operate only in a loop or a switch statement. The break statement breaks out of 
the loop, and the continue statement breaks out of the current iteration in the loop. 

4.9.1 Problem: Displaying Prime Numbers 

An integer greater than 1 is prime if its only positive divisor is 1 or itself. For example, 2, 3, 
5, and 7 are prime numbers, but 4, 6, 8, and 9 are not. 

The problem is to display the first 50 prime numbers in five lines, each of which contains 
ten numbers. The problem can be broken into the following tasks: 

■ Determine whether a given number is prime. 

■ For number = 2, 3, 4, 5, 6, . . . , test whether it is prime. 

■ Count the prime numbers. 

■ Print each prime number, and print ten numbers per line. 

Obviously, you need to write a loop and repeatedly test whether a new number is prime. If the 
number is prime, increase the count by 1. The count is initially. When it reaches 50, the 
loop terminates. 
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Here is the algorithm for the problem: 

Set the number of prime numbers to be printed as 

a constant NUMBER_OF_PRIMES ; 
Use count to track the number of prime numbers and 

set an initial count to 0; 
Set an initial number to 2; 

while (count < NUMBER_OF_PRIMES) { 
Test whether number is prime; 

if number is prime { 

Print the prime number and increase the count; 

} 

Increment number by 1; 



j 

To test whether a number is prime, check whether it is divisible by 2, 3, 4, up to number/2. 
If a divisor is found, the number is not a prime. The algorithm can be described as follows: 

Use a boolean variable isPrime to denote whether 
the number is prime; Set isPrime to true initially; 

for (int divisor = 2; divisor <= number / 2; divisor++) { 
if (number % divisor == 0) { 
Set isPrime to false 
Exit the loop; 

} 

} 



The complete program is given in Listing 4. 14. 

Listing 4.14 PrimeNumber. java 



count prime numbers 

check primeness 
exit loop 

print if prime 



1 
2 
3 
4 
5 
6 
7 
8 
9 
10 
11 
12 
13 
14 
15 
16 
17 
18 
19 
20 
21 
22 
23 
24 
25 



public class PrimeNumber { 

public static void main(String[] args) { 

final int NUMBERJDF_PRIMES = 50; // Number of primes to display 
final int NUMBER_OF_PRIMES_PER_LINE = 10; // Display 10 per line 
int count = 0; // Count the number of prime numbers 
int number =2; //A number to be tested for primeness 

System . out . pri ntl n("The first 50 prime numbers are \n") ; 

// Repeatedly find prime numbers 
while (count < NUMBER_0F_PRIMES) { 

// Assume the number is prime 

boolean isPrime = true; // Is the current number prime? 
// Test whether number is prime 

for (int divisor = 2; divisor <= number / 2; divisor++) { 
if (number % divisor == 0) { // If true, number is not prime 
isPrime = false; // Set isPrime to false 
break; // Exit the for loop 

} 

} 

// Print the prime number and increase the count 
if (isPrime) { 

count++; // Increase the count 
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26 

27 if (count % NUMBER_OF_PRIMES_PER_LINE == 0) { 

28 // Print the number and advance to the new "line 

29 System. out. pri ntl n(number) ; 



30 




} 




31 




el se 
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33 




} 












35 




// Check if the next number is 


pri me 


36 




number++ ; 




37 




} 




38 


} 






39 


} 








The 


first 50 prime numbers are 






2 3 


5 7 11 13 17 19 23 29 






31 


37 41 43 47 53 59 61 67 71 






73 


79 83 89 97 101 103 107 109 113 






127 


131 137 139 149 151 157 163 167 


173 




179 


181 191 193 197 199 211 223 227 


229 



This is a complex program for novice programmers. The key to developing a programmatic 

solution to this problem, and to many other problems, is to break it into subproblems and subproblem 

develop solutions for each of them in turn. Do not attempt to develop a complete solution in 

the first trial. Instead, begin by writing the code to determine whether a given number is 

prime, then expand the program to test whether other numbers are prime in a loop. 

To determine whether a number is prime, check whether it is divisible by a number 
between 2 and number/2 inclusive (line 16). If so, it is not a prime number (line 18); other- 
wise, it is a prime number. For a prime number, display it. If the count is divisible by 10 
(lines 27-30), advance to a new line. The program ends when the count reaches 50. 

The program uses the break statement in line 19 to exit the for loop as soon as the num- 
ber is found to be a nonprime. You can rewrite the loop (lines 16-21) without using the break 
statement, as follows: 

for (int divisor = 2; divisor <= number / 2 && isPrime; 
divisor++) { 

// If true, the number is not prime 
if (number % divisor == 0) { 

// Set isPrime to false, if the number is not prime 

isPrime = false; 

} 

} 

However, using the break statement makes the program simpler and easier to read in this case. 

4.10 (GUI) Controlling a Loop with a Confirmation Dialog 

A sentinel-controlled loop can be implemented using a confirmation dialog. The answers Yes confirmation dialog 
or No continue or terminate the loop. The template of the loop may look as follows: 

int option = J0ptionPane.YES_0PTI0N; 
while (option == :0ptionPane.YES_0PTI0N) { 
System. out. pri ntl n("continue loop") ; 

option = JOptionPane . showConfi rmDialog(null , "Continue?"); 

} 
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Listing 4.15 rewrites Listing 4.4, SentinelValue.java, using a confirmation dialog box. A sam- 
ple run is shown in Figure 4.4. 



Enter an int value: 



Select an Option 



Continue? 



Yes No Cancel 



(a) 



(b) 



Enter an int value: 



(c) 




(d) 



2^ 



1 Message 




(Jj) The sum is 8 




m 




(e) 



Figure 4-4 The user enters 3 in (a), clicks Yes in (b), enters 5 in (c), clicks No in (d), and the result is 
shown in (e). 



Listing 4. 1 5 Senti nel Val ueUsi ngConf i rmati onDi al og . java 

1 import javax. swing. JOpti onPane ; 





2 
3 


public class Senti nel Val ueUsi ngConfi rmati onDialog { 




4 


public static void main(String[] args) { 




5 
6 


int sum = 0; 




7 


// Keep reading data until the user answers No 


confirmation option 


8 


int option = J0ptionPane.YES_0PTI0N; 


check option 


9 


while (option == :0ptionPane.YES_0PTI0N) { 




10 


// Read the next data 


input dialog 


11 


String dataString = JOptionPane. showInputDialog( 




12 


"Enter an int value: ") ; 




13 


int data = Integer . parseInt(dataStri ng) ; 




14 






15 


sum += data; 




16 




confirmation dialog 


17 


option = JOpti onPane . showConf i rmDialog(null , "Continue?"); 




18 


} 




19 




message dialog 


20 


JOpti onPane. showMessageDi al og (nul 1 , "The sum is " + sum); 




21 


} 




22 


} 



A program displays an input dialog to prompt the user to enter an integer (line 11) and adds it 
to sum (line 15). Line 17 displays a confirmation dialog to let the user decide whether to con- 
tinue the input. If the user clicks Yes, the loop continues; otherwise the loop exits. Finally the 
program displays the result in a message dialog box (line 20). 
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Chapter Summary 



1. There are three types of repetition statements: the while loop, the do-while loop, 
and the for loop. 

2. The part of the loop that contains the statements to be repeated is called the loop body. 

3. A one-time execution of a loop body is referred to as an iteration of the loop. 
4- An infinite loop is a loop statement that executes infinitely. 

5 . In designing loops, you need to consider both the loop control structure and the loop 
body. 

6. The while loop checks the loop-continuation-condition first. If the condition 
is true, the loop body is executed; if it is fal se, the loop terminates. 

7. The do-whi 1 e loop is similar to the whi 1 e loop, except that the do-whi 1 e loop exe- 
cutes the loop body first and then checks the loop-continuation-condition to 

decide whether to continue or to terminate. 

8. Since the while loop and the do-while loop contain the loop-continuation- 
condition, which is dependent on the loop body, the number of repetitions is deter- 
mined by the loop body. The while loop and the do-while loop often are used when 
the number of repetitions is unspecified. 

9. A sentinel value is a special value that signifies the end of the loop. 

1 0. The for loop generally is used to execute a loop body a predictable number of times; 
this number is not determined by the loop body. 

I I . The for loop control has three parts. The first part is an initial action that often initial- 
izes a control variable. The second part, the loop-continuation-condition, determines 
whether the loop body is to be executed. The third part is executed after each iteration 
and is often used to adjust the control variable. Usually, the loop control variables are 
initialized and changed in the control structure. 

12. The whil e loop and for loop are called pretest loops because the continuation condi- 
tion is checked before the loop body is executed. 

I 3. The do-while loop is called posttest loop because the condition is checked after the 
loop body is executed. 

1 4- Two keywords, break and conti nue, can be used in a loop. 
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Loops 

1 5. The break keyword immediately ends the innermost loop, which contains the break. 
I 6. The conti nue keyword only ends the current iteration. 



Review Questions 



Sections 4-2-4-4 

4-1 Analyze the following code. Is count < 100 always true, always false, or 
sometimes true or sometimes f al se at Point A, Point B, and Point C? 



int count = 0; 

while (count < 100) { 

// Point A 

System. out. print"! n ("Wei come to Java!\n"); 
count++ ; 
// Point B 

} 

// Point C 

4-2 What is wrong if guess is initialized to in line 1 1 in Listing 4.2? 

4-3 How many times is the following loop body repeated? What is the printout of the 
loop? 



int i = 1; 




int i = 1; 




int i = 1; 


while (i < 10) 




while (i < 10) 




while (i < 10) 


if (i % 2 == 0) 




-if (i % 2 == 0) 




if ((i++) % 2 == 0) 


System. out. println(i) ; 




System. out. println(i++) ; 




System. out. println(i) ; 


(a) 


(b) 


(c) 



4-4 What are the differences between a while loop and a do-while loop? Convert 
the following while loop into a do-while loop. 

int sum = 0; 

int number = i nput . nextlnt() ; 
while (number != 0) { 

sum += number; 

number = i nput . nextlntO ; 

} 

4-5 Do the following two loops result in the same value in sum? 



for (int i 

sum += i 



; i < 10 ; ++i ) { 



(a) 



for (int i 

sum += i 



10; i++) { 



(b) 



4-6 What are the three parts of a for loop control? Write a for loop that prints the 
numbers from 1 to 100. 

4-7 Suppose the input is 2 3 4 5 0. What is the output of the following code? 



import java. uti 1 . Scanner ; 
public class Test { 



Review Questions 

public static void man n(Stri ng [] args) { 
Scanner input = new Scanner(System.in) ; 

int number, max; 

number = i nput . nextlntO ; 

max = number; 

while (number != 0) { 

number = i nput . nextlntO ; 
if (number > max) 
max = number; 

} 

System. out. println("max is " + max); 
System. out . pri ntl n("number " + number); 

} 

} 

Suppose the input is 2 3 4 5 0. What is the output of the following code? 
import java. uti 1 . Scanner ; 

public class Test { 

public static void man n(Stri ng [] args) { 
Scanner input = new Scanner(System.in) ; 

int number, sum = 0, count; 

for (count = 0; count < 5; count++) { 
number = i nput . nextlntO ; 
sum += number; 

} 

System. out . pri ntl n("sum is " + sum); 
System. out . pri ntl n("count is " + count); 

} 

} 

Suppose the input is 2 3 4 5 0. What is the output of the following code? 
import java. uti 1 . Scanner ; 

public class Test { 

public static void mai n(Stri ng [] args) { 
Scanner input = new Scanner(System.in) ; 

int number, max; 

number = i nput . nextlntO ; 

max = number; 

do { 

number = i nput . nextlntO ; 
if (number > max) 
max = number; 
} while (number != 0); 

System. out . pri ntl n("max is " + max); 
System. out . pri ntl n("number " + number); 

} 

} 



144 Chapter 4 Loops 



4-10 What does the following statement do? 

for ( ; ; ) { 
do something; 

} 

4. 1 I If a variable is declared in the for loop control, can it be used after the loop exits? 

4-12 Can you convert a for loop to a while loop? List the advantages of using for 
loops. 

4.13 Convert the following for loop statement to a whil e loop and to a do-whil e loop: 
long sum = 0; 

for (int i = 0; i <= 1000; i++) 
sum = sum + i ; 

4-14 Will the program work if nl and n2 are replaced by nl / 2 and n2 / 2 in line 17 in 
Listing 4.8? 

Section 4.9 

4.15 What is the keyword break for? What is the keyword conti nue for? Will the fol- 
lowing program terminate? If so, give the output. 



-int balance = 1000; 
while (true) { 
if (balance < 9) 
break; 

balance = balance - 9; 

} 

System. out. println ("Balance is " 
+ bal ance) ; 



int balance = 1000; 
while (true) { 
if (balance < 9) 
continue; 

balance = balance - 9; 

} 

System. out. pri ntl n("Balance is " 
+ bal ance) ; 



(a) 



(b) 



4-16 Can you always convert a while loop into a for loop? Convert the following 
whil e loop into a for loop. 

int i = 1; 
int sum = 0; 
while (sum < 10000) { 
sum = sum + i ; 

i++; 

} 

4.1 7 The for loop on the left is converted into the while loop on the right. What is 
wrong? Correct it. 



for (int i = 0; i < 4; i++) { 




int i = 0; 


if (i % 3 == 0) continue; 


Converted 


while (i < 4) { 


sum += i ; 


Wrong 


if(i % 3 == 0) continue; 


} 


conversion 


sum += i ; 












} 
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4.1 8 Rewrite the programs TestBreak and TestContinue in Listings 4.11 and 4.12 
without using break and continue. 

4-19 After the break statement is executed in the following loop, which statement is 
executed? Show the output. 

for (int i = 1; i < 4; i++) { 
for (int j = 1; j < 4; { 
if 0" * j > 2) 
break; 



System.out.println(i) ; 

} 



4-20 After the continue statement is executed in the following loop, which statement 
is executed? Show the output. 

for (int i = 1; i < 4; i++) { 
for (int j = 1; j < 4; j++) { 
if (i * j > 2) 
continue; 



System.out.println(i) ; 

} 



Comprehensive 

4-2 1 Identify and fix the errors in the following code: 

1 public class Test { 

2 public void main(String[] args) { 

3 for (int i = 0; i < 10; i++); 

4 sum += i ; 



System. out . pri ntl n(i * j); 



} 



System. out . pri ntl n(i * j); 



} 



5 

6 

7 

8 

9 
10 
11 
12 
13 
14 
15 
16 
17 
18 
19 

20 } 



} 



while (j < 10) ; 

{ 



if (i < j); 

System . out . pri ntl n(i ) 
el se 

System. out. pri ntl n(j) ; 



do { 

j++; 

} while (j < 10) 



j++; 

}; 
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4.22 What is wrong with the following programs? 



1 public class Show/Errors { 

2 public static void main(String[] args) { 
int i ; 
int j = 5; 



3 
4 
5 
6 
7 
8 

9 } 



if (j > 3) 

System. out. println(i + 4); 



1 public class ShowErrors { 

2 public static void mai n(Stri ng [] args) { 

3 for (int i = 0; i < 10; i++); 

4 System. out . pri ntl n(i + 4); 

5 } 

6 } 



(a) (b) 

4.23 Show the output of the following programs. (Tip: Draw a table and list the vari- 
ables in the columns to trace these programs.) 



public class Test { 

/** Main method */ 

public static void mai n(Stri ng [] args) { 
for (int i = 1; i < 5; i++) { 
int j = 0; 
while (j < i) { 

System . out . pri nt(j + " ") ; 

j++; 

} 

} 



} 



} 



(a) 



public class Test { 

public static void mai n(Stri ng [] args) { 
int i = 5; 
while (i >= 1) { 
int num = 1; 

for (int j = 1; j <= i ; j++) { 
System. out. print(num + "xxx") ; 
num *= 2; 

} 

System. out. pri ntl n() ; 
i — ; 



public class Test { 






/** Main method */ 






public static void main(Stn 


ng[] 


args) { 


int i = 0; 






while (i < 5) { 






for (int j = i ; j > 1 ; 


j-) 




System. out. print(j + 


" "); 




System . out . pri ntl n("- v * * 


*"); 




i++; 






} 






} 






} 






(b) 


public class Test { 






public static void main(Stri 


ng[] 


args) { 


int i = 1; 






do { 






int num = 1; 






for (int j = 1 ; j <= i ; 




{ 


System. out. print (num 


+ "C 


); 


num += 2; 






} 






System. out. pri ntl n() ; 






i++; 






} while (i <= 5) ; 






} 






} 







(c) 



(d) 



4-24 What is the output of the following program? Explain the reason. 

int x = 80000000; 

while (x > 0) 

x++ ; 

System. out. println("x is " + x) ; 
4-25 Count the number of iterations in the following loops. 
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int count = 0; 
while (count < 
count++; 

} 



n) { 



(a) 



for (int count = 0; 

count <= n; count++) { 

} 



(b) 



int count = 5; 




int count = 5; 


while (count < n) { 




while (count < n) { 


count++; 




count = count + 3; 


} 




} 


(c) 


(d) 



Programming Exercises 



Hp Pedagogical Note 

For each problem, read it several times until you understand the problem. Think how to solve 

the problem before coding. Translate your logic into a program. read and think before coding 

A problem often can be solved in many different ways. Students are encouraged to explore 

various solutions. explore solutions 

Sections 4-2-4-7 

4- 1 * (Counting positive and negative numbers and computing the average of numbers) 
Write a program that reads an unspecified number of integers, determines how 
many positive and negative values have been read, and computes the total and 
average of the input values (not counting zeros). Your program ends with the input 
0. Display the average as a floating-point number. Here is a sample run: 



Enter an int value, the 


program exits if the input is 0: 


12-130 I- Enter' 


The number of positives 


is 3 


The number of negatives 


is 1 


The total is 5 




The average is 1.25 





4-2 (Repeating additions) Listing 4.3, SubtractionQuizLoop.java, generates five ran- 
dom subtraction questions. Revise the program to generate ten random addition 
questions for two integers between 1 and 15. Display the correct count and test 
time. 

4-3 (Conversion from kilograms to pounds) Write a program that displays the follow- 
ing table (note that 1 kilogram is 2 . 2 pounds): 

Kilograms Pounds 

1 2.2 
3 6.6 



197 
199 



433.4 
437.8 
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4-4 (Conversion from miles to kilometers) Write a program that displays the following 
table (note that 1 mile is 1 . 609 kilometers): 



Miles Kilometers 

1 1.609 

2 3.218 

9 14.481 

10 16.090 



4-5 (Conversion from kilograms to pounds) Write a program that displays the follow- 
ing two tables side by side (note that 1 kilogram is 2 . 2 pounds): 



Kilograms Pounds 

1 2.2 

3 6.6 

197 433.4 

199 437.8 



Pounds Kilograms 

20 9.09 

25 11.36 

510 231.82 

515 234.09 



4«6 (Conversion from miles to kilometers) Write a program that displays the following 
two tables side by side (note that 1 mile is 1 . 609 kilometers): 



Miles Kilometers Kilometers Miles 

1 1.609 20 12.430 

2 3.218 25 15.538 

9 14.481 60 37.290 

10 16.090 65 40.398 



4-7** (Financial application: computing future tuition) Suppose that the tuition for a 
university is $10 , 000 this year and increases 5% every year. Write a program that 
computes the tuition in ten years and the total cost of four years' worth of tuition 
starting ten years from now. 

4-8 (Finding the highest score) Write a program that prompts the user to enter the 
number of students and each student's name and score, and finally displays the 
name of the student with the highest score. 

4-9* (Finding the two highest scores) Write a program that prompts the user to 
enter the number of students and each student's name and score, and finally 
displays the student with the highest score and the student with the second- 
highest score. 

4-10 (Finding numbers divisible by 5 and 6) Write a program that displays all the num- 
bers from 100 to 1000, ten per line, that are divisible by 5 and 6. 

4-1 I (Finding numbers divisible by 5 or 6, but not both) Write a program that displays 
all the numbers from 100 to 200, ten per line, that are divisible by 5 or 6, but not 
both. 

4-12 (Finding the smallest n such that n 2 > 12,000) Use a whi 1 e loop to find the small- 
est integer n such that n 2 is greater than 12,000. 

4.13 (Finding the largest n such that n 3 < 12,000) Use a whi 1 e loop to find the largest 
integer n such that n 3 is less than 12,000. 

4-1 4* (Displaying the ACSII character table) Write a program that prints the characters 
in the ASCII character table from ' ! ' to ' ~ ' . Print ten characters per line. The 
ASCII table is shown in Appendix B. 
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Section 4-8 

4-15* (Computing the greatest common divisor) Another solution for Listing 4.8 to find 
the greatest common divisor of two integers nl and n 2 is as follows: First find d 
to be the minimum of nl and n2, then check whether d, d-1, d-2, . . . , 2, or 1 is 
a divisor for both nl and n2 in this order. The first such common divisor is the 
greatest common divisor for nl and n2. Write a program that prompts the user to 
enter two positive integers and displays the gcd. 

4.1 6** (Finding the factors of an integer) Write a program that reads an integer and dis- 
plays all its smallest factors in increasing order. For example, if the input integer 
is 120, the output should be as follows: 2, 2, 2, 3, 5. 

4^1 7** (Displaying pyramid) Write a program that prompts the user to enter an integer 
from 1 to 15 and displays a pyramid, as shown in the following sample run: 



Enter the number of lines 


7 




Enter 






















1 


















2 


1 


2 














3 


2 


1 


2 


3 










4 


3 


2 


1 


2 


3 


4 






5 


4 


3 


2 


1 


2 


3 


4 


5 




6 5 


4 


3 


2 


1 


2 


3 


4 


5 


6 


7 6 5 


4 


3 


2 


1 


2 


3 


4 


5 


6 7 



4-18* (Printing four patterns using loops) Use nested loops that print the following pat- 
terns in four separate programs: 

Pattern I Pattern II Pattern III Pattern IV 

1 123456 1 123456 

12 12345 21 12345 

123 1234 321 1234 

1234 123 4321 123 

12345 12 54321 12 



4.19 



123456 1 654321 1 

' (Printing numbers in a pyramid pattern) Write a nested for loop that prints the 
following output: 















1 






















1 


2 


1 


















1 


2 


4 


2 


1 














1 


2 


4 


8 


4 


2 


1 










1 


2 


4 


8 


16 


8 


4 


2 


1 






1 


2 


4 


8 


16 


32 


16 


8 


4 


2 


1 


1 


2 


4 


8 


16 


32 


64 


32 


16 


8 


4 


2 1 


2 


4 


8 


16 


32 


64 


128 


64 


32 


16 


8 


4 2 



4-20* (Printing prime numbers between 2 and 1000) Modify Listing 4.14 to print all the 
prime numbers between 2 and 1000, inclusive. Display eight prime numbers per line. 

Comprehensive 

4-2 I ** (Financial application: comparing loans with various interest rates) Write a pro- 
gram that lets the user enter the loan amount and loan period in number of years 
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and displays the monthly and total payments for each interest rate starting from 
5% to 8%, with an increment of 1/8. Here is a sample run: 











Loan Amount: 10000 [^ Entel Ll 








Number of Years: 5 h Enter 


Interest Rate 


Monthly Payment 


Total 


Payment 


5% 


188.71 


11322 


74 


5.12 5% 


189.28 


11357 


13 


5.25% 


189.85 


11391 


59 


7.875% 


202.17 


12129 


97 


8.0% 


202.76 


12165 


83 



For the formula to compute monthly payment, see Listing 2.8, ComputeLoan.java. 

4^22** (Financial application: loan amortization schedule) The monthly payment for a 
given loan pays the principal and the interest. The monthly interest is computed 
by multiplying the monthly interest rate and the balance (the remaining princi- 

„. , , ... pal). The principal paid for the month is therefore the monthly payment minus the 

Display loan schedule , , . ,, r • , , , 

monthly interest. Write a program that lets the user enter the loan amount, num- 
ber of years, and interest rate and displays the amortization schedule for the loan. 
Here is a sample run: 



Loan Amount: 10000 






Number of Years 


: 1 






Annual Interest 


Rate: 7% 






Monthly Payment 


: 865.26 






Total Payment: 


10383.21 






Payment* 


Interest 


Pri nci pal 


Bal ance 


1 


58.33 


806.93 


9193.07 


2 


53.62 


811.64 


8381.43 


11 


10.0 


855.26 


860.27 


12 


5.01 


860.25 


0.01 



§ Note 

The balance after the last payment may not be zero. If so, the last payment should be the normal 
monthly payment plus the final balance. 

Hint: Write a loop to print the table. Since the monthly payment is the same for 
each month, it should be computed before the loop. The balance is initially the 
loan amount. For each iteration in the loop, compute the interest and principal, 
and update the balance. The loop may look like this: 

for (i =1; i <= numberOf Years * 12; i++) { 
interest = monthlylnterestRate * balance; 
principal = monthl yPayment - interest; 
balance = balance - principal; 
System. out. println(i + "\t\t" + interest 
+ "\t\t" + principal + "\t\t" + balance); 

} 



Programming Exercises 151 



4.23* (Obtaining more accurate results) In computing the following series, you will obtain 
more accurate results by computing from right to left rather than from left to right: 

1 1 1 

1 + - + - + ... + - 

2 3 n 

Write a program that compares the results of the summation of the preceding 
series, computing from left to right and from right to left with n = 50000. 

4-24* (Summing a series) Write a program to sum the following series: 

1 3 5 7 9 11 95 97 

- + - + - + -H H + ... H H 

3 5 7 9 11 13 97 99 

4.25** (Computing tt) You can approximate ir by using the following series: 
/ 11111 1 1 

77 = 41 + + + ... + 

V 3 5 7 9 11 2i - 1 2i + 1 

Write a program that displays the tt value for i = 10000, 20000, . . . , and 
100000. 

4.26** (Computing e) You can approximate e using the following series: 

1111 1 

e = 1 H H H H + ... + — 

1! 2! 3! 4! i\ 

Write a program that displays the e value for i = 10000, 20000, . . . , and 
100000. 

1 1 

(Hint: Since;'! = i X (i - 1) X ... X 2 X 1, then — is- — 

i\ i{i — 1)! 

Initialize e and item to be 1 and keep adding a new item to e. The new item is 
the previous item divided by i for i = 2, 3, 4, . . . .) 

4-27** (Displaying leap years) Write a program that displays all the leap years, ten per 
line, in the twenty-first century (from 2001 to 2100). 

4.28** (Displaying the first days of each month) Write a program that prompts the user to 
enter the year and first day of the year, and displays the first day of each month in 
the year on the console. For example, if the user entered the year 2005, and 6 for 
Saturday, January 1, 2005, your program should display the following output 
(note that Sunday is 0): 

January 1, 2005 is Saturday 

December 1, 2005 is Thursday 

4.29** (Displaying calendars) Write a program that prompts the user to enter the year and 
first day of the year and displays the calendar table for the year on the console. For 
example, if the user entered the year 2005, and 6 for Saturday, January 1, 2005, 
your program should display the calendar for each month in the year, as follows: 



January 2005 



Sun Mon Tue Wed Thu Fri Sat 

1 



2 


3 


4 


5 


6 


7 


8 


9 


10 


1 1 


12 


13 


14 


15 


16 


17 


18 


19 


20 


21 


22 


23 


24 


25 


26 


27 


28 


29 



30 31 
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December 2005 



Sun 


Mon 


Tue 


Wed 


Thu 

1 


Fri 

2 


Sat 

3 


4 


5 


6 


7 


8 


9 


10 


1 1 


12 


13 


14 


15 


16 


17 


18 


19 


20 


21 


22 


23 


24 


25 


26 


27 


28 


29 


30 


31 



4-30* (Financial application: compound value) Suppose you save $100 each month into 
a savings account with the annual interest rate 5%. So, the monthly interest rate is 
0.05 / 12 = 0.00417. After the first month, the value in the account becomes 



100 * (1 + 0.00417) = 100.417 
After the second month, the value in the account becomes 

(100 + 100.417) * (1 + 0.00417) = 201.252 
After the third month, the value in the account becomes 

(100 + 201.252) * (1 + 0.00417) = 302.507 

and so on. 

Write a program that prompts the user to enter an amount (e.g., 100), the annual 
interest rate (e.g., 5), and the number of months (e.g., 6) and displays the amount 
in the savings account after the given month. 

4-3 1 * (Financial application: computing CD value) Suppose you put $10,000 into a CD 
with an annual percentage yield of 5.75%. After one month, the CD is worth 

10000 + 10000 * 5.75 / 1200 = 10047.91 
After two months, the CD is worth 



10047.91 + 10047.91 * 5.75 / 1200 = 10096.06 
After three months, the CD is worth 



10096.06 + 10096.06 * 5.75 / 1200 = 10144.43 

and so on. 

Write a program that prompts the user to enter an amount (e.g., 10000), the annual 
percentage yield (e.g., 5 . 75), and the number of months (e.g., 18) and displays a 
table as shown in the sample run. 



Enter the initial deposit amount: 10000 
Enter annual percentage yield: 5.75 pEnter 



Enter maturity period (number of months) 




Month 

1 

2 



CD Value 
10047.91 
10096.06 



17 
18 



10846.56 
10898.54 
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4-32** (Game: lottery) Revise Listing 3.9, Lottery.java, to generate a lottery of a two- 
digit number. The two digits in the number are distinct. 

(Hint: Generate the first digit. Use a loop to continuously generate the second 
digit until it is different from the first digit.) 

4-33** (Perfect number) A positive integer is called a perfect number if it is equal to the 
sum of all of its positive divisors, excluding itself. For example, 6 is the first perfect 
number because 6 = 3 + 2 + 1. The next is 28 = 14 + 7 + 4 + 2 + 1. There are four 
perfect numbers less than 10000. Write a program to find all these four numbers. 

4-34*** (Game: scissor, rock, paper) Exercise 3.17 gives a program that plays the 
scissor-rock-paper game. Revise the program to let the user continuously play 
until either the user or the computer wins more than two times. 

4-35* (Summation) Write a program that computes the following summation. 

Ill 1 

H 1= 7= H 7= 7= + . . . + 



1 + V2 V2 + V3 V3 + V4 

4-36** (Business application: checking ISBN) Use loops to simplify Exercise 3.19. 

4-37** (Decimal to binary) Write a program that prompts the user to enter a decimal 
integer and displays its corresponding binary value. Don't use Java's 
Integer . toBinaryString(int) in this program. 

4.38** (Decimal to hex) Write a program that prompts the user to enter a decimal integer 
and displays its corresponding hexadecimal value. Don't use Java's 
Integer . toHexString(int) in this program. 

4'39* (Financial application: finding the sales amount) You have just started a sales 
job in a department store. Your pay consists of a base salary and a commission. 
The base salary is $5,000. The scheme shown below is used to determine the 
commission rate. 

Sales Amount Commission Rate 



$0.01-$5,000 8 percent 

$5,000.01-810,000 10 percent 

S 1 0,000.0 1 and above 1 2 percent 

Your goal is to earn $30,000 a year. Write a program that finds out the minimum 
amount of sales you have to generate in order to make $30,000. 

4-40 (Simulation: head or tail) Write a program that simulates flipping a coin one 
million times and displays the number of heads and tails. 

4-4 I ** (Occurrence of max numbers) Write a program that reads integers, finds the 
largest of them, and counts its occurrences. Assume that the input ends with 
number 0. Suppose that you entered 3 5 2 5 5 5 0; the program finds that the 
largest is 5 and the occurrence count for 5 is 4. 

(Hint: Maintain two variables, max and count, max stores the current max num- 
ber, and count stores its occurrences. Initially, assign the first number to max 
and 1 to count. Compare each subsequent number with max. If the number is 
greater than max, assign it to max and reset count to 1. If the number is equal to 
max, increment count by 1.) 



Enter numbers: 3 5 2 5 5 5 ^ Enter 
The largest number is 5 

The occurrence count of the largest number is 4 
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4-42* (Financial application: finding the sales amount) Rewrite Exercise 4.39 as follows: 

■ Use a for loop instead of a do-whil e loop. 

■ Let the user enter COMMISSION_SOUGHT instead of fixing it as a constant. 

4-43* (Simulation: clock countdown) Write a program that prompts the user to enter the 
number of seconds, displays a message at every second, and terminates when the 
time expires. Here is a sample run: 



Enter the number of second: 3 |h Enter 
2 seconds remaining 
1 second remaining 
Stopped 



4-44** (Monte Carlo simulation) A square is divided into four smaller regions as shown 
below in (a). If you throw a dart into the square 1000000 times, what is the prob- 
ability for a dart to fall into an odd-numbered region? Write a program to simulate 
the process and display the result. 

(Hint: Place the center of the square in the center of a coordinate system, as 
shown in (b). Randomly generate a point in the square and count the number of 
times a point falls into an odd-numbered region.) 





4-45* (Math: combinations) Write a program that displays all possible combinations for 
picking two numbers from integers 1 to 7. Also display the total number of all 
combinations. 




1 2 
1 3 



4-46* (Computer architecture: bit-level operations) A short value is stored in 16 bits. 
Write a program that prompts the user to enter a short integer and displays the 16 
bits for the integer. Here are sample runs: 




Enter an integer: 5 ^ Erter 

The bits are 0000000000000101 




Enter an integer: -5 jEnter 
The bits are 1111111111111011 



(Hint: You need to use the bitwise right shift operator (>>) and the bitwise AND 
operator (&), which are covered in Supplement III.D on the Companion Website.) 



Methods 

Objectives 

■ To define methods (§5.2). 

■ To invoke methods with a return value (§5.3). 

■ To invoke methods without a return value (§5.4). 

■ To pass arguments by value (§5.5). 

■ To develop reusable code that is modular, easy to read, 
easy to debug, and easy to maintain (§5.6). 

■ To write a method that converts decimals to 
hexadecimals (§5.7). 

■ To use method overloading and understand ambiguous 
overloading (§5.8). 

■ To determine the scope of variables (§5.9). 

■ To solve mathematics problems using the methods 
in the Math class (§§5.10-5.11). 

■ To apply the concept of method abstraction in 
software development (§5.12). 

■ To design and implement methods using stepwise 
refinement (§5.12). 
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5.1 Introduction 

problem Suppose that you need to find the sum of integers from 1 to 10, from 20 to 30, and from 35 

to 45, respectively. You may write the code as follows: 



int sum = 0; 

for (int i = 1; i <= 10; i++) 
sum += i ; 

System. out. println ("Sum from 1 to 10 is " + sum); 
sum = 0; 

for (int i = 20; i <= 30; 

sum += i ; 

System . out . pri ntl n("Sum from 20 to 30 is " + sum); 
sum = 0; 

for (int i = 35; i <= 45; i++) 
sum += i ; 

System. out. pri ntl n ("Sum from 35 to 45 is " + sum); 



You may have observed that computing sum from 1 to 10, from 20 to 30, and from 35 to 45 
are very similar except that the starting and ending integers are different. Wouldn't it be nice 
if we could write the common code once and reuse it without rewriting it? We can do so by 
why methods? defining a method. The method is for creating reusable code. 

The preceding code can be simplified as follows: 

define sum method 1 public static int sum(int il, int i2) { 

2 int sum = 0; 

3 for (int i = il; i <= i2; i++) 

4 sum += i ; 
5 

6 return sum; 

7 } 
8 

mainmethod 9 public static void main(String[] args) { 

invoke sum 10 System . out . pri ntl n ("Sum from 1 to 10 is " + sum(l, 10)); 

11 System. out. println("Sum from 20 to 30 is " + sum(20, 30)); 

12 System. out. println("Sum from 35 to 45 is " + sum(35, 45)); 

13 } 



Lines 1-7 define the method named sum with two parameters i and j. The statements in the 
main method invoke sum(l, 10) to compute the sum from 1 to 10, sum(20, 30) to com- 
pute the sum from 20 to 30, and sum(35 , 45) to compute the sum from 35 to 45. 

A method is a collection of statements grouped together to perform an operation. In earlier 
chapters you have used predefined methods such as System. out. println, JOption- 
Pane . showMessageDi al og, JOptionPane . showInputDi al og, Integer . parselnt, 
Doubl e . parseDoubl e, System . exi t, Math . pow, and Math . random. These methods are 
defined in the Java library. In this chapter, you will learn how to define your own methods and 
apply method abstraction to solve complex problems. 

5.2 Defining a Method 

The syntax for defining a method is as follows: 

modifier returnValueType methodName(list of parameters) { 

// Method body; 

} 
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Let's look at a method created to find which of two integers is bigger. This method, named 
max, has two int parameters, numl and num2, the larger of which is returned by the method. 
Figure 5.1 illustrates the components of this method. 



method 
header 

method 
body 



Define a method 



Invoke a method 



return value method formal 
modifier type name parameters 



-public static int I max(int numl, int num2) I { 

1 =n 

int result; A 



if (numl > num2) 
result = numl; 

el se 

result = num2; 

return result; -<— 



parameter list method 
signature 



return value 



int z = max(x , y) ; 

t t 

actual parameters 
(arguments) 



Figure 5.1 A method definition consists of a method header and a method body. 



The method header specifies the modifiers, return value type, method name, and 
parameters of the method. The static modifier is used for all the methods in this chapter. The 
reason for using it will be discussed in Chapter 8, "Objects and Classes." 

A method may return a value. The returnVal ueType is the data type of the value the 
method returns. Some methods perform desired operations without returning a value. In this 
case, the returnVal ueType is the keyword void. For example, the returnVal ueType is 
void in the main method, as well as in System. exit, System. out. print"! n, and 
JOptionPane. showMessageDialog. If a method returns a value, it is called a value- 
returning method, otherwise it is a void method. 

The variables defined in the method header are known as formal parameters or simply 
parameters. A parameter is like a placeholder. When a method is invoked, you pass a value to the 
parameter. This value is referred to as an actual parameter or argument. The parameter list 
refers to the type, order, and number of the parameters of a method. The method name and the 
parameter list together constitute the method signature. Parameters are optional; that is, a method 
may contain no parameters. For example, the Math . random () method has no parameters. 

The method body contains a collection of statements that define what the method does. 
The method body of the max method uses an i f statement to determine which number is 
larger and return the value of that number. In order for a value-returning method to return a 
result, a return statement using the keyword return is required. The method terminates when 
a return statement is executed. 



method header 



value-returning method 
void method 

parameter 
argument 
parameter list 
method signature 



Note 

In certain other languages, methods are referred to as procedures and functions. A value-returning 
method is called a function; a void method is called a procedure. 



Caution 

In the method header, you need to declare a separate data type for each parameter. For instance, 
max(int numl, int num2) is correct, butmax(int numl, num2) is wrong. 



Note 

We say "define a method" and "declare a variable." We are making a subtle distinction here. A 
definition defines what the defined item is, but a declaration usually involves allocating memory 
to store data for the declared item. 



define vs. declare 
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5.3 Calling a Method 



In creating a method, you define what the method is to do. To use a method, you have to call 
or invoke it. There are two ways to call a method, depending on whether the method returns a 
value or not. 

If the method returns a value, a call to the method is usually treated as a value. For example, 

int larger = max(3, 4); 

calls max(3 , 4) and assigns the result of the method to the variable 1 arger. Another exam- 
ple of a call that is treated as a value is 

System. out. pri nt~l n(max(3 , 4)); 

which prints the return value of the method call max (3 , 4). 

If the method returns void, a call to the method must be a statement. For example, the 
method printl n returns void. The following call is a statement: 

System. out. pri ntl n ("Wei come to Java!"); 



A value-returning method can also be invoked as a statement in Java. In this case, the caller sim- 
ply ignores the return value. This is not often done but is permissible if the caller is not interested 
in the return value. 

When a program calls a method, program control is transferred to the called method. A called 
method returns control to the caller when its return statement is executed or when its method- 
ending closing brace is reached. 

Listing 5.1 shows a complete program that is used to test the max method. 





Listing 5.1 TestMax.java 



Video Note 

Define/invoke max method 



1 public class TestMax { 

2 /** Main method */ 

3 public static void main(String[] args) { 

4 int i = 5; 

5 int j = 2; 

6 int k = max(i , j) ; 

7 System. out. pri ntl n ("The maximum between " + i + 

8 " and " + j + " is " + k) ; 

9 } 
10 

11 /** Return the max between two numbers */ 

12 public static int max(int numl, int num2) { 

13 int result; 
14 

15 if (numl > num2) 

16 result = numl; 

17 else 

18 result = num2; 
19 

20 return result; 

21 } 

22 } 



main method 



invoke max 



define method 



The maximum between 5 and 2 is 5 
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line# 




j 


lc 


numl 


num2 


result 


4 
5 

' 12 

Invoking max J 13 

16 
6 


5 


2 


5 


5 


2 


undefined 
5 



0^ 



This program contains the main method and the max method. The main method is just like main method 
any other method except that it is invoked by the JVM. 

The mai n method's header is always the same. Like the one in this example, it includes the 
modifiers publ i c and stati c, return value type voi d, method name mai n, and a parameter 
of the String [] type. String [] indicates that the parameter is an array of String, a sub- 
ject addressed in Chapter 6. 

The statements in main may invoke other methods that are defined in the class that con- 
tains the mai n method or in other classes. In this example, the mai n method invokes max(i , 
j ) , which is defined in the same class with the mai n method. 

When the max method is invoked (line 6), variable i 's value 5 is passed to numl, and vari- max method 
able j 's value 2 is passed to num2 in the max method. The flow of control transfers to the max 
method. The max method is executed. When the return statement in the max method is exe- 
cuted, the max method returns the control to its caller (in this case the caller is the main 
method). This process is illustrated in Figure 5.2. 



pass the value i 

pass the value j 



public static Void main(String[] args) { 
int i = 5; 



int ] 
int k 



max(i , j); 



System . out . pri ntl n ( 

"The maximum between " + i + 
" and " + j + " i s " + k) ; 



public static int max(int 






numl, 


int num2) { 


int result; 






if (numl > num2) 






result = numl; 






el se 






result = num2; 






"^return result; 






} 







Figure 5.2 When the max method is invoked, the flow of control transfers to it. Once the max method is finished, it 
returns control back to the caller. 



Caution 

A return statement is required for a value-returning method. The method shown below in (a) is 
logically correct, but it has a compile error because the Java compiler thinks it possible that this 
method returns no value. 

To fix this problem, delete if (n < 0) in (a), so that the compiler will see a return statement 
to be reached regardless of how the if statement is evaluated. 
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public static int sign(int n) { 
if (n > 0) 

return 1; 
else if (n == 0) 

return 0; 
else if (n < 0) 

return -1; 

} 


Should be 


public static int sign(int n) { 
if (n > 0) 

return 1; 
else if (n == 0) 

return 0; 
el se 

return -1; 

} 





(a) (b) 



Hi? Note 

reusing method Methods enable code sharing and reuse. The max method can be invoked from any class besides 

TestMax. If you create a new class, you can invoke the max method using CI ass- 
Name. methodName (i.e., TestMax. max). 



5.3.1 Call Stacks 

Each time a method is invoked, the system stores parameters and variables in an area of mem- 
ory known as a stack, which stores elements in last-in, first-out fashion. When a method calls 
another method, the caller's stack space is kept intact, and new space is created to handle the 
new method call. When a method finishes its work and returns to its caller, its associated 
space is released. 

Understanding call stacks helps you to comprehend how methods are invoked. The vari- 
ables defined in the mai n method are i , j , and k. The variables defined in the max method are 
numl, num2, and resul t. The variables numl and num2 are defined in the method signature 
and are parameters of the method. Their values are passed through method invocation. Figure 
5.3 illustrates the variables in the stack. 



Space required for 
the mai n method 
k 

j 
i 



(a) The mai n 
method is invoked. 



Space required for 
the max method 

num2: 2 
numl: 5 



Space required for 
the mai n method 

k: 

j : 
i : 



(b) The max 
method is invoked. 



Space required for 

the max method 

result: 5 
num2: 2 
numl: 5 



Space required for 
the mai n method 

k: 

j : 
i : 



(c) The max method 
is being executed. 



Space required for 
the mai n method 



(d) The max method is 
finished and the return 
value is sent to k. 



Stack is empty 



(e) The mai n 
method is finished. 



Figure 5.3 When the max method is invoked, the flow of control transfers to the max method. Once the max method is 
finished, it returns control back to the caller. 



Video Note 

Use void method 



main method 



5.4 void Method Example 



The preceding section gives an example of a value-returning method. This section shows how 
to define and invoke a void method. Listing 5.2 gives a program that defines a method named 
pri ntCrade and invokes it to print the grade for a given score. 

Listing 5.2 TestVoidMethod.java 

1 public class TestVoi dMethod { 

2 public static void main(String[] args) { 

3 System . out . pri nt("The grade is ") ; 



5.4 void Method Example 1 



4 pri ntGrade(78. 5) ; invoke printGrade 

5 

6 System . out . pri nt("The grade is ") ; 

7 printGrade(59. 5) ; printGrade method 

8 } 
9 

10 public static void pri ntCrade(doubl e score) { 

11 if (score >= 90.0) { 

12 System. out. println('A') ; 

13 } 

14 else if (score >= 80.0) { 

15 System. out. println('B') ; 

16 } 

17 else if (score >= 70.0) { 

18 System. out. println('C') ; 

19 } 

20 else if (score >= 60.0) { 

21 System. out. println('D') ; 

22 } 

23 else { 

24 System. out. println('F') ; 

25 } 

26 } 



27 } 



The grade is C 
The grade is F 



The printGrade method is a void method. It does not return any value. A call to a void invoke void method 
method must be a statement. So, it is invoked as a statement in line 4 in the main method. 
Like any Java statement, it is terminated with a semicolon. 

To see the differences between a void and a value-returning method, let us redesign the void vs. value-returned 
printGrade method to return a value. The new method, which we call getGrade, returns 
the grade as shown in Listing 5.3. 

Listing 5.3 TestReturnGradeMethod . java 

1 public class TestReturnGradeMethod { 

2 public static void main(String[] args) { mainmethod 

3 System. out. pri nt("The grade is " + getGrade(78 . 5) ) ; 

4 System . out . pri nt("\nThe grade is " + getGrade(59 . 5) ) ; invoke printGrade 

5 } 
6 

7 public static char getGrade (double score) { printGrade method 



8 


if (score >= 90.0) 




9 


return 'A' ; 




10 


else if (score >= 


80.0) 


11 


return 'B' ; 




12 


else if (score >= 


70.0) 


13 


return 'C ; 




14 


else if (score >= 


60.0) 


15 


return 'D' ; 




16 


el se 




17 


return ' F' ; 




18 


} 




19 } 
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The grade is C 
The grade is F 



The getCrade method defined in lines 7-18 returns a character grade based on the numeric 
score value. The caller invokes this method in lines 3—4. 

The getGrade method can be invoked by a caller wherever a character may appear. The 
printGrade method does not return any value. It must be also invoked as a statement. 

IP Note 

return in void method A return statement is not needed for a void method, but it can be used for terminating the 

method and returning to the method's caller. The syntax is simply 

return ; 

This is not often done, but sometimes it is useful for circumventing the normal flow of control in 
a void method. For example, the following code has a return statement to terminate the method 
when the score is invalid. 

public static void pri ntGrade (double score) { 
if (score < | | score > 100) { 

System . out . pri ntl n("Inval id score") ; 
return ; 

} 

if (score >= 90.0) { 

Sy stem. out. pri ntl n(' A') ; 

} 

else if (score >= 80.0) { 
System . out . pri ntl n( ' B ' ) ; 

} 

else if (score >= 70.0) { 
System. out. pri ntl n('C') ; 

} 

else if (score >= 60.0) { 
Sy stem. out. pri ntl n('D') ; 

} 

else { 

System . out . pri ntl n( ' F' ) ; 

} 

} 



5.5 Passing Parameters by Values 

The power of a method is its ability to work with parameters. You can use pri ntl n to print 
any string and max to find the maximum between any two int values. When calling a 
method, you need to provide arguments, which must be given in the same order as their 
parameter order association respective parameters in the method signature. This is known as parameter order association. 

For example, the following method prints a message n times: 

public static void nPri ntl n(Stri ng message, int n) { 
for (int i =0; i < n; i++) 
System. out. println(message) ; 

} 

You can use nPr i ntl n ("Hel 1 o" , 3) to print "He! 1 o" three times. The nPri ntl n ("Hel 1 o" , 

3) statement passes the actual string parameter "Hello" to the parameter message; passes 3 to n; 
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and prints "Hello" three times. However, the statement nPrintln(3, "Hello") would be 
wrong. The data type of 3 does not match the data type for the first parameter, message, nor does 
the second parameter, "Hel 1 o", match the second parameter, n. 

|§jt Caution 

The arguments must match the parameters in order, number, and compatible type, as defined in 
the method signature. Compatible type means that you can pass an argument to a parameter 
without explicit casting, such as passing an int value argument to a double value parameter. 

When you invoke a method with a parameter, the value of the argument is passed to the para- 
meter. This is referred to as pass-by-value. If the argument is a variable rather than a literal pass-by-value 
value, the value of the variable is passed to the parameter. The variable is not affected, regard- 
less of the changes made to the parameter inside the method. As shown in Listing 5.4, the 
value of x (1) is passed to the parameter n to invoke the increment method (line 5). n is 
incremented by 1 in the method (line 10), but x is not changed no matter what the method 
does. 

Listing 5.4 Increment .java 

1 public class Increment { 

2 public static void main(String[] args) { 

3 int x = 1; 

4 System, out. print"! n ("Before the call, x is " + x) ; 

5 i ncrement(x) ; 

6 System. out. pri ntl n("after the call, x is " + x); 

7 } 
8 

9 public static void i ncrement(int n) { 

10 n++; 

11 System. out. println("n inside the method is " + n) ; 

12 } 

13 } 



invoke increment 



increment n 



Before the call, x is 1 
n inside the method is 2 
after the call, x is 1 



Listing 5.5 gives another program that demonstrates the effect of passing by value. The pro- 
gram creates a method for swapping two variables. The swap method is invoked by passing 
two arguments. Interestingly, the values of the arguments are not changed after the method is 
invoked. 

Listing 5.5 TestPassByValue. java 

1 public class TestPassByValue { 

2 /** Main method */ 

3 public static void main(String[] args) { 

4 // Declare and initialize variables 

5 int numl = ; 

6 int num2 = 2; 
7 

8 System. out. pri ntl n("Before invoking the swap method, numl is " + 

9 numl + " and num2 is " + num2) ; 
10 

11 // Invoke the swap method to attempt to swap two variables 

12 swap(numl, num2) ; false swap 
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13 

14 System. out. pri ntl n ("After invoking the swap method, numl is " + 

15 numl + " and num2 is " + num2) ; 

16 } 
17 

18 /** Swap two variables */ 

19 public static void swap(int nl, int n2) { 

20 System. out. pri ntl n("\tlnside the swap method"); 

21 System. out. pri ntl n("\t\tBefore swapping nl is " + nl 

22 + " n2 is " + n2) ; 
23 

24 // Swap nl with n2 

25 int temp = nl; 

26 nl = n2; 

27 n2 = temp; 
28 

29 System. out. pri ntl n("\t\tAfter swapping nl is " + nl 

30 + " n2 is " + n2); 

31 } 

32 } 



Before invoking the swap method, numl is 1 and num2 is 2 
Inside the swap method 

Before swapping nl is 1 n2 is 2 

After swapping nl is 2 n2 is 1 
After invoking the swap method, numl is 1 and num2 is 2 



Before the swap method is invoked (line 12), numl is 1 and num2 is 2. After the swap method 
is invoked, numl is still 1 and num2 is still 2. Their values have not been swapped. As shown 
in Figure 5.4, the values of the arguments numl and num2 are passed to nl and n2, but nl and 
n2 have their own memory locations independent of numl and num2. Therefore, changes in 
nl and n2 do not affect the contents of numl and num2. 

Another twist is to change the parameter name nl in swap to numl. What effect does this 
have? No change occurs, because it makes no difference whether the parameter and the argu- 
ment have the same name. The parameter is a variable in the method with its own memory 
space. The variable is allocated when the method is invoked, and it disappears when the 
method is returned to its caller. 




The values of numl and num2 are 
passed to nl and n2. Executing swap 
does not affect numl and num2. 



Space required for the 
man n method 

num2: 2 
numl: 1 



The man n method 
is invoked. 



Space required for the 

swap method 

temp: 
n2: 2 
nl: 1 



Space required for the 
man n method 

num2: 2 
numl: 1 



The swap method 
is invoked. 



Space required for the 
man n method 

num2: 2 
numl: 1 



The swap method 
is finished. 



Stack is empty 



The mai n method 
is finished. 



Figure 5.4 The values of the variables are passed to the parameters of the method. 
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§ Note 

For simplicity, Java programmers often say passing an argument x to a parameter y, which actu- 
ally means passing the value of x to y. 



5.6 Modularizing Code 

Methods can be used to reduce redundant code and enable code reuse. Methods can also be 

used to modularize code and improve the quality of the program. 

T . . , o . , , Video Note 

Listing 4.8 gives a program that prompts the user to enter two integers and displays their Modularize code 

greatest common divisor. You can rewrite the program using a method, as shown in Listing 5.6. 

Listing 5.6 GreatestCommonDi vi sorMethod . java 

1 import java. util .Scanner; 
2 

3 public class GreatestCommonDi vi sorMethod { 

4 /** Main method */ 

5 public static void main(String[] args) { 

6 // Create a Scanner 

7 Scanner input = new Scanner(System.in) ; 
8 

9 // Prompt the user to enter two integers 

10 System . out . pri nt("Enter first integer: ") ; 

11 int nl = input. nextlntO ; 

12 System . out . pri nt("Enter second integer: ") ; 

13 int n2 = input. nextlntO ; 
14 

15 System. out. pri ntl n("The greatest common divisor for " + nl + 

16 " and " + n2 + " is " + gcd(nl, n2) ); invoke gcd 

17 } 
18 

19 /** Return the gcd of two integers */ 

20 public static int gcd(int nl, int n2) { compute gcd 

21 int gcd = 1; // Initial gcd is 1 

22 int k = 2; // Possible gcd 
23 

24 while (k <= nl && k <= n2) { 

25 if (nl % k == && n2 % k == 0) 

26 gcd = k; // Update gcd 

27 k++; 

28 } 
29 

30 return gcd; // Return gcd return gcd 

31 } 

32 } 



Enter first integer: 45 h Enter 

Enter second integer: 75 |^ Enter 

The greatest common divisor for 45 and 75 is 15 



By encapsulating the code for obtaining the gcd in a method, this program has several 
advantages: 

1. It isolates the problem for computing the gcd from the rest of the code in the main 
method. Thus, the logic becomes clear and the program is easier to read. 
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invoke printPrimeNumbers 



printPrimeNumbers 

method 



invoke isPrime 



isPrime method 



2. The errors on computing gcd are confined in the gcd method, which narrows the scope 
of debugging. 

3. The gcd method now can be reused by other programs. 

Listing 5.7 applies the concept of code modularization to improve Listing 4.14, PrimeNum- 
ber.java. 

Listing 5.7 PrimeNumberMethod. java 



1 

2 
3 
4 
5 
6 
7 
8 
9 
10 
11 
12 
13 
14 
15 
16 
17 
18 
19 
20 
21 
22 
23 
24 
25 
26 
27 
28 
29 
30 
31 
32 
33 
34 
35 
36 
37 
38 
39 
40 
41 



public class PrimeNumberMethod { 

public static void main(String[] args) { 

System. out. pri ntl n("The first 50 prime numbers are \n") ; 
pri ntPrimeNumbers(50) ; 

} 

public static void printPrimeNumbers(int numberOfPrimes) { 

final int NUMBERJ3F_PRIMES_PER_LINE = 10; // Display 10 per line 
int count = 0; // Count the number of prime numbers 
int number =2; //A number to be tested for primeness 

// Repeatedly find prime numbers 
while (count < numberOfPrimes) { 

// Print the prime number and increase the count 

if (isPrime(number) ) { 

count++; // Increase the count 



if (count % NUMBER_OF_PRIMES_PER_LINE == 
// Print the number and advance to the 
System. out. pri ntf ("%-5s\n" , number) ; 

} 

el se 

System .out . pri ntf ("%-5s" , number) ; 



0) { 

new line 



} 



// Check whether the 
number++; 



next number is prime 



} 
} 

/** Check whether number is prime */ 
public static boolean isPrime(int number) { 
for (int divisor = 2; divisor <= number / 2; 



if (number % divisor == 0) { // If 
return false; // number is not a 

} 



return true; // number is prime 



true, number 
prime 



divisor++) { 

is not prime 



The 


fi rst 


50 prime 


numbers are 








2 


3 


5 7 


11 13 17 


19 


23 


29 


31 


37 


41 43 


47 53 59 


61 


67 


71 


73 


79 


83 89 


97 101 103 


107 


109 


113 


127 


131 


137 139 


149 151 157 


163 


167 


173 


179 


181 


191 193 


197 199 211 


223 


227 


229 
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We divided a large problem into two subproblems. As a result, the new program is easier to 
read and easier to debug. Moreover, the methods printPrimeNumbers and isPrime can be 
reused by other programs. 



5.7 Problem: Converting Decimals to Hexadecimals 

Hexadecimals are often used in computer systems programming. Appendix F introduces 
number systems. This section presents a program that converts a decimal to a hexadecimal. 

To convert a decimal number d to a hexadecimal number is to find the hexadecimal digits 
h n , h n -x, h n -2, ■ ■ ■ , h.2, hi, and Iiq such that 

d = h n X 16" + h n - x X 16"" 1 + h n - 2 X 16"" 2 + . . . 
+ h 2 X 16 2 + h x X 16 1 + h X 16° 

These numbers can be found by successively dividing d by 16 until the quotient is 0. The 
remainders are /zq, hi, h 2 , h n - 2 , h n -\, and h„. 

For example, the decimal number 123 is 7B in hexadecimal. The conversion is done as fol- 
lows: 




Listing 5.8 gives a program that prompts the user to enter a decimal number and converts 
it into a hex number as a string. 

Listing 5.8 Decimal2HexConversion. java 

1 import java. util .Scanner; 
2 

3 public class Decimal 2HexConversion { 

4 /** Main method */ 

5 public static void main(String[] args) { 

6 // Create a Scanner 

7 Scanner input = new Scanner(System.in) ; 
8 

9 // Prompt the user to enter a decimal integer 

10 System . out . pri nt("Enter a decimal number: ") ; 

11 int decimal = i nput . nextlntO ; input string 
12 

13 System. out. println("The hex number for decimal " + 

14 decimal + " is " + decimalToHex (decimal) ) ; hex to decimal 

15 } 
16 

17 /** Convert a decimal to a hex as a string */ 

18 public static String decimalToHex(int decimal) { 

19 String hex = ""; 
20 

21 while (decimal != 0) { 

22 int hexValue = decimal % 16; 

23 hex = toHexChar(hexValue) + hex; 

24 decimal = decimal / 16; 
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hex char to decimal 
to uppercase 



25 
26 
27 
28 
29 
30 
31 
32 
33 
34 
35 
36 

37 } 



return hex; 

} 

/** Convert an integer to a single hex digit in a character */ 
public static char toHexChar(int hexValue) { 
if (hexValue <= 9 && hexValue >= 0) 

return (char) (hexVal ue + '0') ; 
else // hexValue <= 15 && hexValue >= 10 
return (char) (hexVal ue - 10 + 'A'); 

} 




Enter a decimal number: 1234 Renter 
The hex number for decimal 1234 is 4D2 





line# 


decimal 


hex 


hexValue 


toHexChar(hexValue) 




19 


1234 










" 22 






2 




iteration 1 -< 






"2" 




2 




L 24 


77 










" 22 






13 




iteration 2 "< 






"D2" 




D 




L 24 


4 










" 22 






4 




iteration 3 ■< 


23 




"4D2" 
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The program uses the decimalToHex method (lines 18-28) to convert a decimal integer to a 
hex number as a string. The method gets the remainder of the division of the decimal integer 
by 16 (line 22). The remainder is converted into a character by invoking the toHexChar 
method (line 23). The character is then appended to the hex string (line 23). The hex string is 
initially empty (line 19). Divide the decimal number by 16 to remove a hex digit from the 
number (line 24). The method repeatedly performs these operations in a loop until quotient 
becomes (lines 21-25). 

The toHexChar method (lines 31-36) converts a hexVal ue between and 15 into a hex 
character. If hexValue is between and 9, it is converted to (char) (hexVal ue + '0') 
(line 33). Recall when adding a character with an integer, the character's Unicode is used in 
the evaluation. For example, if hexVal ue is 5, (char) (hexVal ue + ' ' ) returns ' 5 1 . Sim- 
ilarly, if hexValue is between 10 and 15, it is converted to (char) (hexValue + 'A' ) (line 
35). For example, if hexValue is 11, (char) (hexVal ue + 'A') returns 'B'. 



5.8 Overloading Methods 

The max method that was used earlier works only with the int data type. But what if you 
need to determine which of two floating-point numbers has the maximum value? The solution 



5.8 Overloading Methods 



is to create another method with the same name but different parameters, as shown in the fol- 
lowing code: 

public static double max(double numl, double num2) { 
if (numl > num2) 

return numl; 
el se 

return num2; 

} 

If you call max with int parameters, the max method that expects int parameters will be 
invoked; if you call max with doubl e parameters, the max method that expects doubl e para- 
meters will be invoked. This is referred to as method overloading; that is, two methods have method overloading 
the same name but different parameter lists within one class. The Java compiler determines 
which method is used based on the method signature. 

Listing 5.9 is a program that creates three methods. The first finds the maximum integer, 
the second finds the maximum double, and the third finds the maximum among three double 
values. All three methods are named max. 

Listing 5.9 TestMethodOverloading. java 

1 public class TestMethodOverloading { 



2 /■'* Main method */ 

3 public static void main(String[] args) { 

4 // Invoke the max method with int parameters 

5 System. out. println ("The maximum between 3 and 4 is " 

6 + max(3, 4) ) ; 
7 

8 // Invoke the max method with the double parameters 

9 System. out. println ("The maximum between 3.0 and 5.4 is " 
10 + max(3.0, 5.4)); 

11 

12 // Invoke the max method with three double parameters 

13 System. out. pri ntl n("The maximum between 3.0, 5.4, and 10.14 is " 

14 + max(3.0, 5.4, 10.14) ) ; 

15 } 
16 

17 /** Return the max between two int values */ 

18 public static int max(int numl, int num2) { overloaded max 

19 if (numl > num2) 

20 return numl; 

21 else 

22 return num2; 

23 } 
24 

2 5 /** Find the max between two double values */ 

26 public static double max(double numl, double num2) { overloaded max 

27 if (numl > num2) 

28 return numl; 

29 else 

30 return num2; 

31 } 
32 

33 /** Return the max among three double values */ 

34 public static double max(double numl, double num2, double num3) { overloaded max 

35 return max(max(numl, num2) , num3) ; 

36 } 



37 } 
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The 


maxi mum 


between 


3 


and 4 is 4 




The 


maxi mum 


between 


3 


and 5.4 is 5 


4 


The 


maxi mum 


between 


3 


0, 5.4, and 10 


14 is 10.14 



When calling max (3 , 4) (line 6), the max method for finding the maximum of two integers is 
invoked. When calling max(3 . , 5.4) (line 10), the max method for finding the maximum of 
two doubles is invoked. When calling max (3 . , 5.4, 10 . 14) (line 14), the max method for 
finding the maximum of three double values is invoked. 

Can you invoke the max method with an i nt value and a doubl e value, such as max(2 , 
2 . 5) ? If so, which of the max methods is invoked? The answer to the first question is yes. The 
answer to the second is that the max method for finding the maximum of two doubl e values 
is invoked. The argument value 2 is automatically converted into a doubl e value and passed 
to this method. 

You may be wondering why the method max (doubl e , doubl e) is not invoked for the call 
max(3, 4). Both max(double, double) and max(int, int) are possible matches for 
max(3 , 4). The Java compiler finds the most specific method for a method invocation. Since 
the method max(int, int) is more specific than max (double, double), max(int, int) 
is used to invoke max (3 , 4). 

§ Note 

Overloaded methods must have different parameter lists. You cannot overload methods based on 
different modifiers or return types. 

® Note 

Sometimes there are two or more possible matches for an invocation of a method, but the corn- 
ambiguous invocation piler cannot determine the most specific match. This is referred to as ambiguous invocation. 

Ambiguous invocation causes a compile error. Consider the following code: 

public class Ambi guousOverl oadi ng { 

public static void main(String[] args) { 
System. out. println(max(l, 2)); 

} 

public static double max(int numl, double num2) { 
if (numl > num2) 

return numl; 
el se 

return num2; 

} 

public static double max(double numl, int num2) { 
if (numl > num2) 

return numl; 
el se 

return num2; 

} 

} 

Both max(int, double) and max(double, int) are possible candidates to match 
max(l, 2). Since neither is more specific than the other, the invocation is ambiguous, 
resulting in a compile error. 
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5.9 The Scope of Variables 

The scope of a variable is the part of the program where the variable can be referenced. A 
variable defined inside a method is referred to as a local variable. 

The scope of a local variable starts from its declaration and continues to the end of the 
block that contains the variable. A local variable must be declared and assigned a value before 
it can be used. 

A parameter is actually a local variable. The scope of a method parameter covers the entire 
method. 

A variable declared in the initial-action part of a for-loop header has its scope in the entire 
loop. But a variable declared inside a for-loop body has its scope limited in the loop body 
from its declaration to the end of the block that contains the variable, as shown in Figure 5.5. 

public static void methodlO { 
- for (int 7 = 1; i < 10; i++) { 



local variable 



The scope of i 
The scope of j 



nt j; 



} 

Figure 5.5 A variable declared in the initial action part of a for-loop header has its scope 
in the entire loop. 

You can declare a local variable with the same name in different blocks in a method, but you 
cannot declare a local variable twice in the same block or in nested blocks, as shown in Figure 5.6. 



It is fine to declare 1 in two 
nonnested blocks 



— It is wrong to declare i in two 
nested blocks 



public static 


void methodlO { 






int x = 1; 








int y = 1; 








for (int i 


= 1; i < 10; i++) 


{ 


->■ 


x += i ; 








} 






\ 


for (int i 


= 1; i < 10; 


{ 




y += i ; 








} 






} 









public static void method2() { 

int i = 1; 

int sum = 0; 

for (int 7=1; i < 10; 
sum += i ; 

} 



} 



Figure 5.6 A variable can be declared multiple times in nonnested blocks but only once in nested blocks. 
ij§| Caution 

Do not declare a variable inside a block and then attempt to use it outside the block. Here is an 
example of a common mistake: 

for (int i = 0; i < 10; { 

} 



System. out. print! n(i) ; 
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The last statement would cause a syntax error, because variable i is not defined outside of the 
for loop. 



5.10 The Math Class 

The Math class contains the methods needed to perform basic mathematical functions. You 
have already used the pow(a, b) method to compute a b in Listing 2.8, ComputeLoan.java, 
and the Math . random () method in Listing 3.4, SubtractionQuiz.java. This section intro- 
duces other useful methods in the Math class. They can be categorized as trigonometric meth- 
ods, exponent methods, and service methods. Besides methods, the Math class provides two 
useful double constants, PI and E (the base of natural logarithms). You can use these con- 
stants as Math . PI and Math . E in any program. 



5.10.1 Trigonometric Methods 

The Math class contains the following trigonometric methods: 

/** Return the trigonometric sine of an angle in radians */ 
public static double sin (double radians) 

/** Return the trigonometric cosine of an angle in radians */ 
public static double cos (double radians) 

/** Return the trigonometric tangent of an angle in radians */ 
public static double tan (double radians) 

/** Convert the angle in degrees to an angle in radians */ 
public static double toRadians (double degree) 

/** Convert the angle in radians to an angle in degrees */ 
public static double toDegrees (double radians) 

/** Return the angle in radians for the inverse of sin */ 

public static double asin (double a) 

/** Return the angle in radians for the inverse of cos */ 

public static double acos (double a) 

/** Return the angle in radians for the inverse of tan */ 

public static double atan (double a) 

The parameter for sin, cos, and tan is an angle in radians. The return value for asi n, acos, 
and atan is a degree in radians in the range between —ir/2 and tt/2. One degree is equal to 
77 / 180 in radians, 90 degrees is equal to tt/2 in radians, and 30 degrees is equal to 77/6 in 
radians. 

For example, 



Math.toDegrees(Math.PI / 2) returns 90.0 
Math.toRadians(30) returns 71/6 
Math.sin(O) returns 0.0 

Math.sin(Math.toRadians(270)) returns -1.0 

Math. sin (Math. PI / 6) returns 0.5 

Math. sin (Math. PI / 2) returns 1.0 

Math.cos(O) returns 1.0 

Math. cos (Math. PI / 6) returns 0.866 

Math. cos (Math. PI / 2) returns 

Math . asi n(0. S) returns 71/6 
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5.10.2 Exponent Methods 

There are five methods related to exponents in the Math class: 

/** Return e raised to the power of x (e x ) */ 
public static double exp (double x) 

/** Return the natural logarithm of x (ln(x) = log e (x)) */ 
public static double log (double x) 

/** Return the base 10 logarithm of x (log 10 (x)) */ 
public static double loglO (double x) 

/** Return a raised to the power of b (a b ) */ 
public static double pow(double a, double b) 

/** Return the square root of x (Vx) for x >= */ 
public static double sqrt (double x) 

For example, 

Math.exp(l) returns 2.71828 
Math . log (Math . E) returns 1.0 
Math. log 10 (10) returns 1.0 
Math . pow(2 , 3) returns 8.0 
Math . pow(3 , 2) returns 9.0 
Math.pow(3. 5, 2.5) returns 22.91765 
Math.sqrt(4) returns 2.0 
Math.sqrt(10.5) returns 3.24 

5.10.3 The Rounding Methods 

The Math class contains five rounding methods: 

/** x is rounded up to its nearest integer. This integer is 

* returned as a double value. */ 
public static double ceil (double x) 

/** x is rounded down to its nearest integer. This integer is 

* returned as a double value. */ 
public static double floor (double x) 

/** x is rounded to its nearest integer. If x is equally close 

* to two integers, the even one is returned as a double. */ 
public static double rint (double x) 

/** Return (i nt)Math . fl oor(x +0.5). */ 
public static int round(float x) 

/** Return (long)Math.floor(x + 0.5). */ 
public static long round(double x) 

For example, 

Math. ceil (2.1) returns 3.0 
Math. ceil (2.0) returns 2.0 
Math. ceil (-2.0) returns -2.0 
Math . cei 1 (-2 . 1) returns -2.0 
Math . floor(2 . 1) returns 2.0 
Math.floor(2.0) returns 2.0 
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Math.floor(-2.0) returns -2.0 

Math . floor(-2 . 1) returns -3.0 

Math . ri nt(2 . 1) returns 2.0 

Math . ri nt(-2 .0) returns -2.0 

Math . ri nt(-2 . 1) returns -2.0 

Math . ri nt(2 . 5) returns 2.0 

Math . ri nt(3 . 5) returns 4.0 

Math . ri nt(-2 . 5) returns -2.0 

Math. round (2. 6f) returns 3 // Returns int 

Math . round (2 .0) returns 2 // Returns long 

Math . round(-2 .Of) returns -2 

Math. round(-2.6) returns -3 



5.10.4 The mi n, max, and abs Methods 

The min and max methods are overloaded to return the minimum and maximum numbers 
between two numbers (int, long, float, or double). For example, max(3.4, 5.0) 
returns 5 .0, and min(3 , 2) returns 2. 

The abs method is overloaded to return the absolute value of the number (int, long, 
f 1 oat, and doubl e). For example, 

Math.max(2, 3) returns 3 
Math . max (2 . 5 , 3) returns 3.0 
Math . mi n(2 . 5 , 3.6) returns 2.5 
Math.abs(-2) returns 2 
Math. abs (-2.1) returns 2.1 

5.10.5 The random Method 

You have used the random () method to generate a random doubl e value greater than or equal to 
0.0 and less than 1.0 (0 <= Math . random () < 1 . 0). This method is very useful. You can use it to 
write a simple expression to generate random numbers in any range. For example, 

, . ^. ... , , , . . Returns a random integer 

(int) (Math, randomf ) * 10) > 5 

y ' y y ' ' between and 9 

50 + (int) (Math.random( ) * 50) > Returns a random integer 

between 50 and 99 



In general, 



Returns a random number between 
a + Math.random( ) * b — a and a + b excluding a + b 
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Figure 5.7 You can view the documentation for Java API online. 



5.1 I Case Study: Generating Random Characters 



# Tip 

You can view the complete documentation for the Math class online at http://java.sun.com/ 
javase/6/docs/api/index.html, as shown in Figure 5.7. 

tj| Note 

" Not all classes need a main method. The Math class and JOptionPane class do not have 
main methods. These classes contain methods for other classes to use. 

5.1 1 Case Study: Generating Random Characters 

Computer programs process numerical data and characters. You have seen many examples 
that involve numerical data. It is also important to understand characters and how to process 
them. This section presents an example for generating random characters. 

As introduced in §2.13, every character has a unique Unicode between and FFFF in 
hexadecimal (65535 in decimal). To generate a random character is to generate a random inte- 
ger between and 65535 using the following expression (note that since <= Math . ran- 
dom() < 1 . 0, you have to add 1 to 65535): 

(int) (Math. random () * (65535 + 1)) 

Now let us consider how to generate a random lowercase letter. The Unicodes for lowercase 
letters are consecutive integers starting from the Unicode for ' a ' , then that for ' b ' , 1 c ' , . . . , 
and ' z ' . The Unicode for 1 a ' is 

(int) 'a' 

So a random integer between (i nt) ' a ' and (int) ' z ' is 

(int) ((int) 'a' + Math . random () * ((int)'z' - (int) 'a' + 1) 

As discussed in §2.13.3, all numeric operators can be applied to the char operands. The char 
operand is cast into a number if the other operand is a number or a character. Thus the pre- 
ceding expression can be simplified as follows: 

'a' + Math.randomO * ('z' - 'a' + 1) 

and a random lowercase letter is 

(char)Ca' + Math.randomO * ('z' - 'a' + 1)) 

To generalize the foregoing discussion, a random character between any two characters chl 
and ch2 with chl < ch2 can be generated as follows: 

(char) (chl + Math.randomO * (ch2 - chl + 1)) 

This is a simple but useful discovery. Let us create a class named RandomCharacter in List- 
ing 5.10 with five overloaded methods to get a certain type of character randomly. You can 
use these methods in your future projects. 

Listing 5.10 RandomCharacter . java 

1 public class RandomCharacter { 

2 /** Generate a random character between chl and ch2 */ 

3 public static char getRandomCharacter(char chl, char ch2) { getRandomCharacter 

4 return (char) (chl + Math.randomO * (ch2 - chl + 1)); 

5 } 



6 

7 /** Generate a random lowercase letter */ 

8 public static char getRandomLowerCaseLetter O { 

9 return getRandomCharacter('a' , 'z'); 
10 } 

11 

12 /** Generate a random uppercase letter */ 

13 public static char getRandomUpperCaseLetter O { 

14 return getRandomCharacter('A' , 'Z'); 

15 } 
16 

17 /** Generate a random digit character */ 

18 public static char getRandomDigitCharacterO { 

19 return getRandomCharacter('0' , '9'); 

20 } 
21 

22 /** Generate a random character */ 

23 public static char getRandomCharacterO { 

24 return getRandomCharacter('\uOOOO' , ' \uFFFF' ) ; 

25 } 

26 } 

Listing 5.11 gives a test program that displays 175 random lowercase letters. 

Listing 5.1 1 TestRandomCharacter. java 

1 public class TestRandomCharacter { 

2 /** Main method */ 

3 public static void main(String[] args) { 

4 final int NUMBER_OF_CHARS =175; 

5 final int CHARS_PER__LINE = 25; 
6 

7 // Print random characters between 'a' and 'z', 25 chars per line 

8 for (int i = 0; i < NUMBER_OF_CHARS ; i++) { 

9 char ch = RandomCharacter . getRandomLowerCaseLetterO ; 

10 if ((i + 1) % CHARS_PER_LINE == 0) 

11 System. out. println(ch) ; 

12 el se 

13 System . out . pri nt(ch) ; 

14 } 

15 } 

16 } 



gmjsohezfkgtazqgmswfcl rao 
pnrunul nwmaztl f jedmpchci f 
lalqdgivxkxpbzul rmqmbhi kr 
1 bnr jl sopfxahssqhwuul jvbe 
xbhdotzhpehbqmuwsf ktwsol i 
cbuwkzgxpmtzi hgatdsl vbwbz 
bfesoklwbhnooygi i gzdxuqni 



Line 9 invokes getRandomLowerCaseLetterO defined in the RandomCharacter class. 
Note that getRandomLowerCaseLetterO does not have any parameters, but you still have 
to use the parentheses when defining and invoking the method. 

5.12 Method Abstraction and Stepwise Refinement 

The key to developing software is to apply the concept of abstraction. You will learn many lev- 
els of abstraction from this book. Method abstraction is achieved by separating the use of a 
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method from its implementation. The client can use a method without knowing how it is imple- 
mented. The details of the implementation are encapsulated in the method and hidden from the 
client who invokes the method. This is known as information hiding or encapsulation. If you information hiding 
decide to change the implementation, the client program will not be affected, provided that you 
do not change the method signature. The implementation of the method is hidden from the 
client in a "black box," as shown in Figure 5.8. 

Optional arguments Optional return 
for input value 



-< Black box 



Figure 5.8 The method body can be thought of as a black box that contains the detailed 
implementation for the method. 

You have already used the System. out. print method to display a string, the 
JOptionPane. showInputDialog method to read a string from a dialog box, and the max 
method to find the maximum number. You know how to write the code to invoke these meth- 
ods in your program, but as a user of these methods, you are not required to know how they 
are implemented. 

The concept of method abstraction can be applied to the process of developing programs. 
When writing a large program, you can use the divide-and-conquer strategy, also known as 
stepwise refinement, to decompose it into subproblems. The subproblems can be further 
decomposed into smaller, more manageable problems. 

Suppose you write a program that displays the calendar for a given month of the year. The 
program prompts the user to enter the year and the month, then displays the entire calendar for 
the month, as shown in the following sample run: 
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Let us use this example to demonstrate the divide-and-conquer approach. 

5.12.1 Top-Down Design 

How would you get started on such a program? Would you immediately start coding? Begin- 
ning programmers often start by trying to work out the solution to every detail. Although 
details are important in the final program, concern for detail in the early stages may block the 
problem-solving process. To make problem solving flow as smoothly as possible, this exam- 
ple begins by using method abstraction to isolate details from design and only later imple- 
ments the details. 
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For this example, the problem is first broken into two subproblems: get input from the 
user, and print the calendar for the month. At this stage, you should be concerned with what 
the subproblems will achieve, not with how to get input and print the calendar for the month. 
You can draw a structure chart to help visualize the decomposition of the problem (see 
Figure 5.9(a)). 



pri ntCal endar 
(mai n) 



f 



pri ntMonth | 



1 



f 



1 



readlnput printMonth printMonthTitle [ printMonthBody | 



00 (b) 

Figure 5.9 The structure chart shows that the pri ntCal endar problem is divided into two subproblems, readlnput and 
printMonth, and that printMonth is divided into two smaller subproblems, printMonthTitle and printMonthBody. 



The problem of printing the calendar for a given month can be broken into two subprob- 
lems: print the month title, and print the month body, as shown in Figure 5.9(b). The month 
title consists of three lines: month and year, a dash line, and the names of the seven days of the 
week. You need to get the month name (e.g., January) from the numeric month (e.g., 1). This 
is accomplished in getMonthName (see Figure 5.10(a)). 



printMonthBody | 



printMonthTitle | 

getMonthName | getStartDay getNumberOfDaysInMonth [ 

(a) (b) 

Figure 5.10 (a) To printMonthTitle, you need getMonthName. (b) The printMonthBody 

problem is refined into several smaller problems. 



In order to print the month body, you need to know which day of the week is the first day of 
the month (getStartDay) and how many days the month has (getNumberOfDaysInMonth), 
as shown in Figure 5.10(b). For example, December 2005 has 31 days, and December 1, 2005, 
is Thursday. 

How would you get the start day for the first date in a month? There are several ways to do 
so. For now, we'll use the following approach. Assume you know that the start day 
(startDay!800 = 3) for Jan 1, 1800, was Wednesday. You could compute the total number of 
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Figure 5.1 1 (a) To getStartDay, you need getTotal NumberOfDays. (b) The 
getTotal NumberOfDays problem is refined into two smaller problems. 
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days (total NumberOf Days) between Jan 1, 1800, and the first date of the calendar month. The 
start day for the calendar month is (total NumberOf Days + startDayl800) % 7, since every 
week has seven days. So the getStartDay problem can be further refined as 
getTotal NumberOfDays, as shown in Figure 5.1 1(a). 

To get the total number of days, you need to know whether the year is a leap year and the 
number of days in each month. So getTotal NumberOfDays is further refined into two sub- 
problems: isLeapYear and getNumberOfDaysInMonth, as shown in Figure 5.11(b). The 
complete structure chart is shown in Figure 5.12. 

pri ntCal endar 
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readlnput printMonth 



printMonthTitle pri ntMonthBody 
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Figure 5.12 The structure chart shows the hierarchical relationship of the subproblems in 
the program. 



5.12.2 Top-Down or Bottom-Up Implementation 

Now we turn our attention to implementation. In general, a subproblem corresponds to a 
method in the implementation, although some are so simple that this is unnecessary. You 
would need to decide which modules to implement as methods and which to combine in other 
methods. Decisions of this kind should be based on whether the overall program will be eas- 
ier to read as a result of your choice. In this example, the subproblem readlnput can be sim- 
ply implemented in the mai n method. 

You can use either a "top-down" or a "bottom-up" approach. The top-down approach imple- top-down approach 
ments one method in the structure chart at a time from the top to the bottom. Stubs can be used for 
the methods waiting to be implemented. A stub is a simple but incomplete version of a method, stub 
The use of stubs enables you to quickly build the framework of the program. Implement the mai n 
method first, then use a stub for the pri ntMonth method. For example, let pr i ntMonth display 
the year and the month in the stub. Thus, your program may begin like this: 

public class Pri ntCal endar { 

/** Main method */ 

public static void main(String[] args) { 
Scanner input = new Scanner(System.in) ; 

// Prompt the user to enter year 

System . out . pri nt("Enter full year (e.g., 2001): ") ; 
int year = i nput . nextlntQ ; 



180 Chapter 5 



Methods 



// Prompt the user to enter month 

System . out . pri nt("Enter month as number between 1 and 12: ") ; 
int month = input. nextlntO ; 

// Print calendar for the month of the year 
printMonth(year, month); 

} 

/** A stub for printMonth may look like this */ 
public static void pri ntMonth(int year, int month) { 
System. out. pri nt(month + " " + year); 

} 

/** A stub for pri ntMonthTi tl e may look like this */ 
public static void pri ntMonthTi tl e(int year, int month) { 
} 

/** A stub for getMonthBody may look like this */ 
public static void pri ntMonthBody(int year, int month) { 

} 

/** A stub for getMonthName may look like this */ 
public static String getMonthName(int month) { 
return "January"; // A dummy value 

} 

/** A stub for getMonthName may look like this */ 
public static int getStartDay(int year, int month) { 
return 1; //A dummy value 

} 

/** A stub for getTotal NumberOfDays may look like this */ 
public static int getTotalNumberOfDays(int year, int month) { 
return 10000; // A dummy value 

} 

/** A stub for getNumberOfDaysInMonth may look like this */ 
public static int getNumberOfDaysInMonth(int year, int month) { 
return 31; //A dummy value 

} 

/** A stub for getTotal NumberOfDays may look like this */ 
public static boolean i sLeapYear(int year) { 
return true; // A dummy value 

} 

} 

Compile and test the program, and fix any errors. You can now implement the printMonth 
method. For methods invoked from the printMonth method, you can again use stubs, 
bottom-up approach The bottom-up approach implements one method in the structure chart at a time from the bot- 

tom to the top. For each method implemented, write a test program to test it. The top-down and 
bottom-up approaches are both fine. Both approaches implement methods incrementally, help to 
isolate programming errors, and make debugging easy. Sometimes they can be used together. 

5.12.3 Implementation Details 

The isLeapYear(int year) method can be implemented using the following code: 
return (year % 400 == | | (year % 4 == && year % 100 != 0)); 
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Use the following facts to implement getTotalNumberOfDaysInMonth(int year , int 
month): 

■ January, March, May, July, August, October, and December have 31 days. 

■ April, June, September, and November have 30 days. 

■ February has 28 days during a regular year and 29 days during a leap year. A regular 
year, therefore, has 365 days, a leap year 366 days. 

To implement getTotal NumberOf Days (int year, int month), you need to compute 
the total number of days (total NumberOf Days) between January 1, 1800, and the first day 
of the calendar month. You could find the total number of days between the year 1800 and the 
calendar year and then figure out the total number of days prior to the calendar month in the 
calendar year. The sum of these two totals is total NumberOf Days. 

To print a body, first pad some space before the start day and then print the lines for every 
week. 

The complete program is given in Listing 5.12. 

Listing 5.12 PrintCalendar. java 

1 import java. uti 1 . Scanner ; 
2 

3 public class PrintCalendar { 

4 /** Main method */ 

5 public static void main(String[] args) { 

6 Scanner input = new Scanner(System.in) ; 
7 

8 // Prompt the user to enter year 

9 System. out. print("Enter full year (e.g., 2001): ") ; 
10 int year = i nput . nextlnt () ; 

11 

12 // Prompt the user to enter month 

13 System. out. print("Enter month in number between 1 and 12: ") ; 

14 int month = i nput . nextlntO ; 
15 

16 // Print calendar for the month of the year 

17 printMonth(year, month); 

18 } 
19 

20 /** Print the calendar for a month in a year */ 

21 public static void pri ntMonth(int year, int month) { printMonth 

22 // Print the headings of the calendar 

23 pri ntMonthTi tie (year, month); 
24 

25 // Print the body of the calendar 

26 pri ntMonthBody(year , month); 

27 } 
28 

29 /** Print the month title, e.g., May, 1999 */ 

30 public static void printMonthTitle(int year, int month) { pri ntMonthTi tie 

31 System. out. println(" " + getMonthName(month) 

32 + " " + year); 

33 System. out. println(" ") ; 

34 System. out. pri ntln(" Sun Mon Tue Wed Thu Fri Sat"); 

35 } 
36 

37 /** Get the English name for the month */ 

38 public static String getMonthName(int month) { getMonthName 

39 String monthName = " "; 
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getMonthBody 
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switch 
case 
case 
case 
case 
case 
case 
case 
case 
case 
case 
case 
case 

} 



(month) { 



monthName = 
monthName = 
monthName = 
monthName = 
monthName = 
monthName = 
monthName = 
monthName = 
monthName = 
monthName 
monthName 
monthName 



'January"; break; 
'February"; break; 
'March"; break; 
'April"; break; 
'May"; break; 
'June"; break; 
'July"; break; 
'August"; break; 
'September"; break; 

"October"; break; 

"November"; break; 

"December"; 



return monthName; 



/** Print month body */ 

public static void pri ntMonthBody (int year, int month) { 

// Get start day of the week for the first date in the month 
int startDay = getStartDay (year , month) ; 

// Get number of days in the month 

int numberOfDaysInMonth = getNumberOfDaysInMonth(year, month) ; 

// Pad space before the first day of the month 
int i = 0; 

for (i =0; i < startDay; i++) 
System . out . pri nt(" ") ; 

for (i =1; i <= numberOfDaysInMonth; i++) { 
System. out. pri ntf("%4d", i); 



if ((i + startDay) % 7 == 0) 
System. out . pri ntl n() ; 



System . out . pri ntl n () ; 



/** Get the start day of month/l/year */ 
public static int getStartDay(int year, int month) { 
final int START_DAY_F0R_JAN_1_1800 = 3; 

// Get total number of days from 1/1/1800 to month/l/year 
int total NumberOfDays = getTotalNumberOfDays(year, month); 

// Return the start day for month/l/year 

return (total NumberOfDays + START_DAY_FOR_JAN_1_1800) % 7; 

} 

/** Get the total number of days since January 1, 1800 */ 
public static int getTotal NumberOfDays (int year, int month) 
int total = 0; 

// Get the total days from 1800 to 1/1/year 
for (int i = 1800; i < year; i++) 
if (isLeapYear(i)) 
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98 total = total + 366; 

99 else 

100 total = total + 365; 
101 

102 // Add days from Jan to the month prior to the calendar month 

103 for (int i =1; i < month; i++) 

104 total = total + getNumberOfDaysInMonth(year, i); 
105 

106 return total ; 



107 } 
108 

109 /** Get the number of days in a month */ 

110 public static int getNumberOfDaysInMonth(int year, int month) { getNumberOfDaysInMonth 

111 if (month == 1 | | month == 3 | | month == 5 | | month == 7 | | 

112 month == 8 | | month ==10 | | month == 12) 

113 return 31; 
114 

115 if (month == 4 | | month == 6 | | month == 9 | | month == 11) 

116 return 30; 
117 

118 if (month == 2) return i sLeapYear(year) ? 29 : 28; 
119 

120 return 0; // If month is incorrect 

121 } 
122 

123 /** Determine if it is a leap year */ 

124 public static boolean i sLeapYear(int year) { isLeapYear 

125 return year % 400 ===== | | (year % 4 == && year % 100 != 0); 

126 } 

127 } 

The program does not validate user input. For instance, if the user enters either a month not in 
the range between 1 and 12 or a year before 1800, the program displays an erroneous calen- 
dar. To avoid this error, add an i f statement to check the input before printing the calendar. 

This program prints calendars for a month but could easily be modified to print calendars 
for a whole year. Although it can print months only after January 1800, it could be modified 
to trace the day of a month before 1800. 

|p Note 

Method abstraction modularizes programs in a neat, hierarchical manner. Programs written as 
collections of concise methods are easier to write, debug, maintain, and modify. This writing style 
also promotes method reusability. 

incremental development and 

M Tip testing 
When implementing a large program, use the top-down or bottom-up approach. Do not write the 
entire program at once. Using these approaches seems to take more development time (because you 
repeatedly compile and run the program), but it actually saves time and makes debugging easier. 
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method abstraction 176 
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method overloading 169 
method signature 157 
modifier 157 
pass-by- value 163 
parameter 157 



return type 170 
return value 157 
scope of variable 171 
stepwise refinement 177 
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Chapter Summary 



1 . Making programs modular and reusable is one of the central goals in software engi- 
neering. Java provides many powerful constructs that help to achieve this goal. 
Methods are one such construct. 

2. The method header specifies the modifiers, return value type, method name, and 
parameters of the method. The static modifier is used for all the methods in this 
chapter. 

3. A method may return a value. The returnVal ueType is the data type of the value 
the method returns. If the method does not return a value, the returnVal ueType is 
the keyword void. 

4. The parameter list refers to the type, order, and number of the parameters of a 
method. The method name and the parameter list together constitute the method sig- 
nature. Parameters are optional; that is, a method may contain no parameters. 

5. A return statement can also be used in a void method for terminating the method 
and returning to the method's caller. This is useful occasionally for circumventing 
the normal flow of control in a method. 

6. The arguments that are passed to a method should have the same number, type, and 
order as the parameters in the method signature. 

7. When a program calls a method, program control is transferred to the called method. 
A called method returns control to the caller when its return statement is executed or 
when its method-ending closing brace is reached. 

8. A value-returning method can also be invoked as a statement in Java. In this case, the 
caller simply ignores the return value. 

9. Each time a method is invoked, the system stores parameters and local variables 
in a space known as a stack. When a method calls another method, the caller's 
stack space is kept intact, and new space is created to handle the new method call. 
When a method finishes its work and returns to its caller, its associated space is 
released. 

10. A method can be overloaded. This means that two methods can have the same name, 
as long as their method parameter lists differ. 

11. A variable declared in a method is called a local variable. The scope of a local 
variable starts from its declaration and continues to the end of the block that con- 
tains the variable. A local variable must be declared and initialized before it is 
used. 
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1 2 . Method abstraction is achieved by separating the use of a method from its imple- 
mentation. The client can use a method without knowing how it is implemented. The 
details of the implementation are encapsulated in the method and hidden from the 
client who invokes the method. This is known as information hiding or 
encapsulation. 

I 3. Method abstraction modularizes programs in a neat, hierarchical manner. Programs 
written as collections of concise methods are easier to write, debug, maintain, and 
modify than would otherwise be the case. This writing style also promotes method 
reusability. 

14- When implementing a large program, use the top-down or bottom-up coding 
approach. Do not write the entire program at once. This approach seems to take more 
time for coding (because you are repeatedly compiling and running the program), but 
it actually saves time and makes debugging easier. 
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Sections 5.2-5.4 

5 . 1 What are the benefits of using a method? How do you define a method? How do 
you invoke a method? 

5.2 What is the return type of a main method? 

5.3 Can you simplify the max method in Listing 5.1 using the conditional operator? 

5.4 True or false? A call to a method with a void return type is always a statement 
itself, but a call to a value-returning method is always a component of an 
expression. 

5.5 What would be wrong with not writing a return statement in a value-returning 
method? Can you have a return statement in a void method? Does the return 
statement in the following method cause syntax errors? 

public static void xMethod(doubl e x, double y) { 
System. out. println(x + y) ; 
return x + y; 

} 

5.6 Define the terms parameter, argument, and method signature. 

5.7 Write method headers for the following methods: 

■ Computing a sales commission, given the sales amount and the commission 
rate. 

■ Printing the calendar for a month, given the month and year. 

■ Computing a square root. 

■ Testing whether a number is even, and returning true if it is. 

■ Printing a message a specified number of times. 

■ Computing the monthly payment, given the loan amount, number of years, and 
annual interest rate. 

■ Finding the corresponding uppercase letter, given a lowercase letter. 
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5.8 Identify and correct the errors in the following program: 

1 public class Test { 

2 public static methodl(int n, m) { 

3 n += m; 

4 method2(3.4) ; 

5 } 
6 

7 public static int method2(int n) { 

8 if (n > 0) return 1; 

9 else if (n == 0) return 0; 

10 else if (n < 0) return -1; 

11 } 

12 } 

5.9 Reformat the following program according to the programming st yle and docu- 
mentation guidelines proposed in §2.16, "Programming Style and Documenta- 
tion." Use the next-line brace style. 

public class Test { 

public static double methodl(double i, double j) 

{ 

while (i<j) { 
j— I 

} 

return j ; 

} 

} 

Sections 5.5-5.7 

5.10 How is an argument passed to a method? Can the argument have the same name as 
its parameter? 

5.11 What is pass-by-value? Show the result of the following programs: 



public class Test { 

public static void main(String[] args) { 
int max = 0; 
max(l, 2, max); 
System. out. println(max) ; 



public static void max( 

int valuel, int value2, int max) { 
if (valuel > valu 

max = valuel; 
el se 

max = value2; 

} 

} 



public class Test { 

public static void man n(Stri ng [] args) { 
int i = 1; 
while (i <= 6) { 
methodl(i , 2) ; 

} 




public static void methodic 
int i , int num) { 
for (int j = 1; j <= i ; j++) { 
System. out. print(num + " ") ; 
num *= 2; 

} 

System. out . print! nC) ; 



(a) 



(b) 
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public class Test { 

public static void man n(Stri ng [] args) { 

// Initialize times 
int times = 3; 

System. out . pri ntl n("Before the call," 
+ " variable times is " + times); 

// Invoke nPrintln and display times 
nPri ntl n ("Wei come to Dava!", times); 
System. out . pri ntl n("After the call," 
+ " variable times is " + times); 

} 

// Print the message n times 
public static void nPrintln( 

String message, int n) { 
while (n > 0) { 

System. out. println("n = " + n) ; 

System. out. pri ntl n(message) ; 

n— : 



} 



} 



public class Test { 

public static void main(String[] args) { 
int i = 0; 
while (i <= 4) { 
methodl(i ) ; 
i++; 

} 



System. out. println("i is " + i); 



(c) 



} 



public static void methodl(i nt i) { 
do { 

if (i % 3 != 0) 

System . out . pri nt(i + " ") ; 
i — ; 

} 

while (i >= 1) ; 
System. out. printlnQ ; 



(d) 



5.12 For (a) in the preceding question, show the contents of the stack just before the 
method max is invoked, just as max is entered, just before max is returned, and 
right after max is returned. 

Section 5.8 

5.13 What is method overloading? Is it permissible to define two methods that have the 
same name but different parameter types? Is it permissible to define two methods 
in a class that have identical method names and parameter lists but different return 
value types or different modifiers? 

5.14 What is wrong in the following program? 

public class Test { 

public static void method(int x) { 

} 

public static int method(int y) { 
return y; 

} 

} 

Section 5.9 

5.15 Identify and correct the errors in the following program: 

1 public class Test { 

2 public static void mai n(Stri ng [] args) { 

3 nPrintln ("Wei come to Java!", S) ; 

4 } 
5 

6 public static void nPri ntl n(Stri ng message, int n) { 

7 int n = 1; 
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8 
9 
10 

11 } 



for (int i = 0; i < n; i++) 
System. out. println (message) ; 



} 



Section 5.10 

5.16 True or false? The argument for trigonometric methods represents an angle in radians. 

5.1 7 Write an expression that returns a random integer between 34 and 55. Write an 
expression that returns a random integer between and 999. Write an expression 
that returns a random number between 5 . 5 and 55.5. Write an expression that 
returns a random lowercase letter. 

5.18 Evaluate the following method calls: 

(a) Math.sqrt(4) 

(b) Mafh.sin(2 * Math.PI) 

(c) Math.cos(2 * Math.PI) 

(d) Math.pow(2, 2) 

(e) Math.log(Math.E) 

(f) Math.exp(l) 

(g) Math.max(2, Math.min(3, 4)) 

(h) Math.rint(-2.5) 

(i) Math.ceil(^2.5) 
©Math.floor(-2.5) 
(k)Math.round(-2.5F) 
(1) Math.round(-2.5) 
(m) Math.rint(2.5) 

(n) Mafh.ceil(2.5) 

(o) Math.floor(2.5) 

(p) Math.round(2.5F) 

(q) Math.round(2.5) 

(r) Math.round(Math.abs(-2.5)) 

Programming Exercises 

Sections 5.2-5.9 

5.1 (Math: pentagonal numbers) A pentagonal number is defined as n(3n— 1) /2 for 

n = 1,2,..., and so on. So, the first few numbers are 1, 5, 12, 22, Write the 

following method that returns a pentagonal number: 

public static int getPentagonalNumber(int n) 

Write a test program that displays the first 100 pentagonal numbers with 10 num- 
bers on each line. 

5.2* (Summing the digits in an integer) Write a method that computes the sum of the 
digits in an integer. Use the following method header: 

public static int sumDi gits (long n) 

For example, sumDigits(234) returns 9 (2 + 3 + 4). 

(Hint: Use the % operator to extract digits, and the / operator to remove the 
extracted digit. For instance, to extract 4 from 234, use 234 % 10 (=4). To 
remove 4 from 234, use 234 / 10 (= 23). Use a loop to repeatedly extract and 
remove the digit until all the digits are extracted. Write a test program that prompts 
the user to enter an integer and displays the sum of all its digits.) 
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5.3** (Palindrome integer) Write the following two methods 

// Return the reversal of an integer, i.e. reverse(456) returns 654 
public static int reverse(int number) 

// Return true if number is palindrome 

public static boolean isPalindrome(int number) 

Use the reverse method to implement isPal indrome. A number is a palin- 
drome if its reversal is the same as itself. Write a test program that prompts the 
user to enter an integer and reports whether the integer is a palindrome. 

5.4* (Displaying an integer reversed) Write the following method to display an integer 
in reverse order: 

public static void reverse(int number) 

For example, reverse(3456) displays 6543. Write a test program that prompts 
the user to enter an integer and displays its reversal. 

5.5* (Sorting three numbers) Write the following method to display three numbers in 
increasing order: 

public static void displaySortedNumbers( 
double numl, double num2, double num3) 

5.6* (Displaying patterns) Write a method to display a pattern as follows: 
1 

2 1 
3 2 1 

n n-1 . . . 3 2 1 

The method header is 

public static void di spl ayPattern(int n) 

5.7* (Financial application: computing the future investment value) Write a method that 
computes future investment value at a given interest rate for a specified number of 
years. The future investment is determined using the formula in Exercise 2.13. 

Use the following method header: 

public static double f uturelnvestmentVal ue( 

double i nvestmentAmount , double month! ylnterestRate, int years) 

For example, futureInvestmentValue(10000, 0.05/12, 5) returns 12833.59. 

Write a test program that prompts the user to enter the investment amount (e.g., 
1000) and the interest rate (e.g., 9%) and prints a table that displays future value 
for the years from 1 to 30, as shown below: 

The amount invested: 1000 
Annual interest rate: 9% 



Years Future Value 

1 1093.80 

2 1196.41 

29 13467.25 

30 14730.57 
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5.8 (Conversions between Celsius and Fahrenheit) Write a class that contains the fol- 
lowing two methods: 

/** Converts from Celsius to Fahrenheit */ 

public static double celsiusToFahrenheit(double Celsius) 

/** Converts from Fahrenheit to Celsius */ 

public static double fahrenhei tToCel si us (double fahrenheit) 

The formula for the conversion is: 
fahrenheit = (9.0 / 5) * Celsius + 32 

Write a test program that invokes these methods to display the following tables: 



Celsius 


Fahrenheit 


Fahrenheit 


Cel sius 


40.0 


104.0 


120.0 


48.89 


39.0 


102.2 


110.0 


43.33 


32.0 


89.6 


40.0 


4.44 


31.0 


87.8 


30.0 


-1.11 



5.9 {Conversions between feet and meters) Write a class that contains the following 
two methods: 

/** Converts from feet to meters */ 

public static double footToMeter(doubl e foot) 

/** Converts from meters to feet */ 

public static double meterToFoot(doubl e meter) 

The formula for the conversion is: 
meter = 0.305 * foot 

Write a test program that invokes these methods to display the following 
tables: 



Feet 


Meters 


Meters 


Feet 


1.0 


0.305 


20.0 


65.574 


2.0 


0.61 


25.0 


81.967 


9.0 


2.745 


60.0 


196.721 


10.0 


3.05 


65.0 


213.115 



5.10 {Using the isPrime Method) Listing 5.7, PrimeNumberMethod.java, provides 
the isPrime(int number) method for testing whether a number is prime. Use 
this method to find the number of prime numbers less than 10000. 

5.1 I {Financial application: computing commissions) Write a method that computes 
the commission, using the scheme in Exercise 4.39. The header of the method is as 
follows: 



public static double computeCommi ssi on (double salesAmount) 
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Write a test program that displays the following table: 
Sales Amount Commission 

10000 900.0 
15000 1500.0 

95000 11100.0 
100000 11700.0 

5.12 (Displaying characters) Write a method that prints characters using the following 
header: 

public static void pri ntChars(char chl, char ch2, int 
numberPerLi ne) 

This method prints the characters between chl and ch2 with the specified numbers 
per line. Write a test program that prints ten characters per line from ' 1 1 to ' Z ' . 

5.13* (Summing series) Write a method to compute the following series: 

m(i) = - + - + ... + 

w 2 3 i + 1 

Write a test program that displays the following table: 

i m(i) 

1 0.5000 

2 1.1667 

19 16.4023 

20 17.3546 

5.1 4* (Computing series) Write a method to compute the following series: 

/ 11111 1 1 \ 

m(i) =41 + + + ... + ,_ J _ T , 

w V 3 5 7 9 11 2i - 1 2i + 1/ Video Note 

Compute 7t 

Write a test program that displays the following table: 

i m(i) 

10 3.04184 
20 3.09162 

90 3.13048 
100 3.13159 

5.15* (Financial application: printing a tax table) Listing 3.6 gives a program to com- 
pute tax. Write a method for computing tax using the following header: 

public static double computetax(int status, double taxablelncome) 

Use this method to write a program that prints a tax table for taxable income from 
$50,000 to $60,000 with intervals of $50 for all four statuses, as follows: 



Taxabl e 


Single 


Married 


Married 


Head of 


Income 




Joint 


Separate 


a House 


50000 


8688 


6665 


8688 


7353 


50050 


8700 


6673 


8700 


7365 


59950 


11175 


8158 


11175 


9840 


60000 


11188 


8165 


11188 


9853 
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5.16* {Number of days in a year) Write a method that returns the number of days in a 
year using the following header: 

public static int numberOfDaysInAYear(int year) 

Write a test program that displays the number of days in year from 2000 to 2010. 

Sections 5.10-5.1 1 

5.17* {Displaying matrix of 0s and Is) Write a method that displays an n-by-n matrix 
using the following header: 

public static void printMatrix(int n) 

Each element is or 1, which is generated randomly. Write a test program that 
prints a 3-by-3 matrix that may look like this: 

1 
000 

1 1 1 

5.18 {Using the Math . sqrt method) Write a program that prints the following table 
using the sqrt method in the Math class. 

Number SquareRoot 

0.0000 

2 1.4142 

18 4.2426 
20 4.4721 

5.19* {The MyTri angle class) Create a class named MyTri angle that contains the fol- 
lowing two methods: 

/** Returns true if the sum of any two sides is 

* greater than the third side. */ 
public static boolean isValid( 

double si del, double side2, double side3) 

/** Returns the area of the triangle. */ 
public static double area( 

double sidel, double side2, double side3) 

Write a test program that reads three sides for a triangle and computes the area if 
the input is valid. Otherwise, it displays that the input is invalid. The formula for 
computing the area of a triangle is given in Exercise 2.21. 

5.20 {Using trigonometric methods) Print the following table to display the sin value 
and cos value of degrees from to 360 with increments of 10 degrees. Round the 
value to keep four digits after the decimal point. 



Degree 


Sin 


Cos 





0.0000 


1.0000 


10 


0.1736 


0.9848 


350 


-0.1736 


0.9848 


360 


0.0000 


1.0000 
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5.2 I ** (Statistics: computing mean and standard deviation) In business applications, 
you are often asked to compute the mean and standard deviation of data. The 
mean is simply the average of the numbers. The standard deviation is a statistic 
that tells you how tightly all the various data are clustered around the mean in a 
set of data. For example, what is the average age of the students in a class? How 
close are the ages? If all the students are the same age, the deviation is 0. Write a 
program that prompts the user to enter ten numbers, and displays the mean and 
standard deviations of these numbers using the following formula: 



mean = 




Here is a sample run: 



Enter ten numbers: 1 2 3 4 . 5 5 . 6 6 7 8 9 10 
The mean is 5.61 

The standard deviation is 2.99794 



5.22** (Math: approximating the square root) Implement the sqrt method. The square 
root of a number, num, can be approximated by repeatedly performing a calcula- 
tion using the following formula: 

nextCuess = (lastCuess + (num / lastGuess)) / 2 

When nextGuess and lastGuess are almost identical, nextGuess is the 
approximated square root. 

The initial guess can be any positive value (e.g., 1). This value will be the start- 
ing value for 1 astGuess. If the difference between nextGuess and 1 astGuess 
is less than a very small number, such as . 0001, you can claim that nextGuess 
is the approximated square root of num. If not, nextGuess becomes 1 astGuess 
and the approximation process continues. 



Sections 5.10-5.1 1 

5.23* (Generating random characters) Use the methods in RandomCharacter in Listing 
5.10 to print 100 uppercase letters and then 100 single digits, printing ten per line. 

5.24** (Displaying current date and time) Listing 2.9, ShowCurrentTime.java, displays 
the current time. Improve this example to display the current date and time. The 
calendar example in Listing 5.12, PrintCalendar.java, should give you some ideas 
on how to find year, month, and day. 

5.25** (Converting milliseconds to hours, minutes, and seconds) Write a method that 
converts milliseconds to hours, minutes, and seconds using the following header: 

public static String convertMillis(long millis) 

The method returns a string as hours:minutes:seconds. For example, 
convertMill is(5500) returns a string 0:0:5, convertMillis(lOOOOO) returns 
a string 0:1:40, and convertMill is (555 5 50000) returns a string 154:19:10. 
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Comprehensive 

5.26** (Palindromic prime) A palindromic prime is a prime number and also palin- 
dromic. For example, 131 is a prime and also a palindromic prime. So are 313 
and 757. Write a program that displays the first 100 palindromic prime num- 
bers. Display 10 numbers per line and align the numbers properly, as follows: 

2 3 5 7 11 101 131 151 181 191 
313 353 373 383 727 757 787 797 919 929 



5.27** (Emirp) An emirp (prime spelled backward) is a nonpalindromic prime number 
whose reversal is also a prime. For example, 17 is a prime and 71 is a prime. So, 
17 and 71 are emirps. Write a program that displays the first 100 emirps. 
Display 10 numbers per line and align the numbers properly, as follows: 

13 17 31 37 71 73 79 97 107 113 
149 157 167 179 199 311 337 347 359 389 



5.28** (Mersenne prime) A prime number is called a Mersenne prime if it can be writ- 
ten in the form 2 P — 1 for some positive integer p. Write a program that finds all 
Mersenne primes with p < 31 and displays the output as follows: 

p 2Ap - i 

2 3 

3 7 
5 31 



5.29** (Game: craps) Craps is a popular dice game played in casinos. Write a program 
to play a variation of the game, as follows: 

Roll two dice. Each die has six faces representing values 1, 2, . . . , and 6, respec- 
tively. Check the sum of the two dice. If the sum is 2, 3, or 12 (called craps), you 
lose; if the sum is 7 or 11 (called natural), you win; if the sum is another value (i.e., 
4, 5, 6, 8, 9, or 10), a point is established. Continue to roll the dice until either a 7 
or the same point value is rolled. If 7 is rolled, you lose. Otherwise, you win. 

Your program acts as a single player. Here are some sample runs. 





You 
You 


rol 1 ed 
wi n 


5 


+ 6 = 


11 














You 
You 


rol 1 ed 
lose 


1 


+ 2 = 


3 



You rolled 


4 


+ 4 = 8 


point is 8 






You rolled 


6 


+ 2 = 8 


You wi n 







You rolled 


3 


+ 2 = 


5 


point is 5 








You rolled 


2 


+ 5 = 


7 


You lose 
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5.30** (Twin primes) Twin primes are a pair of prime numbers that differ by 2. For 
example, 3 and 5 are twin primes, 5 and 7 are twin primes, and 11 and 13 are 
twin primes. Write a program to find all twin primes less than 1000. Display the 
output as follows: 

(3, 5) 
(5, 7) 

5.3 I ** (Financial: credit card number validation) Credit card numbers follow certain 
patterns. A credit card number must have between 13 and 16 digits. It must start 
with: 

■ 4 for Visa cards 

■ 5 for Master cards 

■ 37 for American Express cards 

■ 6 for Discover cards 

In 1954, Hans Luhn of IBM proposed an algorithm for validating credit card 
numbers. The algorithm is useful to determine whether a card number is entered 
correctly or whether a credit card is scanned correctly by a scanner. All credit 
card numbers are generated following this validity check, commonly known as 
the Luhn check or the Mod 10 check, which can be described as follows (for illus- 
tration, consider the card number 4388576018402626): 

1 . Double every second digit from right to left. If doubling of a digit results in a 
two-digit number, add up the two digits to get a single-digit number. 



2*2 = 


4 




2*2 = 


4 




4*2 = 


8 




1 *2 = 


2 




6*2 = 


12(1+2 


= 3) 


5*2 = 


10(1+0 


= D 


8*2 = 


16(1+6 


= 7) 


4*2 = 


8 





2. Now add all single-digit numbers from Step 1 . 
4+4+8+2+3+1+7+8= 37 

3. Add all digits in the odd places from right to left in the card number. 
6+6+0+8+0+7+8+3=38 

4. Sum the results from Step 2 and Step 3. 
37 + 38 = 75 

5. If the result from Step 4 is divisible by 10, the card number is valid; otherwise, 
it is invalid. For example, the number 4388576018402626 is invalid, but the 
number 4388576018410707 is valid. 

Write a program that prompts the user to enter a credit card number as a 1 ong 
integer. Display whether the number is valid or invalid. Design your program to 
use the following methods: 

/** Return true if the card number is valid */ 
public static boolean isVa~lid(long number) 

/** Get the result from Step 2 */ 

public static int sumOfDoubleEvenPlace(long number) 
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/** Return this number "if it is a single digit, otherwise, return 

* the sum of the two digits */ 
public static int getDigit(int number) 

/** Return sum of odd place digits in number */ 
public static int sumOfOddPlace(long number) 

/** Return true if the digit d is a prefix for number */ 
public static boolean prefixMatched(long number, int d) 

/** Return the number of digits in d */ 
public static int getSize(long d) 

/** Return the first k number of digits from number. If the 

* number of digits in number is less than k, return number. */ 
public static long getPrefix(long number, int k) 

5.32** (Game: chance of winning at craps) Revise Exercise 5.29 to run it 10000 times 
and display the number of winning games. 

5.33*** (Current date and time) Invoking System. cu r rentTi meMil 1 is() returns 
the elapse time in milliseconds since midnight of January 1, 1970. Write a pro- 
gram that displays the date and time. Here is a sample run: 




Current date and time is May 16, 2009 10:34:23 



5.34** (Printing calendar) Exercise 3.21 uses Zeller's congruence to calculate the day 
of the week. Simplify Listing 5.12, PrintCalendar.java, using Zeller's algorithm 
to get the start day of the month. 

5.35 (Geometry: area of a pentagon) The area of a pentagon can be computed using 
the following formula: 

5 X s 2 
Area = 7 

/ 77 

4 X tanl — 

Write a program that prompts the user to enter the side of a pentagon and dis- 
plays its area. 

5.36* (Geometry: area of a regular polygon) A regular polygon is an n-sided polygon 
in which all sides are of the same length and all angles have the same degree 
(i.e., the polygon is both equilateral and equiangular). The formula for comput- 
ing the area of a regular polygon is 

n X s 2 

Area = 7 — 

/ 77 

4 X tan — 
\n 

Write a method that returns the area of a regular polygon using the following 
header: 

public static double area(int n, double side) 

Write a main method that prompts the user to enter the number of sides and the 
side of a regular polygon and displays its area. 



Chapter 



Single-Dimensional Arrays 



Objectives 



To describe why arrays are necessary in programming (§6.1). 

To declare array reference variables and create arrays (§§6.2.1-6.2.2). 

To initialize the values in an array (§6.2.3). 

To access array elements using indexed variables (§6.2.4). 

To declare, create, and initialize an array using an array 
initializer (§6.2.5). 

To program common array operations (displaying arrays, 
summing all elements, finding min and max elements, 
random shuffling, shifting elements) (§6.2.6). 

To simplify programming using the for-each loops (§6.2.7). 

To apply arrays in the LottoNumbers and DeckOfCards 

problems (§§6.3-6.4). 

To copy contents from one array to another (§6.5). 

To develop and invoke methods with array arguments and return 
value (§6.6-6.7). 

To define a method with variable-length argument list (§6.8). 

To search elements using the linear (§6.9.1) 
or binary (§6.9.2) search algorithm. 

To sort an array using the selection sort (§6.10.1) 

To sort an array using the insertion sort (§6.10.2). 

To use the methods in the Arrays class (§6.11). 
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Single-Dimensional Arrays 



6.1 Introduction 



problem 



why array? 
what is array? 



Often you will have to store a large number of values during the execution of a program. Sup- 
pose, for instance, that you need to read 100 numbers, compute their average, and find out 
how many numbers are above the average. Your program first reads the numbers and com- 
putes their average, then compares each number with the average to determine whether it is 
above the average. In order to accomplish this task, the numbers must all be stored in vari- 
ables. You have to declare 100 variables and repeatedly write almost identical code 100 times. 
Writing a program this way would be impractical. So, how do you solve this problem? 

An efficient, organized approach is needed. Java and most other high-level languages pro- 
vide a data structure, the array, which stores a fixed-size sequential collection of elements of 
the same type. In the present case, you can store all 100 numbers into an array and access 
them through a single array variable. The solution may look like this: 



declare array 



store number in array 



get average 



above average? 



1 
2 
3 
4 
5 
6 
7 
8 
9 
10 
11 
12 
13 
14 
15 
16 
17 
18 
19 
20 
21 
22 
23 
24 
25 



public class AnalyzeN 
public static void 
final int NUMBER 
doubled numbers 
double sum = 0; 

java.util .Scanner 
for (int i =0; i 
System. out . pri n 
numbers [i] = in 
sum += numbers[ 

} 



umbers { 

main(String[] args) { 
0F_ELEMENTS = 100; 
= new double [NUMBER_0F_ELEMENTS] ; 



input = new java.util .Scanner(System. in) ; 

< NUMBER_OF_ELEMENTS ; i++) { 
t("Enter a new number: ") ; 
put . nextDoubl e () ; 

i]; 



double average = sum / NUMBER_OF_ELEMENTS ; 



int count = 0; // 
for (int i =0; i 
if (numbers[i] 
count++; 

System . out . pri ntl 
System . out . pri ntl 
+ count) ; 



The number of elements above average 
< NUMBER_OF_ELEMENTS ; i++) 
> average) 



n("Average is " + average); 

n ("Number of elements above the average " 



} 



The program creates an array of 100 elements in line 4, stores numbers into the array in line 
10, adds each number to sum in line 11, and obtains the average in line 14. It then compares 
each number in the array with the average to count the number of values above the average 
(lines 16-19). 

This chapter introduces single-dimensional arrays. The next chapter will introduce two- 
dimensional and multidimensional arrays. 



6.2 Array Basics 

An array is used to store a collection of data, but often we find it more useful to think of an 
array as a collection of variables of the same type. Instead of declaring individual variables, 
such as numberO, numberl, . . . , and number99, you declare one array variable such as 
numbers and use numbers [0], numbers [1], . . . , and numbers [99] to represent individ- 
ual variables. This section introduces how to declare array variables, create arrays, and 
process arrays using indexed variables. 
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6.2. 1 Declaring Array Variables 

To use an array in a program, you must declare a variable to reference the array and specify 

the array's element type. Here is the syntax for declaring an array variable: element type 

el ementType [] arrayRefVar; 

The el ementType can be any data type, and all elements in the array will have the same data 
type. For example, the following code declares a variable myLi st that references an array of 
double elements. 

double [] myLi st; 
|S| Note 

You can also use el ementType arrayRefVar [] to declare an array variable. This style comes preferred syntax 

from the C language and was adopted in Java to accommodate C programmers. The style 
elementType[] arrayRefVar is preferred. 



6.2.2 Creating Arrays 

Unlike declarations for primitive data type variables, the declaration of an array variable does 
not allocate any space in memory for the array. It creates only a storage location for the refer- 
ence to an array. If a variable does not contain a reference to an array, the value of the variable 
is nul 1 . You cannot assign elements to an array unless it has already been created. After an 
array variable is declared, you can create an array by using the new operator with the follow- 
ing syntax: 

arrayRefVar = new el ementType [arraySi ze] ; newoperator 

This statement does two things: (1) it creates an array using new el ementType [array- 
Size] ; (2) it assigns the reference of the newly created array to the variable arrayRefVar. 

Declaring an array variable, creating an array, and assigning the reference of the array to 
the variable can be combined in one statement, as shown below: 

elementType arrayRefVar = new el ementType [arraySi ze] ; 

or 

elementType arrayRefVar[] = new el ementType [arraySi ze] ; 

Here is an example of such a statement: 

doubled myList = new double[10]; 

This statement declares an array variable, myList, creates an array of ten elements of 
double type, and assigns its reference to myList. To assign values to the elements, use the 
syntax: 

arrayRefVar [i ndex] = value; 

For example, the following code initializes the array. 

myList[0] = 5.6; 

myList[l] = 4.5; 

myList [2] =3.3; 

myList[3] = 13.2; 
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myList[4] = 4.0; 

myList[5] = 34.33; 

myList[6] = 34.0; 

myList[7] = 45.45; 

myList[8] = 99.993; 

myList[9] = 11123; 

The array is pictured in Figure 6. 1 . 



doublet] myList = new doub1e[10]; 



myLi st 



reference 



Array reference 
variable 



Array element at 
index 5 



myLi st [0] 


5.6 


myLi st [1] 


4.5 


myList [2] 


3.3 


myList [3] 


13.2 


myList [4] 


4.0 


— >-myList[5] 


34.33 - 


myList [6] 


34.0 


myList [7] 


45.45 


myList [8] 


99.993 


myList [9] 


11123 



Element value 



Figure 6.1 The array myLi st has ten elements of doubl e type and i nt indices from to 9. 



$| Note 

array vs. array variable An array variable that appears to hold an array actually contains a reference to that array. Strictly 

speaking, an array variable and an array are different, but most of the time the distinction can be 
ignored. Thus it is all right to say, for simplicity, that myList is an array, instead of stating, at greater 
length, that myList is a variable that contains a reference to an array often double elements. 



6.2.3 Array Size and Default Values 

When space for an array is allocated, the array size must be given, specifying the number of ele- 
ments that can be stored in it. The size of an array cannot be changed after the array is created. 

array length Size can be obtained using ar rayRefVar . 1 ength. For example, myLi st . 1 ength is 10. 

When an array is created, its elements are assigned the default value of for the numeric 

default values primitive data types, ' \u0000 ' for char types, and f al se for bool ean types. 



6.2.4 Array Indexed Variables 

based The array elements are accessed through the index. Array indices are based; that is, they 

range from to arrayRefVar . 1 ength-1. In the example in Figure 6.1, myList holds ten 
doubl e values, and the indices are from to 9. 

indexed variables Each element in the array is represented using the following syntax, known as an indexed 

variable: 

arrayRefVar [i ndex] ; 

For example, myList [9] represents the last element in the array myList. 




Caution 



Some languages use parentheses to reference an array element, as in myList (9). But Java uses 
brackets, as in myList [9]. 
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After an array is created, an indexed variable can be used in the same way as a regular variable. 
For example, the following code adds the values in myList[0] and myList[l] to myList[2]. 

myList[2] = myList[0] + myList[l]; 

The following loop assigns to myLi st [0] , 1 to myLi st [1] , . . . , and 9 to myLi st [9] : 

for (int i = 0; i < myLi st . 1 ength ; i++) { 
myLi st [i ] = i ; 

} 

6.2.5 Array Initializers 

Java has a shorthand notation, known as the array initializer, which combines in one state- 
ment declaring an array, creating an array, and initializing, using the following syntax: 

el ementType [] arrayRefVar = {valueO, valuel, value/c}; 

For example, 

double[] myList = {1.9, 2.9, 3.4, 3.5}; 

This statement declares, creates, and initializes the array myLi st with four elements, which is 
equivalent to the statements shown below: 

double [] myList = new double [4]; 
myList[0] = 1.9; 
myList[l] = 2.9; 
myList[2] = 3.4; 
myList [3] =3.5; 

H§| Caution 

The new operator is not used in the array-initializer syntax. Using an array initializer, you have to 
declare, create, and initialize the array all in one statement. Splitting it would cause a syntax error. 
Thus the next statement is wrong: 

double[] myList; 

myList = {1.9, 2.9, 3.4, 3.5}; 

6.2.6 Processing Arrays 

When processing array elements, you will often use a for loop — for two reasons: 

■ All of the elements in an array are of the same type. They are evenly processed in the 
same fashion repeatedly using a loop. 

■ Since the size of the array is known, it is natural to use a for loop. 
Assume the array is created as follows: 

doubled myList = new double[10]; 

Here are some examples of processing arrays: 

1. (Initializing arrays with input values) The following loop initializes the array myList 
with user input values. 

java. uti 1 . Scanner input = new java.util .Scanner(System.in) ; 
System . out . pri nt("Enter " + myLi st . 1 ength + " values: ") ; 
for (int i = 0; i < myLi st . 1 ength ; i++) 
myList[i] = i nput . nextDoubl e() ; 
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2. (Initializing arrays with random values) The following loop initializes the array 
myLi st with random values between . and 100 . 0, but less than 100 . 0. 

for (int i = 0; i < myLi st . I ength ; i++) { 
myLi st [i] = Math . randomO * 100; 

} 

3. (Displaying arrays) To print an array, you have to print each element in the array using 
a loop like the following: 

for (int i = 0; i < myLi st . 1 ength ; i++) { 
System. out. pri nt(myLi st [i ] + " ") ; 

} 



print character array 



Video Note 

Random shuffling 



Tip 

For an array of the char [] type, it can be printed using one print statement. For example, the fol- 
lowing code displays Dallas: 

char[] city = {'D\ 'a', '1 ' , ' V , 'a', 's'}; 
System. out. println(city) ; 

4. (Summing all elements) Use a variable named total to store the sum. Initially total 
is 0. Add each element in the array to total using a loop like this: 

double total = 0; 

for (int i = 0; i < myLi st . 1 ength ; i++) { 
total += myList[i]; 

} 

5. (Finding the largest element) Use a variable named max to store the largest element. Ini- 
tially max is myList[0]. To find the largest element in the array myList, compare 
each element with max, and update max if the element is greater than max. 

double max = myList[0]; 

for (int i = 1; i < myLi st . 1 ength ; i++) { 
if (myList[i] > max) max = myList[i]; 

} 

6. (Finding the smallest index of the largest element) Often you need to locate the largest 
element in an array. If an array has more than one largest element, find the smallest 
index of such an element. Suppose the array myList is {1, 5, 3, 4, 5, 5}. The largest 
element is 5 and the smallest index for 5 is 1. Use a variable named max to store the 
largest element and a variable named i ndexOf Max to denote the index of the largest 
element. Initially max is myLi st [0] , and i ndexOf Max is 0. Compare each element in 
myList with max, and update max and i ndexOf Max if the element is greater than 
max. 

double max = myList[0]; 
int i ndexOf Max = 0; 

for (int i = 1; i < myLi st . I ength ; i++) { 
if (myList[i] > max) { 
max = myLi st [i ] ; 
i ndexOf Max = i ; 

} 

} 

What is the consequence if (myList[i] > max) is replaced by (myList[i] >= max)? 

7. (Random shuffling) In many applications, you need to randomly reorder the elements in 
an array. This is called a shuffling. To accomplish this, for each element myList[i], 
randomly generate an index j and swap myList[i] with myList[j], as follows: 
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for (int i =0; i < myList. length; { 

// Generate an index j randomly 
int index = (int) (Math . random() 
* myli st. length) ; 

// Swap my Li st [i] with myList [j] 
double temp = myList[i]; 
myList [i] = myLi st [i ndex] 
myLi st [i ndex] = temp; 



myList 
[0] 
[1] 



[index] 
A random index 



swap 



8. (Shifting elements) Sometimes you need to shift the elements left or right. Here is an 
example to shift the elements one position to the left and fill the last element with the 
first element: 



double temp = myList[0]; // Retain the first element 
// Shift elements left myList 

for (int i = 1; i < myList. length; i++) { X~\ X~\ 

myList[i - 1] = myList[i]; jTlHH 1 | T |I T | h 

// Move the first element to fill in the last position 
myList [myLi st. length - 1] = temp; 



6.2.7 For-each Loops 

Java supports a convenient for loop, known as a for-each loop or enhanced for loop, which 
enables you to traverse the array sequentially without using an index variable. For example, 
the following code displays all the elements in the array myList: 

for (double u: myList) { 
System. out. println(u) ; 

} 

You can read the code as "for each element u in myLi st do the following." Note that the vari- 
able, u, must be declared the same type as the elements in myList. 
In general, the syntax for a for-each loop is 

for (elementType element: arrayRefVar) { 

// Process the element 

} 

You still have to use an index variable if you wish to traverse the array in a different order or 
change the elements in the array. 

|§| Caution 

Accessing an array out of bounds is a common programming error that throws a runtime 

ArraylndexOutOf BoundsException. To avoid it, make sure that you do not use an index ArraylndexOutOfBounds- 
beyond arrayRefVar .length - 1. Exception 

Programmers often mistakenly reference the first element in an array with index 1, but it 
should be 0. This is called the off-by-one error. It is a common error in a loop to use <= where < off-by-one error 

should be used. For example, the following loop is wrong, 

for (int i =0; i <= list. length; i++) 
System. out. print(list[i] + " ") ; 



The <= should be replaced by <. 
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Video Note 



6.3 Problem: Lotto Numbers 

Each ticket for the Pick-10 lotto has 10 unique numbers ranging from 1 to 99. Suppose you 
Lotto numbers ^uys a ^ ot °^ tickets and like to have them cover all numbers from 1 to 99. Write a program that 

reads the ticket numbers from a file and checks whether all numbers are covered. Assume the 
last number in the file is 0. Suppose the file contains the numbers 

80 3 87 62 30 90 10 21 46 27 
12 40 83 9 39 88 95 59 20 37 
80 40 87 67 31 90 11 24 56 77 
11 48 51 42 8 74 1 41 36 53 
52 82 16 72 19 70 44 56 29 33 
54 64 99 14 23 22 94 79 55 2 
60 86 34 4 31 63 84 89 7 78 
43 93 97 45 25 38 28 26 85 49 
47 65 57 67 73 69 32 71 24 66 
92 98 96 77 6 75 17 61 58 13 
35 81 18 15 5 68 91 50 76 


Your program should display 

The tickets cover all numbers 

Suppose the file contains the numbers 

11 48 51 42 8 74 1 41 36 53 
52 82 16 72 19 70 44 56 29 33 


Your program should display 

The tickets don't cover all numbers 

How do you mark a number as covered? You can create an array with 99 bool ean elements. 
Each element in the array can be used to mark whether a number is covered. Let the array be 

1 sCovered. Initially, each element is f al se, as shown in Figure 6.2(a). Whenever a number 
is read, its corresponding element is set to true. Suppose the numbers entered are 1, 2, 3, 99, 
0. When number 1 is read, i sCovered [0] is set to true (see Figure 6.2(b)). When number 

2 is read, i sCovered [2 - 1] is set to true (see Figure 6.2(c)). When number 3 is read, 



isCovered isCovered isCovered isCovered isCovered 



[0] 


false 


[0] 


true 


[0] 


true 


[0] 


true 


[0] 


true 


[1] 


false 


[1] 


false 


[1] 


true 


[1] 


true 


[1] 


true 


[2] 


false 


[2] 


false 


[2] 


false 


[2] 


true 


[2] 


true 


[3] 


false 


[3] 


false 


[3] 


false 


[3] 


false 


[3] 


false 






















[97] 


false 


[97] 


false 


[97] 


false 


[97] 


false 


[97] 


false 


[98] 


false 


[98] 


false 


[98] 


false 


[98] 


false 


[98] 


true 




(a) 




(b) 




(c) 




(d) 




(e) 



Figure 6.2 If number i appears in a Lotto ticket, i sCovered [i -1] is set to true. 
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isCovered[3 - 1] is set to true (see Figure 6.2(d)). When number 99 is read, set 
isCovered[98] to true (see Figure 6.2(e)). 

The algorithm for the program can be described as follows: 

for each number k read from the file, 

mark number k as covered by setting isCovered [/c - 1] true; 

if every isCovered[i] is true 

The tickets cover all numbers 
el se 

The tickets don't cover all numbers 
The complete program is given in Listing 6. 1. 

Listing 6.1 LottoNumbers . java 

1 import java. util .Scanner; 

2 

3 public class LottoNumbers { 



4 public static void main(String args[]) { 

5 Scanner input = new Scanner(System . i n) ; 

6 boolean[] isCovered = new boolean[99]; // Default is false create and initialize array 
7 

8 // Read each number and mark its corresponding element covered 

9 int number = i nput . nextlntO ; read number 

10 while (number != 0) { 

11 isCovered [number - 1] = true; mark number covered 

12 number = i nput . nextlntO ; read number 

13 } 
14 

15 // Check whether all covered 

16 boolean allCovered = true; // Assume all covered initially 

17 for (int i = 0; i < 99; i++) 

18 if (HsCovered[i]) { 

19 allCovered = false; // Find one number not covered 

20 break; 

21 } 
22 

23 // Display result 

24 if (allCovered) check allCovered? 

25 System. out. println("The tickets cover all numbers"); 

26 else 

27 System. out . pri ntl n("The tickets don't cover all numbers"); 

28 } 



29 } 

Suppose you have created a text file named LottoNumbers.txt that contains the input data 2 5 
654323 43 2 0. You can run the program using the following command: 

java LottoNumbers < LottoNumbers.txt 

The program can be traced as follows: 

The program creates an array of 99 boolean elements and initializes each element to 
f al se (line 6). It reads the first number from the file (line 9). The program then repeats the 
following operations in a loop: 

■ If the number is not zero, set its corresponding value in array isCovered to true 

(line 1 1); 

■ Read the next number (line 12). 
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line 


Representative elements in array isCovered 




number 


allCovered 




[1] P] [3] [4] [5] [22] 
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12 
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12 











16 








true 


I8(i=0) 








false 



When the input is 0, the input ends. The program checks whether all numbers are covered in 
lines 16-21 and displays the result in lines 24-27. 

6.4 Problem: Deck of Cards 

The problem is to write a program that picks four cards randomly from a deck of 52 cards. All 
the cards can be represented using an array named deck, filled with initial values to 51, as 
follows: 

int[] deck = new int[52]; 

// Initialize cards 
for (int i = 0; i < deck. length; i++) 
deckfi ] = i ; 

Card numbers to 12, 13 to 25, 26 to 38, 39 to 51 represent 13 Spades, 13 Hearts, 13 Dia- 
monds, and 13 Clubs, respectively, as shown in Figure 6.3. After shuffling the array deck, 
pick the first four cards from deck. cardNumber / 13 determines the suit of the card and 
cardNumber % 13 determines the rank of the card. 
Listing 6.2 gives the solution to the problem. 
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Listing 6.2 DeckOf Cards . java 



i 

2 
3 
4 
5 
6 
7 
8 
9 
10 
11 
12 
13 
14 
15 
16 
17 
18 
19 
20 
21 
22 
23 
24 
25 
26 
27 
28 
29 



public class DeckOfCards { 

public static void main(String[] args) { 
int[] deck = new int[52]; 

String [] suits = {"Spades", "Hearts", "Diamonds", 
String[] ranks = {"Ace", "2", "3", "4", "5", "6", 
"10", "Jack", "Queen", "King"}; 



"Clubs"} 
"7", "8" 



, "9", 



// Initialize cards 
for (int i = 0; i < deck. length; 
deck[i] = i ; 

// Shuffle the cards 

for (int i = 0; i < deck. length; 

// Generate an index randomly 

int index = (int) (Math . randomO 

int temp = deck[i ] ; 

deck[i] = deck[index]; 

deck[index] = temp; 

} 



// Display the first four cards 
for (int i =0; i < 4; i++) { 

String suit = sui ts [deck[i ] / 13] 
String rank = ranks[deck[i] % 13] 
System. out. pri ntl n("Card number " 
+ rank + " of " + suit); 

} 



i++) 

i++) { 

deck. length) ; 



create array deck 
array of strings 
array of strings 



initialize deck 



shuffle deck 



suit of a card 
rank of a card 



+ deck[i] + 
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24 


Queen of Hearts 



deck 



deck 
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13 Hearts (y) 



■ 13 Diamonds (♦) 



■ 13 Clubs (*) 



[12] 
[13] 



[25] 
[26] 



[38] 
[39] 



[51] 



51 



[1] 
P] 
[3] 
[4] 
[5] 



Random shuffle [25] 
* P6] 



[38] 
[39] 



[51] 



Card number 6 is 
7 of Spades 

Card number 48 is 
10 of Clubs 



Card number 11 is 
Queen of Spades 



Card number 24 is 
Queen of Hearts 



Figure 6.3 52 cards are stored in an array named deck. 



208 Chapter 6 Single-Dimensional Arrays 



The program defines an array sui ts for four suits (line 4) and an array ranks for 13 cards in 
a suits (lines 5-6). Each element in these arrays is a string. 

The deck is initialized with values to 51 in lines 9-10. A deck value represents card 
Ace of Spades, 1 represents card 2 of Spades, 13 represents card Ace of Hearts, 14 represents 
card 2 of Hearts. 

Lines 13-19 randomly shuffle the deck. After a deck is shuffled, deck[i] contains an 
arbitrary value. deck[i] / 13 is 0, 1, 2, or 3, which determines a suit (line 23). deck[i] % 
13 is a value between and 12, which determines a rank (line 24). 

6.5 Copying Arrays 

Often, in a program, you need to duplicate an array or a part of an array. In such cases you 
could attempt to use the assignment statement (=), as follows: 

copy reference list2 = listl; 

This statement does not copy the contents of the array referenced by 1 istl to 1 ist2, but 
merely copies the reference value from listl to list2. After this statement, listl and 
1 ist2 reference to the same array, as shown in Figure 6.4. The array previously referenced 
garbage collection by 1 i st2 is no longer referenced; it becomes garbage, which will be automatically collected 

by the Java Virtual Machine. 



Before the assignment 
list2 = listl; 
1 i stl 



1 i st2 



Contents 
of listl 



Contents 
of list2 



After the assignment 
list2 = listl; 
listl 



list2 



Contents 
of listl 



Contents 
of list2 



Figure 6.4 Before the assignment statement, 1 i stl and 1 i st2 point to separate memory 
locations. After the assignment, the reference of the listl array is passed to 1 i st2. 



In Java, you can use assignment statements to copy primitive data type variables, but not 
arrays. Assigning one array variable to another array variable actually copies one reference to 
another and makes both variables point to the same memory location. 

There are three ways to copy arrays: 

■ Use a loop to copy individual elements one by one. 

■ Use the static arraycopy method in the System class. 

■ Use the clone method to copy arrays; this will be introduced in Chapter 14, 
'Abstract Classes and Interfaces." 

You can write a loop to copy every element from the source array to the corresponding ele- 
ment in the target array. The following code, for instance, copies sourceArray to 
targetArray using a for loop. 

int[] sourceArray = {2, 3, 1, 5, 10}; 

int[] targetArray = new int [sourceArray. length] ; 
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for (int i = 0; i < sourceArray. length; { 
targetArray[i] = sourceArray [i ] ; 

} 

Another approach is to use the arraycopy method in the java . 1 ang . System class to copy 
arrays instead of using a loop. The syntax for arraycopy is shown below: 

arraycopy(sourceArray , src_pos, targetArray, tar_pos, length); arraycopy method 

The parameters src_pos and tar_pos indicate the starting positions in sourceArray and 
targetArray, respectively. The number of elements copied from sourceArray to 
targetArray is indicated by length. For example, you can rewrite the loop using the fol- 
lowing statement: 

System. arraycopy(sourceArray, 0, targetArray, 0, sourceArray. length) ; 

The arraycopy method does not allocate memory space for the target array. The target array 
must have already been created with its memory space allocated. After the copying takes 
place, targetArray and sourceArray have the same content but independent memory 
locations. 

§ Note 

The arraycopy method violates the Java naming convention. By convention, this method 
should be named arrayCopy (i.e., with an uppercase C). 

6.6 Passing Arrays to Methods 

Just as you can pass primitive type values to methods, you can also pass arrays to methods. 
For example, the following method displays the elements in an int array: 

public static void printArray(int[] array) { 
for (int i = 0; i < array. length; i++) { 
System. out. print(array[i] + " ") ; 

} 

} 

You can invoke it by passing an array. For example, the following statement invokes the 
printArray method to display 3, 1, 2, 6, 4, and 2. 

pri ntArray(new int[]{3, 1, 2, 6, 4, 2}); 
t§| Note 

The preceding statement creates an array using the following syntax: 
new el ementType [] {val ueO , valuel, value/c}; 

There is no explicit reference variable for the array. Such array is called an anonymous array. 

Java uses pass-by-value to pass arguments to a method. There are important differences 
between passing the values of variables of primitive data types and passing arrays. 

■ For an argument of a primitive type, the argument's value is passed. 

■ For an argument of an array type, the value of the argument is a reference to an array; 
this reference value is passed to the method. Semantically, it can be best described as 
pass-by-sharing, i.e., the array in the method is the same as the array being passed. 
So if you change the array in the method, you will see the change outside the 
method. 



anonymous arrays 
pass-by-value 



pass-by-sharing 
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Take the following code, for example: 

public class Test { 

public static void main(String[] args) { 
int x = 1; // x represents an int value 

int[] y = new int[10]; // y represents an array of int values 

mCx , y) ; // Invoke m with arguments x and y 

System . out . pri ntl n("x is " + x) ; 
System. out. println(''y[0] is " + y[0]); 

} 

public static void m(int number, int[] numbers) { 
number = 1001; // Assign a new value to number 
numbers[0] = 5555; // Assign a new value to numbers[0] 

} 

} 



x i s 1 

y[0] is 



5555 



You will see that after m is invoked, x remains 1, but y[0] is 5555. This is because y and 
numbers, although they are independent variables, reference to the same array, as illustrated 
in Figure 6.5. When m(x, y) is invoked, the values of x and y are passed to number and 
numbers. Since y contains the reference value to the array, numbers now contains the same 
reference value to the same array. 



Stack 

Space required for 
method m 
i nt [] numbers: 
int number: 1 



Space required for the 
main method 

int[] y: 

int x: 1 




Heap 



An array of 
ten i nt 
values is 
stored here 



Arrays are 
stored in a 
heap. 



Figure 6.5 The primitive type value in x is passed to number, and the reference value in y 
is passed to numbers. 



^ Note 

heap ~~ The JVM stores the array in an area of memory called the heap, which is used for dynamic mem- 

ory allocation where blocks of memory are allocated and freed in an arbitrary order. 

6.6. 1 Passing Array Arguments 

Listing 6.3 gives another program that shows the difference between passing a primitive data 
type value and an array reference variable to a method. 

The program contains two methods for swapping elements in an array. The first method, named 
swap, fails to swap two int arguments. The second method, named swapFirstTwoInArray, 
successfully swaps the first two elements in the array argument. 
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Listing 6.3 TestPassArray . java 

1 public class TestPassArray { 

2 /** Main method */ 

3 public static void main(String[] args) { 

4 int[] a = {1, 2}; 
5 

6 // Swap elements using the swap method 

7 System. out. println ("Before invoking swap"); 

8 System. out. print1n("array is {" + a[0] + ", " + a[l] + "}"); 

9 swap(a[0] , a[l]); false swap 

10 System. out. pri ntl n ("After invoking swap"); 

11 System. out. println("array is {" + a[0] + ", " + a[l] + "}") ; 
12 

13 // Swap elements using the swapFi rstTwoInArray method 

14 System. out. pri ntl n("Before invoking swapFi rstTwoInArray") ; 

15 System. out. pri ntl n("array is {" + a[0] + ", " + a[l] + "}"); 

16 swapFi rstTwoInArray (a) ; swap array elements 

17 System. out. pri ntl n("After invoking swapFi rstTwoInArray") ; 

18 System. out. pri ntl n("array is {" + a[0] + ", " + a[l] + "}"); 

19 } 
20 

21 /** Swap two variables */ 

22 public static void swap(int nl, int n2) { 

23 int temp = nl; 

24 nl = n2; 

25 n2 = temp; 

26 } 
27 

28 /** Swap the first two elements in the array */ 

29 public static void swapFi rstTwoInArray(int [] array) { 

30 int temp = array[0] ; 

31 array[0] = array[l] ; 

32 array[l] = temp; 

33 } 

34 } 



Before invoking swap 
array is {1, 2} 
After invoking swap 
array is {1, 2} 

Before invoking swapFi rstTwoInArray 
array is {1, 2} 

After invoking swapFi rstTwoInArray 
array is {2, 1} 



As shown in Figure 6.6, the two elements are not swapped using the swap method. However, 
they are swapped using the swapFi rstTwoInArray method. Since the parameters in the swap 
method are primitive type, the values of a[0] and a[l] are passed to nl and n2 inside the 
method when invoking swap(a[0], a[l]). The memory locations for n 1 and n 2 are indepen- 
dent of the ones for a [0] and a [1] . The contents of the array are not affected by this call. 

The parameter in the swapFi rstTwoInArray method is an array. As shown in Figure 6.6, 
the reference of the array is passed to the method. Thus the variables a (outside the method) 
and array (inside the method) both refer to the same array in the same memory location. 
Therefore, swapping array[0] with array[l] inside the method swapFi rstTwoInArray 
is the same as swapping a[0] with a [1] outside of the method. 
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Stack 



Space required for the 
swap method 

n2:2 
nl:l 



Space required for the 
man n method 




Heap 



Stack 

Space required for the 
swapFi rstTwoInArray 
method 



int[] array J reference 



Space required for the 
man n method 



int[] a 



reference 



J~ 



Invoke swap (i nt nl, int 

The primitive type values in 

a [0] and a [1] are passed to the 

swap method. 



The arrays are Invoke swapFi rstTwoInArray (i nt [] 
stored in a a r r ay ) . The reference value in a is passed 
heap. to the swapFi rstTwoInArray method. 



Figure 6.6 When passing an array to a method, the reference of the array is passed to the 
method. 



6.7 Returning an Array from a Method 

You can pass arrays when invoking a method. A method may also return an array. For exam- 
ple, the method shown below returns an array that is the reversal of another array: 



create array 



1 public static int[] reverse(int[] list) { 

2 int[] result = new int[list. length] ; 
3 
4 

5 
6 
7 



return array 



for (int i = 0, j = result. length 
i < list. length; i++, j — ) { 
result[j] = list[i] ; 

} 



; 



9 

10 } 



return result; 



list 
result 



Line 2 creates a new array result. Lines 4-7 copy elements from array list to array 
resul t. Line 9 returns the array. For example, the following statement returns a new array 
1 ist2 with elements 6, 5, 4, 3, 2, 1. 

int[] listl = {1, 2, 3, 4, 5, 6}; 
int[] list2 = reverseO i stl) ; 

6.7.1 Case Study: Counting the Occurrences of Each Letter 

Listing 6.4 presents a program to count the occurrences of each letter in an array of charac- 
ters. The program does the following: 

1. Generate 100 lowercase letters randomly and assign them to an array of characters, as 
shown in Figure 6.7(a). You can obtain a random letter by using the getRandomLow- 
erCaseLetter O method in the RandomCharacter class in Listing 5.10 

2. Count the occurrences of each letter in the array. To do so, create an array, say counts, 
of 26 int values, each of which counts the occurrences of a letter, as shown in Figure 
6.7(b). That is, counts [0] counts the number of a's, counts [1] counts the number 
of b's, and so on. 
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chars [0] 
chars [1] 



chars[98] 
chars[99] 



counts [0] 
counts [1] 



counts [24] 
counts [25] 



(a) 



(b) 



Figure 6.7 The chars array stores 100 characters, and the counts array stores 26 counts, 
each of which counts the occurrences of a letter. 



Listing 6.4 CountLettersInArray . java 

1 public class CountLettersInArray { 

2 /** Main method */ 

3 public static void main(String[] args) { 

4 // Declare and create an array 

5 char[] chars = createArrayO ; createarray 
6 

7 // Display the array 

8 System. out. println ("The lowercase letters are:"); 

9 di splayAr ray (chars) ; pass array 
10 

11 // Count the occurrences of each letter 

12 int[] counts = countLetters(chars) ; returnarray 
13 

14 // Display counts 

15 System . out . pri ntl n () ; 

16 System. out. println("The occurrences of each letter are:"); 

17 di splayCounts (counts) ; pass array 

18 } 
19 

20 /** Create an array of characters */ 

21 public static char[] createArrayO { 

22 // Declare an array of characters and create it 

23 char[] chars = new char[100]; 
24 

25 // Create lowercase letters randomly and assign 

26 // them to the array 

27 for (int i = 0; i < chars . 1 ength ; i++) 

28 chars[i] = RandomCharacter . getRandomLowerCaseLetter() ; 
29 

30 // Return the array 

31 return chars; 

32 } 
33 

34 /** Display the array of characters */ 

35 public static void displayArray(char[] chars) { 

36 // Display the characters in the array 20 on each line 

37 for (int i = 0; i < chars . 1 ength ; i++) { 

38 if ((i + 1) % 20 == 0) 

39 System. out. pri ntln(chars[i]) ; 
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40 else 

41 System . out . pri nt(chars [i ] + " ") ; 

42 } 

43 } 
44 

45 /** Count the occurrences of each letter */ 

46 public static int[] countLetters(char [] chars) { 

47 // Declare and create an array of 26 int 

48 int[] counts = new int[26]; 
49 

50 // For each lowercase letter in the array, count it 

51 for (int i = 0; i < chars . 1 ength ; i++) 
count 52 counts [chars [i ] - 'a']++; 

53 

54 return counts; 

55 } 
56 

57 /** Display counts */ 

58 public static void displayCounts(int[] counts) { 

59 for (int i = 0; i < counts . 1 ength ; i++) { 

60 if ((i + 1) % 10 == 0) 

61 System. out. println(counts[i] + " " + (char)(i + 'a')); 

62 else 

63 System. out. pri nt(counts [i ] + " " + (char) (i + 'a') + " ") ; 

64 } 

65 } 

66 } 



The 


lowercase letters are: 






e y 


1 s r i b k 


j v j h 


a b z n w b 


t 


V 


s c 


c k r d w a 


m p w v 


u n q a m p 


1 





a z 


g d e g f i 


n d x m 


z o u 1 o z 


j 


V 


h w 


i w n t g x 


w c d o 


t x h y v z 


y 


z 


q e 


a m f w p g 


u q t r 


e n n w f c 


r 


f 


The 


occurrences 


of each 


letter are: 






5 a 


3 b 4 c 4 d 


4 e 4 f 


4 g 3 h 3 i 


3 


j 


2 k 


3 1 4 m 6 n 


4 o 3 p 


3 q 4 r 2 s 


4 


t 


3 u 


5 v 8 w 3 x 


3 y 6 z 









The createArray method (lines 21-32) generates an array of 100 random lowercase letters. 
Line 5 invokes the method and assigns the array to chars. What would be wrong if you 
rewrote the code as follows? 

char[] chars = new char[100]; 

chars = createArrayO ; 

You would be creating two arrays. The first line would create an array by using new 
char [100] . The second line would create an array by invoking createArrayO and assign 
the reference of the array to chars. The array created in the first line would be garbage 
because it is no longer referenced. Java automatically collects garbage behind the scenes. 
Your program would compile and run correctly, but it would create an array unnecessarily. 

Invoking getRandomLowerCaseLetter () (line 28) returns a random lowercase letter. 
This method is defined in the RandomCharacter class in Listing 5.10. 

The countLetters method (lines 46-55) returns an array of 26 int values, each of 
which stores the number of occurrences of a letter. The method processes each letter in the 
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array and increases its count by one. A brute-force approach to count the occurrences of each 
letter might be as follows: 

for (int i = 0; i < chars . 1 ength ; i++) 
if (chars [i] == 'a') 

counts[0]++; 
else if (chars[i] == 'b') 
counts[l]++; 

But a better solution is given in lines 51-52. 

for (int i = 0; i < chars . 1 ength ; 
counts [chars [i ] - 'a']++; 

If the letter (chars [i]) is 'a', the corresponding count is counts ['a' - 'a'] (i.e., 
counts [0]). If the letter is ' b', the corresponding count is counts['b' - 'a'] (i.e., 
counts [1] ), since the Unicode of ' b ' is one more than that of ' a ' . If the letter is ' z ' , the 
corresponding count is counts [ ' z ' - 'a'] (i.e., counts [25]), since the Unicode of ' z' is 
2 5 more than that of ' a ' . 

Figure 6.8 shows the call stack and heap during and after executing createArray. See 
Review Question 6.14 to show the call stack and heap for other methods in the program. 



Stack 

Space required for the 
createArray method 

char[] chars: ref 



Space required for the 
man n method 

char[] chars: ref 



Heap 



Array of 100 
characters 



(a) Executing 
createArray in line 5 



Stack 



Space required for the 
man n method 

char[] chars: ref 



Heap 



Array of 100 
characters 



(b) After exiting 
createArray in line 5 



Figure 6.8 (a) An array of 100 characters is created when executing createArray. 
(b) This array is returned and assigned to the variable chars in the mai n method. 



6.8 Variable-Length Argument Lists 

You can pass a variable number of arguments of the same type to a method. The parameter in 
the method is declared as follows: 

typeName . . . parameterName 

In the method declaration, you specify the type followed by an ellipsis (...). Only one vari- 
able-length parameter may be specified in a method, and this parameter must be the last para- 
meter. Any regular parameters must precede it. 

Java treats a variable-length parameter as an array. You can pass an array or a variable 
number of arguments to a variable-length parameter. When invoking a method with a variable 
number of arguments, Java creates an array and passes the arguments to it. Listing 6.5 con- 
tains a method that prints the maximum value in a list of an unspecified number of values. 

Listing 6.5 VarArgsDemo. java 



1 public class VarArgsDemo { 

2 public static void main(String[] args) { 

3 printMax(34, 3, 3, 2, 56.5); 



pass variable-length arg list 
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pass an array arg 



a variable-length arg 
parameter 



4 

5 

6 

7 

8 

9 
10 
11 
12 
13 
14 
15 
16 
17 
18 
19 
20 

21 } 



pri ntMax(new double[]{l, 2, 3}); 



} 



public static void printMax(double. . . numbers) { 
if (numbers . 1 ength == 0) { 

System. out . pri ntl n("No argument passed") ; 
return ; 

} 

double result = numbers[0]; 

for (int i = 1; i < numbers . 1 ength ; i++) 
if (numbers[i] > result) 
result = numbers[i]; 

System. out. println("The max value is " + result); 



Line 3 invokes the pri ntMax method with a variable-length argument list passed to the array 
numbers. If no arguments are passed, the length of the array is (line 8). 
Line 4 invokes the pri ntMax method with an array. 



6.9 Searching Arrays 

Searching is the process of looking for a specific element in an array — for example, discover- 
ing whether a certain score is included in a list of scores. Searching is a common task in com- 
linear search puter programming. Many algorithms and data structures are devoted to searching. This 

binary search section discusses two commonly used approaches, linear search and binary search. 

6.9.1 The Linear Search Approach 

The linear search approach compares the key element key sequentially with each element in 
the array. It continues to do so until the key matches an element in the array or the array is 
exhausted without a match being found. If a match is made, the linear search returns the index 
of the element in the array that matches the key. If no match is found, the search returns -1. 
The 1 i nearSearch method in Listing 6.6 gives the solution: 

Listing 6.6 Li nearSearch. java 

1 public class Li nearSearch { 

2 /** The method for finding a key in the list */ 

3 public static int linearSearch(int[] list, int key) { 

4 for (int i = 0; i < list. length; i++) { 

5 if (key == list[i]) 

6 return i ; [0] [1] [2] ... 



U I C LU I 1 1 J. , 

g } key Compare key with 1 i St [i ] for i = 0, 1, ... 

10 } 

To better understand this method, trace it with the following statements: 

int[] list = {1, 4, 4, 2, 5, -3, 6, 2}; 

int i = linearSearch(list, 4); // Returns 1 

int j = linearSearch(list, -4); // Returns -1 

int k = linearSearch(list, -3); // Returns 5 

The linear search method compares the key with each element in the array. The elements can 
be in any order. On average, the algorithm will have to compare half of the elements in an 
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array before finding the key, if it exists. Since the execution time of a linear search increases 
linearly as the number of array elements increases, linear search is inefficient for a large array. 

6.9.2 The Binary Search Approach 

Binary search is the other common search approach for a list of values. For binary search to 
work, the elements in the array must already be ordered. Assume that the array is in ascend- 
ing order. The binary search first compares the key with the element in the middle of the array. 
Consider the following three cases: 

■ If the key is less than the middle element, you need to continue to search for the key 
only in the first half of the array. 

■ If the key is equal to the middle element, the search ends with a match. 

■ If the key is greater than the middle element, you need to continue to search for the 
key only in the second half of the array. 

Clearly, the binary search method eliminates half of the array after each comparison. Some- 
times you eliminate half of the elements, and sometimes you eliminate half plus one. Suppose 
that the array has n elements. For convenience, let n be a power of 2. After the first compari- 
son, n/2 elements are left for further search; after the second comparison, (n/2)/2 elements 
are left. After the kth comparison, n/2 k elements are left for further search. When k = 1 og 2 n, 
only one element is left in the array, and you need only one more comparison. Therefore, in 
the worst case when using the binary search approach, you need 1 og 2 n+l comparisons to find 
an element in the sorted array. In the worst case for a list of 1024 (2 10 ) elements, binary 
search requires only 11 comparisons, whereas a linear search requires 1023 comparisons in 
the worst case. 

The portion of the array being searched shrinks by half after each comparison. Let 1 ow and 
high denote, respectively, the first index and last index of the array that is currently being 
searched. Initially, low is and high is 1 i st . 1 ength-1. Let mid denote the index of the 
middle element. So mid is (1 ow + high)/2. Figure 6.9 shows how to find key 11 in the list 
{2, 4, 7, 10, 11, 45, 50, 59, 60, 66, 69, 70, 79} using binary search. 

You now know how the binary search works. The next task is to implement it in Java. Don't 
rush to give a complete implementation. Implement it incrementally, one step at a time. You 
may start with the first iteration of the search, as shown in Figure 6.10(a). It compares the key 
with the middle element in the list whose 1 ow index is and high index is 1 i st . 1 ength - 1. 
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Figure 6.9 Binary search eliminates half of the list from further consideration after each 
comparison. 
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If key < 1 i st [mid], set the high index to mid - 1; if key == 1 ist[mid], a match is found 
and return mid; if key > 1 ist [mid], set the low index to mid + 1. 



public static int bi narySearch( 
int[] list, int key) { 
int low = 0; 

int high = list. length - 1; 



} 



int mid = (low + high) / 2; 
if (key < list [mid]) 

high = mid - 1; 
else if (key == list [mid]) 

return mid; 
el se 

low = mid + 1; 



public static int bi narySearch( 
int[] list, int key) { 
int low = 0; 

int high = list. length - 1; 

while (high >= low) { 

int mid = (low + high) / 2; 
if (key < list [mid]) 

high = mid - 1; 
else if (key == list [mid]) 

return mid; 
el se 

1 ow = mid + 1 ; 



} 



} 



return -1; // Not found 



(a) Version 1 

Figure 6.1 Binary search is implemented incrementally. 



(b) Version 2 



Next consider implementing the method to perform search repeatedly by adding a loop, as 
shown in Figure 6.10(b). The search ends if the key is found, or if the key is not found when 
low > high. 

why not -1? When the key is not found, low is the insertion point where a key would be inserted to 

maintain the order of the list. It is more useful to return the insertion point than -1. The 
method must return a negative value to indicate that the key is not in the list. Can it simply 
return -1 ow? No. If key is less than list [0] , 1 ow would be 0. -0 is 0. This would indicate 
that key matches 1 i st [0] . A good choice is to let the method return -1 ow - 1 if the key is 
not in the list. Returning -low - 1 indicates not only that the key is not in the list, but also 
where the key would be inserted. 

The complete program is given in Listing 6.7. 

Listing 6.7 Bi narySearch . java 

1 public class Bi narySearch { 

2 /** Use binary search to find the key in the list */ 

3 public static int binarySearch(int[] list, int key) { 

4 int low = 0; 

5 int high = list. length - 1; 
6 

7 while (high >= low) { 

8 int mid = (low + high) / 2; 

9 if (key < list[mid]) 
first half 10 high = mid - 1; 

11 else if (key == list [mid]) 

12 return mid; 

13 else 

second half 14 low = mid + 1; 

15 } 
16 

17 return -low - 1; // Now high < low, key not found 

18 } 

19 } 
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The binary search returns the index of the search key if it is contained in the list (line 12). Oth- 
erwise, it returns -low - 1 (line 17). 

What would happens if we replaced (high >= low) in line 7 with (high > low)? The 
search would miss a possible matching element. Consider a list with just one element. The 
search would miss the element. 

Does the method still work if there are duplicate elements in the list? Yes, as long as the 
elements are sorted in increasing order. The method returns the index of one of the matching 
elements if the element is in the list. 

To better understand this method, trace it with the following statements and identify 1 ow 
and high when the method returns. 

int[] list = {2, 4, 7, 10, 11, 45, 50, 59, 60, 66, 69, 70, 79}; 
int i = BinarySearch.binarySearch("list, 2); // Returns 
int j = BinarySearch.binarySearch("list, 11); // Returns 4 
int k = BinarySearch.binarySearch("list, 12); // Returns -6 
int 1 = BinarySearch.binarySearch("list, 1); // Returns -1 
int m = BinarySearch.binarySearch("list, 3); // Returns -2 

Here is the table that lists the low and high values when the method exits and the value 
returned from invoking the method. 



Method Low High Value Returned 



binarySearch(list, 2) 





1 





binarySearch(list, 11) 


3 


5 


4 


binarySearch(list, 12) 


5 


4 


-6 


binarySearch(list, 1) 





-1 


-1 


binarySearch(list, 3) 


1 





-2 



Note 

Linear search is useful for finding an element in a small array or an unsorted array, but it is ineffi- 
cient for large arrays. Binary search is more efficient, but it requires that the array be presorted. binary search benefits 



6.10 Sorting Arrays 

Sorting, like searching, is a common task in computer programming. Many different algo- 
rithms have been developed for sorting. This section introduces two simple, intuitive sorting 
algorithms: selection sort and insertion sort. 

6.10.1 Selection Sort 

Suppose that you want to sort a list in ascending order. Selection sort finds the smallest num- 
ber in the list and places it first. It then finds the smallest number remaining and places it next 

., . , , , . „ , . , , ,. Video Note 

to first, and so on, until only a single number remains. Figure 6.11 shows how to sort a list Selection sort 

{2, 9, 5, 4, 8, 1, 6} using selection sort. 

You know how the selection-sort approach works. The task now is to implement it in Java. 
Beginners find it difficult to develop a complete solution on the first attempt. Start by writing 
the code for the first iteration to find the largest element in the list and swap it with the last 
element, and then observe what would be different for the second iteration, the third, and so 
on. The insight this gives will enable you to write a loop that generalizes all the iterations. 
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The solution can be described as follows: 



for (int i = 0; i < list. length - 1; i++) { 

— select the smallest element in 1 i st [i . . 1 i st . 1 ength-1] ; 

— swap the smallest with list[i], if necessary; 

// list[i] is in its correct position. 

// The next iteration apply on list[i+l. . 1 i st . 1 ength-1] 

} 



Listing 6.8 implements the solution. 



Listing 6.8 SelectionSort. java 



1 public class SelectionSort { 

2 /** The method for sorting the numbers */ 

3 public static void selectionSort(double[] list) { 

4 for (int i = 0; i < list. length - 1; i++) { 

5 // Find the minimum in the 1 i st [i .. 1 i st . 1 ength-1] 

6 double currentMin = list[i]; 

7 int currentMi nlndex = i; 



9 
10 
11 
12 
13 

.14 
15 
16 
17 
18 
19 

.20 
21 
22 
23 



for (int j = i + 1; j < list. length; { 
if (currentMin > list[j]) { 
currentMin = list[j]; 
currentMi nlndex = j; 

} 

} 

// Swap list[i] with list[currentMinIndex] if necessary; 
if (currentMi nlndex != i) { 

1 i st [currentMi nlndex] = list[i]; 

list[i] = currentMin; 

} 



} 



The selectionSort(double[] list) method sorts any array of double elements. The 
method is implemented with a nested for loop. The outer loop (with the loop control variable 
i) (line 4) is iterated in order to find the smallest element in the list, which ranges from 
1 ist [i] to 1 ist[l ist .1 ength-1], and exchange it with 1 ist[i]. 

The variable i is initially 0. After each iteration of the outer loop, 1 i st [i ] is in the right 
place. Eventually, all the elements are put in the right place; therefore, the whole list is sorted. 

To understand this method better, trace it with the following statements: 

double[] list = {1, 9, 4.5, 6.6, 5.7, -4.5}; 
Sel ecti onSort . sel ecti onSort(l ist); 



6.10.2 Insertion Sort 

Suppose that you want to sort a list in ascending order. The insertion-sort algorithm sorts a list 
of values by repeatedly inserting a new element into a sorted sublist until the whole list is 
sorted. Figure 6.12 shows how to sort the list {2, 9, 5, 4, 8, 1, 6} using insertion sort. 
The algorithm can be described as follows: 

for (int i = 1; i < list. length; i++) { 

insert list[i] into a sorted sublist list[0..i-l] so that 
list[0. .i] is sorted. 

} 
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Step 1: (the smallest) and swap it 
with 2 (the first) in the list 

The number 1 is now in the 
correct position and thus no 
longer needs to be considered. 

The number 2 is now in the 
correct position and thus no 
longer needs to be considered. 



swap 

* } 

2 9 5 4 8 1 6 

swap 

f } 

1 9 5 4 8 2 6 

swap 

n 

1 2 5 4 8 9 6 



Select 2 (the smallest) and swap it 
with 9 (the first) in the remaining 
list 



Select 4 (the smallest) and swap it 
with 5 (the first) in the remaining 
list 



The number 4 is now in the 
correct position and thus no 
longer needs to be considered. 

The number 5 is now in the 
correct position and thus no 
longer needs to be considered. 

The number 6 is now in the 
correct position and thus no 
longer needs to be considered. 



1 2 4 5 8 9 6 

swap 

f } 

1 2 4 5 8 9 6 

swap 

n 

1 2 4 5 6 9 8 



5 is the smallest and in the right 
position. No swap is necessary 



Select 6 (the smallest) and swap it 
with 8 (the first) in the remaining 
list 



Select 8 (the smallest) and swap it 
with 9 (the first) in the remaining 
list 



The number 8 is now in the 
correct position and thus no 
longer needs to be considered. 



Since there is only one element 
1 2 4 5 6 8 9 remaining in the list, sort is 

completed 



Figure 6. 1 1 Selection sort repeatedly selects the smallest number and swaps it with the first number in the list. 



Step 1: Initially, the sorted sublist contains the 2 9 5 4 8 1 6 
first element in the list. Insert 9 to the sublist. 



Step 2: The sorted sublist is (2, 9). Insert 5 to 
the sublist. 



f I 

2 9 5 4 



1 6 



Step 3: The sorted sublist is (2, 5, 9). Insert 4 to 2 5 9 4 8 1 6 
the sublist. 



Step 4: The sorted sublist is {2, 4, 5, 9). Insert 8 2 4 5 9 
to the sublist. 



1 6 



Step 5: The sorted sublist is {2, 4, 5, 8, 9). Insert 2 4 5 8 9 1 6 
1 to the sublist. 



Step 6: The sorted sublist is (1, 2, 4, 5, 8, 9). 12 4 5 

Insert 6 to the sublist. 



9 6 



Step 7: The entire list is now sorted 1 2 4 5 6 8 9 

Figure 6.1 2 Insertion sort repeatedly inserts a new element into a sorted sublist. 
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To insert list[i] into list[0. .1-1], save list[i] into a temporary variable, say 
currentElement. Move list[i-l] to list[i] if list[i-l] > currentElement, 
move list[i-2] to list[i-l] if list[i-2] > currentElement, and so on, until 
list[i-k] <= currentElement or k > i (we pass the first element of the sorted list). 
Assign currentElement to 1 ist[i-k+l]. For example, to insert 4 into {2, 5, 9} in Step 3 
in Figure 6.13, move 1 ist[2] (9) to 1 ist[3] since 9 > 4, move 1 ist[l] (5) to 1 ist[2] 
since 5 > 4. Finally, move currentElement (4) to 1 ist[l]. 

The algorithm can be expanded and implemented as in Listing 6.9. 

Listing 6.9 InsertionSort . java 

1 public class InsertionSort { 

2 /** The method for sorting the numbers */ 

3 public static void insertionSort(double[] list) { 

4 for (int i =1; i < list. length; i++) { 

5 /** insert list[i] into a sorted sublist list[0..i-l] so that 

6 list[0..i] is sorted. */ 

7 double currentElement = list[i]; 

8 int k; 

shift 9 for (k = i - 1; k >= && list[k] > currentElement; k--) { 

10 list[k + 1] = list[k] ; 

11 } 
12 

13 // Insert the current element into list[k + 1] 

insert 14 list[k + 1] = currentElement; 

15 } 

16 } 

17 } 



[0][1][2][3][4][5][6] 



list | 2 5 9 4 | Step 1: Save 4 to a temporary variable currentEl ement 

[0][1][2][3][4][5][6] 



list | 2 5 9 | Step 2: Move list [2] to list [3] 

[0][1][2][3][4][5][6] 



list | 2 5 9 | Step 3: Move 1 i st [1] to list [2] 

[0] [1] [2] [3] [4] [5] [6] 



list | 2 4 5 9 | Step 4: Assign currentElement to list [1] 

Figure 6.1 3 A new element is inserted into a sorted sublist. 



The insertionSort(double[] 1 ist) method sorts any array of double elements. The 
method is implemented with a nested for loop. The outer loop (with the loop control variable 
i) (line 4) is iterated in order to obtain a sorted sublist, which ranges from list[0] to 
1 ist[i]. The inner loop (with the loop control variable k) inserts 1 ist[i] into the sublist 
fromlist[0] tolist[i-l]. 

To better understand this method, trace it with the following statements: 

double[] list = {1, 9, 4.5, 6.6, 5.7, -4.5}; 
Inserti onSort . i nserti onSort(l ist); 
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6.1 I The Arrays Class 

The java.util .Arrays class contains various static methods for sorting and searching 
arrays, comparing arrays, and filling array elements. These methods are overloaded for all 
primitive types. 

You can use the sort method to sort a whole array or a partial array. For example, the fol- sort 
lowing code sorts an array of numbers and an array of characters. 

double[] numbers = {6.0, 4.4, 1.9, 2.9, 3.4, 3.5}; 
java.util .Arrays. sort(numbers) ; // Sort the whole array 

char[] chars = {'a', 'A', '4', 'F', ' D' , 'P'}; 

java.util .Arrays. sort(chars, 1, 3); // Sort part of the array 

Invoking sort (numbers) sorts the whole array numbers. Invoking sort (chars, 1, 3) 
sorts a partial array from chars[l] to chars[3-l] . 

You can use the bi narySearch method to search for a key in an array. The array must be binarySearch 
presorted in increasing order. If the key is not in the array, the method returns -(insertion 
index + 1). For example, the following code searches the keys in an array of integers and an 
array of characters. 

int[] list = {2, 4, 7, 10, 11, 45, 50, 59, 60, 66, 69, 70, 79}; 
System. out. println("(l) Index is " + 

java.util . Arrays. binarySearch(list, 11)) ; 
System. out. println("(2) Index is " + 

java.util . Arrays. binarySearch(list, 12)) ; 

char[] chars = {'a', 'c', 'g', 'x' , 'y' , 'z'}; 
System. out. println("(3) Index is " + 

java.util .Arrays. binarySearch (chars, 'a')) ; 
System. out. println("(4) Index is " + 

java.util .Arrays. binarySearch (chars, 't')) ; 

The output of the preceding code is 

(1) Index is 4 

(2) Index is -6 

(3) Index is 

(4) Index is -4 

You can use the equal s method to check whether two arrays are equal. Two arrays are equal equal s 
if they have the same contents. In the following code, 1 i st 1 and 1 i st2 are equal, but 1 i st2 
and 1 ist3 are not. 

int[] listl = {2, 4, 7, 10}; 
int[] list2 = {2, 4, 7, 10}; 
int[] list3 = {4, 2, 7, 10}; 

System . out . pri ntl n(java. uti 1 .Arrays . equal s(l i stl, list2)); // true 
System . out . pri ntl n(java. uti 1 .Arrays . equal s(l i st2 , list3)); // false 

You can use the fill method to fill in all or part of the array. For example, the following code fill 
fills 1 i stl with 5 and fills 8 into elements 1 i st2 [1] and 1 i st2 [3-1] . 

int[] listl = {2, 4, 7, 10}; 
int[] list2 = {2, 4, 7, 10}; 

java. uti 1 .Arrays . fi 1 1 (1 i stl, 5); // Fill 5 to the whole array 
java. uti 1 .Arrays . fi 1 1 (1 i st2 , 1, 3, 8); // Fill 8 to a partial array 
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Key Terms 
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array initializer 201 
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index 198 

indexed variable 200 
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linear search 216 
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Chapter Summary 



1 . A variable is declared as an array type using the syntax el ementType [] ar rayRef - 
Var or el ementType ar rayRef Var [] . The style el ementType [] arrayRef Var 
is preferred, although el ementType arrayRefVar [] is legal. 

2. Unlike declarations for primitive data type variables, the declaration of an array vari- 
able does not allocate any space in memory for the array. An array variable is not a 
primitive data type variable. An array variable contains a reference to an array. 

3. You cannot assign elements to an array unless it has already been created. You can 
create an array by using the new operator with the following syntax: new element- 
Type [arraySi ze] . 

4. Each element in the array is represented using the syntax arrayRefVar [i ndex] . An 
index must be an integer or an integer expression. 

5. After an array is created, its size becomes permanent and can be obtained using 
arrayRefVar . 1 ength. Since the index of an array always begins with 0, the last 
index is always arrayRefVar . 1 ength - 1. An out-of-bounds error will occur if you 
attempt to reference elements beyond the bounds of an array. 

6. Programmers often mistakenly reference the first element in an array with index 1, but 
it should be 0. This is called the index off-by-one error. 

7. When an array is created, its elements are assigned the default value of for the 
numeric primitive data types, ' \u0000 1 for char types, and f al se for bool ean types. 

8. Java has a shorthand notation, known as the array initializer, which combines in one 
statement declaring an array, creating an array, and initializing, using the syntax: 
elementType[] arrayRefVar = {valueO, valuel valued}. 

9. When you pass an array argument to a method, you are actually passing the reference of 
the array; that is, the called method can modify the elements in the caller's original array. 



Review Questions 



Section 6.2 

6.1 How do you declare and create an array? 

6.2 How do you access elements of an array? 
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6.3 Is memory allocated for an array when it is declared? When is the memory allo- 
cated for an array? What is the printout of the following code? 

int x = 30; 

int[] numbers = new int[x]; 
x = 60; 

System. out. print"ln("x is " + x) ; 

System. out. println("The size of numbers is " + numbers . 1 ength) ; 

6.4 Indicate true or false for the following statements: 

■ Every element in an array has the same type. 

■ The array size is fixed after it is declared. 

■ The array size is fixed after it is created. 

■ The elements in an array must be of primitive data type. 

6.5 Which of the following statements are valid array declarations? 

int i = new int(30) ; 
double d[] = new double [30]; 
char[] r = new char(1..30); 
int i[] = (3, 4, 3, 2); 
float f[] = {2.3, 4.5, 6.6}; 
char[] c = new char(); 

6.6 What is the array index type? What is the lowest index? What is the representation 
of the third element in an array named a? 

6.7 Write statements to do the following: 

a. Create an array to hold 10 double values. 

b. Assign value 5 . 5 to the last element in the array. 

c. Display the sum of the first two elements. 

d. Write a loop that computes the sum of all elements in the array. 

e. Write a loop that finds the minimum element in the array. 

f. Randomly generate an index and display the element of this index in the array. 

g. Use an array initializer to create another array with initial values 3.5, 5.5, 
4. 52, and 5.6. 

6.8 What happens when your program attempts to access an array element with an 
invalid index? 

6.9 Identify and fix the errors in the following code: 

1 public class Test { 

2 public static void mai n(Stri ng [] args) { 

3 double [100] r; 
4 

5 for (int i =0; i < r. 1 ength O; i++); 

6 r(i) = Math. random * 100; 

7 } 

8 } 

Section 6.3 

6.1 Use the arraycopy () method to copy the following array to a target array t: 



int[] source = {3, 4, 5}; 
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6.1 I Once an array is created, its size cannot be changed. Does the following code 
resize the array? 

int[] myList; 

myList = new int[10]; 

// Some time later you want to assign a new array to myList 
myList = new int[20]; 

Sections 6.4-6.7 

6.12 When an array is passed to a method, a new array is created and passed to the 
method. Is this true? 

6.13 Show the output of the following two programs: 



public class Test { 

public static void mai n(Stri ng [] args) { 
int number = 0; 
int[] numbers = new int[l]; 

m(number, numbers); 

System. out. pri ntl n ("number is " + number 
+ " and numbers[0] is " + numbers [0]); 

} 

public static void m(int x, int[] y) { 

x = 3; 
y[0] = 3; 

} 



public class Test { 

public static void main(String[] args) { 
int[] list = {1, 2, 3, 4, 5}; 
reverseO i st) ; 

for (int i = 0; i < list. length; i++) 
System. out. pri nt(l i st [i ] + " ") ; 

} 

public static void reverse(int [] list) { 
int[] newList = new int [1 ist. length] ; 

for (int i = 0; i < list. length; i++) 
newList[i] = 1 i st [1 i st . 1 ength - 1 - i]; 

list = newList; 



6.14 Where are the arrays stored during execution? Show the contents of the stack and 
heap during and after executing createArray, displayArray, countLetters, 
di spl ayCounts in Listing 6.4. 

Section 6.8 

6.15 What is wrong in the following method declaration? 

public static void pri nt(Stri ng . . . strings, double... numbers) 
public static void print(double. . . numbers, String name) 
public static double... print(double dl, double d2) 

6.16 Can you invoke the printMax method in Listing 6.5 using the following state- 
ments? 

printMax(l, 2, 2, 1, 4); 
printMax(new doublet] {1, 2, 3}); 
printMax(new int[]{l, 2, 3}); 

Sections 6.9-6.10 

6.17 Use Figure 6.9 as an example to show how to apply the binary search approach to 
a search for key 10 and key 12 in list {2, 4, 7, 10, 11, 45, 50, 59, 60, 66, 69, 70, 
79}. 
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6.18 Use Figure 6.11 as an example to show how to apply the selection-sort approach to 
sort {3.4, 5, 3, 3.5, 2.2, 1.9, 2}. 

6.19 Use Figure 6. 12 as an example to show how to apply the insertion-sort approach to 
sort {3.4, 5, 3, 3.5, 2.2, 1.9, 2}. 

6.20 How do you modify the sel ectionSort method in Listing 6.8 to sort numbers in 
decreasing order? 

6.2 I How do you modify the i nsertionSort method in Listing 6.9 to sort numbers in 
decreasing order? 

Section 6. 1 1 

6.22 What types of array can be sorted using the java. util .Arrays, sort method? 
Does this sort method create a new array? 

6.23 To apply java. util .Ar rays. binarySearch (array, key) , should the array 
be sorted in increasing order, in decreasing order, or neither? 

6.24 Show the contents of the array after the execution of each line. 

int[] list = {2, 4, 7, 10}; 

java. util .Arrays. fill (list, 7) ; 

java. util .Arrays. fill (list, 1, 3, 8); 

System. out. print(java. util . Arrays . equal s (1 i st , list)) ; 

Programming Exercises 

Section 6.2 

6.1 * (Assigning grades) Write a program that reads student scores, gets the best score, 
and then assigns grades based on the following scheme: 



Grade is A if score is > = 


best — 


10: 


Grade is B if score is > = 


best — 


20; 


Grade is C if score is > = 


best — 


30; 


Grade is D if score is > = 


best — 


40; 


Grade is F otherwise. 







The program prompts the user to enter the total number of students, then prompts 
the user to enter all of the scores, and concludes by displaying the grades. Here is 
a sample run: 



Enter the number of students: 4 )^ 
Enter 4 scores: 40 55 70 58 ^ Enter 

Student score is 40 and grade is C 

Student 1 score is 55 and grade is B 

Student 2 score is 70 and grade is A 

Student 3 score is 58 and grade is B 



6.2 (Reversing the numbers entered) Write a program that reads ten integers and dis- 
plays them in the reverse of the order in which they were read. 

6.3** (Counting occurrence of numbers) Write a program that reads the integers 
between 1 and 100 and counts the occurrences of each. Assume the input ends 
with 0. Here is a sample run of the program: 
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Enter the integers between 1 and 100: 2 5 6 5 4 3 23 

43 2 |^ E"ter 

2 occurs 2 times 

3 occurs 1 time 

4 occurs 1 time 

5 occurs 2 times 

6 occurs 1 time 
23 occurs 1 time 
43 occurs 1 time 



Note that if a number occurs more than one time, the plural word "times" is used 
in the output. 

6.4 (Analyzing scores) Write a program that reads an unspecified number of scores 
and determines how many scores are above or equal to the average and how many 
scores are below the average. Enter a negative number to signify the end of the 
input. Assume that the maximum number of scores is 10. 

6.5** (Printing distinct numbers) Write a program that reads in ten numbers and dis- 
plays distinct numbers (i.e., if a number appears multiple times, it is displayed 
only once). Hint: Read a number and store it to an array if it is new. If the number 
is already in the array, ignore it. After the input, the array contains the distinct 
numbers. Here is the sample run of the program: 



Enter ten numbers: 1232163452 
The distinct numbers are: 12 3 6 4 5 



6.6* (Revising Listing 4.14, PrimeNumber.java) Listing 4.14 determines whether a 
number n is prime by checking whether 2, 3, 4, 5, 6, . . . , n/2 is a divisor. If a 
divisor is found, n is not prime. A more efficient approach is to check whether any 
of the prime numbers less than or equal to Vn can divide n evenly. If not, n is 
prime. Rewrite Listing 4.11 to display the first 50 prime numbers using this 
approach. You need to use an array to store the prime numbers and later use them 
to check whether they are possible divisors for n. 

6.7* (Counting single digits) Write a program that generates 100 random integers between 
and 9 and displays the count for each number. (Hint: Use (i nt) (Math . randomO 
- 10) to generate a random integer between and 9. Use an array of ten integers, say 
counts, to store the counts for the number of 0s, Is, . . . , 9s.) 



Sections 6.4-6.7 

6.8 (Averaging an array) Write two overloaded methods that return the average of an 
array with the following headers: 

public static int average(int [] array) 
public static double average (doublet] array) 

Write a test program that prompts the user to enter ten double values, invokes this 
method, and displays the average value. 

6.9 (Finding the smallest element) Write a method that finds the smallest element in 
an array of integers using the following header: 

public static double min(double[] array) 
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Write a test program that prompts the user to enter ten numbers, invokes this 
method to return the minimum value, and displays the minimum value. Here is a 
sample run of the program: 



Enter ten numbers: 


1.9 


2 


5 3.7 2 1.5 6 3 4 5 2 F^l 


The minimum number 


i s : 


1 


5 



6.10 (Finding the index of the smallest element) Write a method that returns the index 
of the smallest element in an array of integers. If the number of such elements is 
greater than 1, return the smallest index. Use the following header: 

public static int indexOf Small estElement(double[] array) 

Write a test program that prompts the user to enter ten numbers, invokes this 
method to return the index of the smallest element, and displays the index. 

6.11* (Statistics: computing deviation) Exercise 5.21 computes the standard deviation of 
numbers. This exercise uses a different but equivalent formula to compute the 
standard deviation of n numbers. 



n I n 

, ^(Xj - mean) 2 

i=l *l + x 2 + ... + x n ... / (=1 

mean = = deviation = \j 

n n V n 1 

To compute deviation with this formula, you have to store the individual numbers 
using an array, so that they can be used after the mean is obtained. 
Your program should contain the following methods: 

/** Compute the deviation of double values*/ 
public static double deviation(double[] x) 

/** Compute the mean of an array of double values"-/ 
public static double mean(double[] x) 

Write a test program that prompts the user to enter ten numbers and displays the 
mean and deviation, as shown in the following sample run: 



Enter ten numbers: 1.9 2 . 5 3 . 7 2 1 6 3 4 5 2 
The mean is 3.11 

The standard deviation is 1.55738 



6.12* (Reversing an array) The reverse method in §6.7 reverses an array by copying it 
to a new array. Rewrite the method that reverses the array passed in the argument 
and returns this array. Write a test program that prompts the user to enter ten num- 
bers, invokes the method to reverse the numbers, and displays the numbers. 

Section 6.8 

6.13* (Random number chooser) Write a method that returns a random number between 
1 and 54, excluding the numbers passed in the argument. The method header is 
specified as follows: 

public static int getRandom(int. . . numbers) 



230 Chapter 6 Single-Dimensional Arrays 

6.14 (Computing gcd) Write a method that returns the gcd of an unspecified number 
of integers. The method header is specified as follows: 

public static int gcd(int... numbers) 

Write a test program that prompts the user to enter five numbers, invokes the 
method to find the gcd of these numbers, and displays the gcd. 

Sections 6.9-6.10 

6.15 (Eliminating duplicates) Write a method to eliminate the duplicate values in the 
array using following method header: 

public static int[] eliminateDuplicates(int[] numbers) 

Write a test program that reads in ten integers, invokes the method, and displays 
the result. Here is the sample run of the program: 



Enter ten numbers: 1232163452 |^ Ent»r 
The distinct numbers are: 12 3 6 4 5 



6.1 6 (Execution time) Write a program that randomly generates an array of 100000 
integers and a key. Estimate the execution time of invoking the 1 inearSearch 
method in Listing 6.6. Sort the array and estimate the execution time of invoking 
the binarySearch method in Listing 6.7. You can use the following code tem- 
plate to obtain the execution time: 

long startTime = System . currentTi meMi 1 1 i s() ; 
perform the task; 

long endTime = System. currentTimeMillisO ; 
long executionTime = endTime - startTime; 

6.1 7* (Revising selection sort) In §6.10.1, you used selection sort to sort an array. 

The selection-sort method repeatedly finds the smallest number in the cur- 
rent array and swaps it with the first number in the array. Rewrite this pro- 
gram by finding the largest number and swapping it with the last number in 
the array. Write a test program that reads in ten double numbers, invokes the 
method, and displays the sorted numbers. 

6.18** (Bubble sort) Write a sort method that uses the bubble-sort algorithm. The bub- 
ble-sort algorithm makes several passes through the array. On each pass, succes- 
sive neighboring pairs are compared. If a pair is in decreasing order, its values 
are swapped; otherwise, the values remain unchanged. The technique is called a 
bubble sort or sinking sort because the smaller values gradually "bubble" their 
way to the top and the larger values "sink" to the bottom. Use {6.0, 4.4, 1.9, 
2.9, 3.4, 2.9, 3.5} to test the method. Write a test program that reads in ten 
double numbers, invokes the method, and displays the sorted numbers. 

6.19** (Sorting students) Write a program that prompts the user to enter the number of 
students, the students' names, and their scores, and prints student names in 
decreasing order of their scores. 

6.20*** (Game: Eight Queens) The classic Eight Queens puzzle is to place eight queens 
on a chessboard such that no two queens can attack each other (i.e., no two 
queens are on the same row, same column, or same diagonal). There are many 
possible solutions. Write a program that displays one such solution. A sample 
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output is shown below: 



6.2 I *** (Game: bean machine) The bean machine, also known as a quincunx or the Gal- 
ton box, is a device for statistic experiments named after English scientist Sir 
Francis Galton. It consists of an upright board with evenly spaced nails (or pegs) 
in a triangular form, as shown in Figure 6.14. 






(a) (b) (c) 

Figure 6.14 Each ball takes a random path and falls into a slot. 



Balls are dropped from the opening of the board. Every time a ball hits a nail, it 
has a 50% chance of falling to the left or to the right. The piles of balls are accu- 
mulated in the slots at the bottom of the board. 

Write a program that simulates the bean machine. Your program should 
prompt the user to enter the number of the balls and the number of the slots in 
the machine. Simulate the falling of each ball by printing its path. For example, 
the path for the ball in Figure 6.14(b) is LLRRLLR and the path for the ball in 
Figure 6.14(c) is RLRRLRR. Display the final buildup of the balls in the slots in 
a histogram. Here is a sample run of the program: 



Enter the 


number 


of 


balls 


to drop: 5 |^ Enter 


Enter the 


number 


of 


slots 


in the bean machine: 7 |^ Enter 


LRLRLRR 










RRLLLRR 










LLRLLRR 










RRLLLLL 










LRLRRLR 
































000 











(Hint: Create an array named si ots. Each element in si ots stores the number 
of balls in a slot. Each ball falls into a slot via a path. The number of R's in a 
path is the position of the slot where the ball falls. For example, for the path 
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LRLRLRR, the ball falls into si ots [4] , and for the path is RRLLLLL, the ball 
falls into si ots [2].) 

6.22*** (Game: multiple Eight Queens solutions) Exercise 6.20 finds one solution for 
the Eight Queens problem. Write a program to count all possible solutions for 
the eight queens problem and display all solutions. 

6.23** (Game: locker puzzle) A school has 100 lockers and 100 students. All lockers 
are closed on the first day of school. As the students enter, the first student, 
denoted SI, opens every locker. Then the second student, S2, begins with the 
second locker, denoted L2, and closes every other locker. Student S3 begins 
with the third locker and changes every third locker (closes it if it was open, and 
opens it if it was closed). Student S4 begins with locker L4 and changes every 
fourth locker. Student S5 starts with L5 and changes every fifth locker, and so 
on, until student S100 changes L100. 

After all the students have passed through the building and changed the lock- 
ers, which lockers are open? Write a program to find your answer. 

(Hint: Use an array of 100 bool ean elements, each of which indicates whether 
a locker is open (true) or closed (fal se). Initially, all lockers are closed.) 

6.24** (Simulation: coupon collector's problem) Coupon collector is a classic statistic 
problem with many practical applications. The problem is to pick objects from a 
set of objects repeatedly and find out how many picks are needed for all the 
objects to be picked at least once. A variation of the problem is to pick cards from 
a shuffled deck of 52 cards repeatedly and find out how many picks are needed 
before you see one of each suit. Assume a picked card is placed back in the deck 
before picking another. Write a program to simulate the number of picks needed 
to get four cards from each suit and display the four cards picked (it is possible a 
card may be picked twice). Here is a sample run of the program: 



Queen of Spades 
5 of Clubs 
Queen of Hearts 
4 of Diamonds 
Number of picks: 12 



6.25 (Algebra: solving quadratic equations) Write a method for solving a quadratic 
equation using the following header: 

public static int sol veQuad rati c(double[] eqn, doubled roots) 

The coefficients of a quadratic equation ax 2 + bx + c = are passed to the array 
eqn and the noncomplex roots are stored in roots. The method returns the number 
of roots. See Programming Exercise 3.1 on how to solve a quadratic equation. 

Write a program that prompts the user to enter values for a, b, and c and dis- 
plays the number of roots and all noncomplex roots. 

6.26 (Strictly identical arrays) Two arrays listl and list2 are strictly identical if 
they have the same length and listl[i] is equal to 1 ist2[i] for each i. Write 
a method that returns true if 1 istl and 1 ist2 are strictly identical, using the 
following header: 

public static boolean equal (int[] listl, int[] list2) 

Write a test program that prompts the user to enter two lists of integers and dis- 
plays whether the two are strictly identical. Here are the sample runs. Note that the 
first number in the input indicates the number of the elements in the list. 




Video Note 

Coupon collector's 
problem 
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Enter listl: 5 2 5 6 1 6 


*J Enter 




Enter list2: 5 2 5 6 16 


*J Enter 


Two lists are strictly identical 



Enter listl: 5 2 5 6 6 1 |^ Enter 
Enter list2: 5 2 5 6 1 6 Hnter 
Two lists are not strictly identical 



6.27 (Identical arrays) Two arrays listl and list2 are identical if they have the 
same contents. Write a method that returns true if 1 istl and 1 ist2 are identi- 
cal, using the following header: 

public static boolean equal (int[] listl, int[] list2) 

Write a test program that prompts the user to enter two lists of integers and dis- 
plays whether the two are identical. Here are the sample runs. Note that the first 
number in the input indicates the number of the elements in the list. 





Enter listl: 5 2 5 6 6 1 


«-J Enter 


Enter list2: 5 5 2 6 16 


^ Enter 


Two lists are identical 





Enter listl: 5 5 5 6 6 1 


—i Enter 


Enter list2: 5 2 5 6 16 


H Enter 


Two lists are not identical 



6.28 (Math: combinations) Write a program that prompts the user to enter 10 integers 
and displays all combinations of picking two numbers from the 10. 

6.29 (Game: picking four cards) Write a program that picks four cards from a deck of 
52 cards and computes their sum. An Ace, King, Queen, and Jack represent 1, 13, 
12, and 11, respectively. Your program should display the number of picks that 
yields the sum of 24. 

6.30 (Pattern recognition: consecutive four equal numbers) Write the following 
method that tests whether the array has four consecutive numbers with the same 
value. 

public static boolean isConsecutiveFour(int[] values) 

Write a test program that prompts the user to enter a series of integers and displays 
true if the series contains four consecutive numbers with the same value. Other- 
wise, display false. Your program should first prompt the user to enter the input 
size — i.e., the number of values in the series. 
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Chapter 



Multidimensional Arrays 

Objectives 

■ To give examples of representing data using two-dimensional arrays (§7.1). 

■ To declare variables for two-dimensional arrays, create arrays, and access array elements 
in a two-dimensional array using row and column indexes (§7.2). 

■ To program common operations for two-dimensional arrays 
(displaying arrays, summing all elements, finding min and 
max elements, and random shuffling) (§7.3). 

■ To pass two-dimensional arrays to methods (§7.4). 

■ To write a program for grading multiple-choice 
questions using two-dimensional arrays (§7.5). 

■ To solve the closest-pair problem using 
two-dimensional arrays (§7.6). 

■ To check a Sudoku solution using two-dimensional 
arrays (§7.7). 

■ To use multidimensional arrays (§7.8). 
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7.1 Introduction 

problem The preceding chapter introduced how to use one-dimensional arrays to store linear collec- 

tions of elements. You can use a two-dimensional array to store a matrix or a table. For exam- 
ple, the following table that describes the distances between the cities can be stored using a 
two-dimensional array. 



Distance Table (in miles) 





Chicago 


Boston 


New York 


Atlanta 


Miami 


Dallas 


Houston 


Chicago 





983 


787 


714 


1375 


967 


1087 


Boston 


983 





214 


1102 


1763 


1723 


1842 


New York 


787 


214 





888 


1549 


1548 


1627 


Atlanta 


714 


1102 


888 





661 


781 


810 


Miami 


1375 


1763 


1549 


661 





1426 


1187 


Dallas 


967 


1723 


1548 


781 


1426 
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Houston 


1087 


1842 


1627 


810 


1187 


239 






7.2 Two-Dimensional Array Basics 

How do you declare a variable for two-dimensional arrays? How do you create a two- 
dimensional array? How do you access elements in a two-dimensional array? This section 
addresses these issues. 

7.2. 1 Declaring Variables of Two-Dimensional Arrays and Creating 
Two-Dimensional Arrays 

Here is the syntax for declaring a two-dimensional array: 
el ementType [] [] arrayRef Var ; 

or 

elementType arrayRefVar[] [] ; // Allowed, but not preferred 

As an example, here is how you would declare a two-dimensional array variable matrix of 
int values: 

int[] [] matrix; 

or 

int matrix[][]; // This style is allowed, but not preferred 

You can create a two-dimensional array of 5-by-5 int values and assign it to matrix using 
this syntax: 

matrix = new int[5][5]; 

Two subscripts are used in a two-dimensional array, one for the row and the other for the col- 
umn. As in a one-dimensional array, the index for each subscript is of the int type and starts 
from 0, as shown in Figure 7.1(a). 

To assign the value 7 to a specific element at row 2 and column 1, as shown in Figure 7. 1(b), 
you can use the following: 

matrix[2] [1] =7; 
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[0][1][2][3][4] 



[0][1][2][3][4] 



[0][1][2] 



[0] 
[1] 
[2] 
[3] 
[4] 



matrix = new int[5][5] 



(a) 



[0] 
[1] 
[2] 
[3] 
[4] 



matrix[2] [1] 



(b) 



[0] 
[1] 
[2] 
[3] 



1 


2 


3 


4 


5 


6 


7 


8 


9 


10 


11 


12 



i nt [] [] array = 
{1, 2, 3}, 
{4, 5, 6}, 
{7, 8, 9}, 
{10, 11, 12} 

}; 

(c) 



Figure 7.1 The index of each subscript of a two-dimensional array is an i nt value, starting 
from 0. 



|B| Caution 

It is a common mistake to use matrix[2 , 1] to access the element at row 2 and column 1. In 
Java, each subscript must be enclosed in a pair of square brackets. 

You can also use an array initializer to declare, create, and initialize a two-dimensional 
array. For example, the following code in (a) creates an array with the specified initial values, 
as shown in Figure 7.1(c). This is equivalent to the code in (b). 



int [] [] array = 
{1, 2, 3}, 
{4, 5, 6}, 
{7, 8, 9}, 
{10, 11, 12} 

}; 

(a) 



Equivalent 



int[] [] array 


= new int [4] [3] ; 






array[0][0] = 


1; array[0][l] = 


2; array [0] [2] = 


3; 


array[l][0] = 


4; array[l][l] = 


5; array [1] [2] = 


6; 


array[2][0] = 


7; array[2][l] = 


8; array[2][2] = 


9; 


array[3][0] = 


10; array[3][l] = 


= 11; array[3] [2] 


= 12; 



(b) 



7.2.2 Obtaining the Lengths of Two-Dimensional Arrays 

A two-dimensional array is actually an array in which each element is a one-dimensional 
array. The length of an array x is the number of elements in the array, which can be obtained 
using x. length. x[0], x[l], and x[x.l ength- 1] are arrays. Their lengths can be 
obtained using x[0] .length, x[l] .length, . . . , and x[x.length-l] .length. 

For example, suppose x = new i nt [3] [4], x[0], x[l], and x [2] are one-dimensional 
arrays and each contains four elements, as shown in Figure 7.2. x. length is 3, and 
x[0] .length, x[l] .length, and x[2] .length are 4. 




x. length is 3 



x[0] [0] 


x[0][l] 


x[0][2] 


x[0][3] 




x[l] [0] 


x[l][l] 


x[l] [2] 


x[l][3] 




x[2][0] 


x[2][l] 


x[2][2] 


x[2][3] 



x[0] .1 ength is 4 
x[l] . 1 ength is 4 
x[2] .1 ength is 4 



Figure 7.2 A two-dimensional array is a one-dimensional array in which each element is 
another one-dimensional array. 
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7.2.3 Ragged Arrays 

Each row in a two-dimensional array is itself an array. Thus the rows can have different lengths. 
An array of this kind is known as a ragged array. Here is an example of creating a ragged array: 

int[][] triangleArray 

{1, 2, 3, 4, 5}, 

{2, 3, 4, 5}, 

{3, 4, 5}, 

{4, 5}, 
{5} 

}; 




As can be seen, triangl eArray[0] .length is 5, triangl eArray [1] .length is 
4, triangleArray[2] .length is 3, triangl eArray [3] . 1 ength is 2, and 
triangl eArray[4] .length is 1. 

If you don't know the values in a ragged array in advance, but know the sizes, say the same 
as before, you can create a ragged array using the syntax that follows: 

int[][] triangleArray = new int[5][] ; 
triangleArray[0] = new int[5] 
triangleArray[l] = new int[4] 
triangleArray[2] = new int[3] 
triangleArray[3] = new int[2] 
triangleArray[4] = new int[l] 

You can now assign values to the array. For example, 

triangleArray[0] [3] = 50; 
triangleArray[4] [0] = 45; 



Note 

The syntax new int [5] [] for creating an array requires the first index to be specified. The syn- 
tax new int[] [] would be wrong. 



7.3 Processing Two-Dimensional Arrays 

Suppose an array matrix is created as follows: 
int[][] matrix = new int[10][10]; 

Here are some examples of processing two-dimensional arrays: 

1. (Initializing arrays with input values) The following loop initializes the array with user 
input values: 

java.util .Scanner input = new Scanner(System . i n) ; 

System. out. pri ntl n("Enter " + matri x . 1 ength + " rows and " + 

matri x [0] . 1 ength + " columns: ") ; 
for (int row = 0; row < matrix. length ; row++) { 

for (int column = 0; column < matrix[row] .length ; column++) { 
matrix[row] [column] = i nput . nextlntO ; 

} 

} 

2. (Initializing arrays with random values) The following loop initializes the array with 
random values between and 99: 



for (int row = 0; row < matri x . 1 ength ; row++) { 

for (int column = 0; column < matrix [row] .length ; column++) { 
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matrix [row] [column] = (int) (Math . randomO * 100); 

} 

} 

3. (Printing arrays) To print a two-dimensional array, you have to print each element in 
the array using a loop like the following: 

for (int row = 0; row < matrix. length ; row++) { 

for (int column = 0; column < matrix[row] .length ; column++) { 
System. out. print(matrix[row] [column] + " ") ; 

} 

System. out. println() ; 

} 

4. (Summing all elements) Use a variable named total to store the sum. Initially total 
is 0. Add each element in the array to total using a loop like this: 

int total = 0; 

for (int row = 0; row < matri x . 1 ength ; row++) { 

for (int column = 0; column < matrix[row] .length; column++) { 
total += matrix[row] [col umn] ; 

} 

} 

5. (Summing elements by column) For each column, use a variable named total to store 
its sum. Add each element in the column to total using a loop like this: 

for (int column = 0; column < matrix[0] .length; column++) { 
int total = 0; 

for (int row = 0; row < matrix. length; row++) 

total += matrix[row] [col umn] ; 
System. out. println ("Sum for column " + column + " is " + 

total) ; 

} 

6. (Which row has the largest sum?) Use variables maxRow and i ndexOfMaxRow to track 
the largest sum and index of the row. For each row, compute its sum and update max Row 
and i ndexOfMaxRow if the new sum is greater. 

int maxRow = 0; 
int i ndexOfMaxRow = 0; 

// Get sum of the first row in maxRow 

for (int column = 0; column < matrix[0] .length; column++) { 
maxRow += matrix[0] [column] ; 

} 

for (int row = 1; row < matri x . 1 ength ; row++) { 
int total OfThisRow = 0; 

for (int column = 0; column < matrix[row] .length; column++) 
total OfThi sRow += matri x [row] [col umn] ; 

if (total OfThi sRow > maxRow) { 
maxRow = total OfThi sRow; 
i ndexOfMaxRow = row; 

} 

} 

System. out. println ("Row " + i ndexOfMaxRow 
+ " has the maximum sum of " + maxRow); 




Video Note 

find the row with the 
largest sum 
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7. (Random shuffling) Shuffling the elements in a one-dimensional array was introduced in 
§6.2.6. How do you shuffle all the elements in a two-dimensional array? To accomplish 
this, for each element matrix[i] [j], randomly generate indices il and jl and swap 
matrix[i] [j] with matrix[il] [jl], as follows: 



for (int i = 0; i < matrix. length; i++) { 
for (int j =0; j < matrix[i] .length; j++) { 
int il = (int) (Math . random() * matri x . 1 ength) ; 
int jl = (int) (Math . random() * mat rix[i] .length) ; 



// Swap matrix[i][j] with matrix[il] [jl] 
int temp = matrix[i] [j] ; 
matrix[i][j] = matrix[i 1] [jl] ; 
matrix[il] [jl] = temp; 

} 

} 



7.4 Passing Two-Dimensional Arrays to Methods 

You can pass a two-dimensional array to a method just as you pass a one-dimensional array. 
Listing 7.1 gives an example with a method that returns the sum of all the elements in a 
matrix. 



Listing 7.1 PassTwoDimensional Array, java 

1 import java. util .Scanner; 

2 

3 public class PassTwoDimensionalArray { 

4 public static void main(String[] args) { 

5 // Create a Scanner 

6 Scanner input = new Scanner(System.in) ; 
7 

8 // Enter array values 

9 int[][] m = new int[3][4]; 

10 System. out. pri ntl n("Enter " + m. length + " rows and " 

11 + m[0]. length + " columns: "); 

12 for (int i = 0; i < m. length; i++) 

13 for (int j = 0; j < m[i]. length; j++) 

14 m[i][j] = i nput . nextlnt() ; 
15 

16 // Display result 

pass array 17 System . out . pri ntl n ("\nSum of all elements is " + sum(m) ) ; 

18 } 
19 

20 public static int sum(int[][] m) { 

21 int total = 0; 

22 for (int row = 0; row < m. length; row++) { 

23 for (int column = 0; column < m[row] .length; column++) { 

24 total += m [row] [col umn] ; 

25 } 

26 } 
27 

28 return total ; 

29 } 

30 } 



7.5 Problem: Grading a Multiple-Choice Test 241 



Enter 3 rows and 4 columns: 

1 2 3 4 ^Enter 
5 6 7 8 Enter . 

9 10 11 12 F^l 

Sum of all elements is 78 



The method sum (line 20) has a two-dimensional array argument. You can obtain the number 
of rows using m. length (line 22) and the number of columns in a specified row using 
m[row] .column (line 23). 

7.5 Problem: Grading a Multiple-Choice Test 

The problem is to write a program that grades multiple-choice tests. Suppose there are eight 
students and ten questions, and the answers are stored in a two-dimensional array. Each row 
records a student's answers to the questions, as shown in the following array. 

Students' Answers to the Questions: 










1 


2 


3 


4 


5 


6 


7 


8 


9 


Student 





A 


B 


A 


C 


C 


D 


E 


E 


A 


D 


Student 


1 


D 


B 


A 


B 


C 


A 


E 


E 


A 


D 


Student 


2 


E 


D 


D 


A 


C 


B 


E 


E 


A 


D 


Student 


3 


C 


B 


A 


E 


D 


C 


E 


E 


A 


D 


Student 


4 


A 


B 


D 


C 


C 


D 


E 


E 


A 


D 


Student 


5 


B 


B 


E 


C 


C 


D 


E 


E 


A 


D 


Student 


6 


B 


B 


A 


C 


C 


D 


E 


E 


A 


D 


Student 


7 


E 


B 


E 


C 


C 


D 


E 


E 


A 


D 





Video Note 

Grade multiple-choice test 



The key is stored in a one-dimensional array: 

Key to the Questions: 
0123456789 
Key DBDCCDAEAD 



Your program grades the test and displays the result. It compares each student's answers with 
the key, counts the number of correct answers, and displays it. Listing 7.2 gives the program. 

Listing 7.2 GradeExam. java 

1 public class GradeExam { 



2 


/** Main method */ 










3 


public static void main(String[] args) { 








4 


// Students' answers 


to the questions 








5 


char[][] answers = { 










6 


{'A', 'B', 'A', 'C 


, 'C, 'D' , 'E', 


' E' , 


'A' , 


' D' } , 


7 


{ 'D' , 'B', 'A', 'B' 


, 'C, 'A', 'E', 


' E' , 


'A' , 


' D' } , 


8 


{'E', 'D' , ' D' , 'A' 


, 'C, 'B', 'E', 


' E' , 


'A' , 


' D' } , 


9 


{'C, 'B', 'A', 'E' 


, 'D', 'C, 'E', 


' E' , 


'A' , 


' D' } , 


10 


{'A', 'B', 'D', 'C 


, 'C, ' D' , 'E', 


' E' , 


'A' , 


' D' } , 


11 


{'B', 'B', 'E', 'C 


, 'C, ' D' , 'E', 


' E' , 


'A' , 


' D' } , 


12 


{ ' B' , 'B', 'A', 'C 


, 'C, ' D' , 'E', 


' E' , 


'A' , 


' D 1 } , 


13 


{'E', 'B', 'E', 'C 


, 'C, ' D' , 'E', 


' E' , 


'A' , 


'□■}}; 
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14 

15 // Key to the questions 
1-Darray 16 char[] keys={'D', 'B', 'D', 'C , 'C, 'D' , 'A', 'E', 'A', 'D'}; 

17 

18 // Grade all answers 

19 for (int i = 0; i < answers . 1 ength ; i++) { 

20 // Grade one student 

21 int correctCount = 0; 

22 for (int j = 0; j < answers [i ]. 1 ength ; { 
compare with key 23 if (answers [i ] [j] == keys[j]) 

24 correctCount++; 

25 } 
26 

27 System. out. pri ntl n("Student " + i + "'s correct count is " + 

28 correctCount) ; 

29 } 

30 } 

31 } 



Student 


0's 


correct 


count 


i s 


7 


Student 


l's 


correct 


count 


i s 


6 


Student 


2's 


correct 


count 


i s 


5 


Student 


3's 


correct 


count 


i s 


4 


Student 


4's 


correct 


count 


i s 


8 


Student 


5's 


correct 


count 


i s 


7 


Student 


6's 


correct 


count 


i s 


7 


Student 


7's 


correct 


count 


i s 


7 



The statement in lines 5-13 declares, creates, and initializes a two-dimensional array of char- 
acters and assigns the reference to answers of the char [] [] type. 

The statement in line 16 declares, creates, and initializes an array of char values and 
assigns the reference to keys of the char [] type. 

Each row in the array answers stores a student's answer, which is graded by comparing it with 
the key in the array keys. The result is displayed immediately after a student's answer is graded. 

7.6 Problem: Finding a Closest Pair 

The GPS navigation system is becoming increasingly popular. The system uses the graph and 
geometric algorithms to calculate distances and map a route. This section presents a geomet- 
ric problem for finding a closest pair of points. 







(-1,3). 


.(3,3) 




•(4,2) 




(1.1) 




•(2,0.5) 




• (4, -0.5) 


(-1,-1). 


•(2,-1) 





X 


y 





-1 


3 


1 


-1 


-1 


2 


1 


1 


3 


2 


0.5 


4 


2 


-1 


5 


3 


3 


6 


4 


2 


7 


4 


-0.5 



Figure 7.3 Points can be represented in a two-dimensional array. 
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Given a set of points, the closest-pair problem is to find the two points that are nearest to each 
other. In Figure 7.3, for example, points (1,1) and (2 , . 5) are closest to each other. There are 
several ways to solve this problem. An intuitive approach is to compute the distances between all 
pairs of points and find the one with the minimum distance, as implemented in Listing 7.3. 

Listing 7.3 FindNearestPoints. java 

1 import java. util .Scanner; 

2 

3 public class FindNearestPoints { 



4 public static void main(String[] args) { 

5 Scanner input = new Scanner(System . i n) ; 

6 System . out . pri nt("Enter the number of points: ") ; 

7 int numberOfPoi nts = input, nextlntfj ; number of points 
8 

9 // Create an array to store points 

10 double[][] points = new double[numberOf Points] [2] ; 2-D array 

11 System . out . pri nt("Enter " + numberOf Poi nts + " points: ") ; 

12 for (int i =0; i < poi nts . 1 ength ; i++) { read points 

13 points[i][0] = i nput . nextDoubl e() ; 

14 points[i][l] = i nput . nextDoubl e() ; 

15 } 
16 

17 // pi and p2 are the indices in the points array 

18 int pi = 0, p2 = 1; // Initial two points track two points 

19 double shortestDi stance = di stance(poi nts [pi] [0] , poi nts [pi] [1] , track shortestDi stance 

20 poi nts [p2] [0] , poi nts [p2] [1] ) ; // Initialize shortestDi stance 
21 

22 // Compute distance for every two points 

23 for (int i =0; i < poi nts . 1 ength ; i++) { for each point i 

24 for (int j = i + 1; j < poi nts . 1 ength ; { for each point j 

25 double distance = di stance(poi nts [i ] [0] , poi nts [i ] [1] , distance between i and j 

26 poi nts [j] [0] , poi nts [ j] [1] ) ; // Find distance distance between two points 
27 

28 if (shortestDi stance > distance) { 

29 pi = i ; // Update pi 

30 p2 = j; // Update p2 

31 shortestDi stance = distance; // Update shortestDi stance update shortestDi stance 

32 } 

33 } 

34 } 
35 

36 // Display result 

37 System. out. println("The closest two points are " + 

38 "(" + points[pl] [0] + ", " + poi nts [pi] [1] + ") and (" + 

39 points[p2] [0] + ", " + poi nts [p2] [1] + ")"); 

40 } 
41 

42 /** Compute the distance between two points (xl, yl) and (x2 , y2)*/ 

43 public static double distance( 

44 double xl, double yl, double x2 , double y2) { 

45 return Math . sqrt((x2 - xl) * (x2 - xl) + (y2 - yl) * (y2 - yl)); 

46 } 



47 } 



Enter the number of points: 8 






Enter 8 points: -1 3 -1-1 1 


1 2 


5 2 -1 3 3 4 2 4 -0.5 


The closest two points are (1, 


1) and 


(2, 0.5) 
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The program prompts the user to enter the number of points (lines 6-7). The points are read 
from the console and stored in a two-dimensional array named points (lines 12-15). The 
program uses variable shortestDi stance (line 19) to store the distance between two near- 
est points, and the indices of these two points in the points array are stored in pi and p2 
(line 18). 

For each point at index i, the program computes the distance between points [i] and 
points [j] for all j > i (lines 23-34). Whenever a shorter distance is found, the variable 
shortestDi stance and pi and p2 are updated (lines 28-32). 

The dis tance between two points (xl, yl) and (x2 , y2) can be computed using the 
formula V(x 2 - jq) 2 + (y 2 ~ Vi) 2 (lines 43^16). 

The program assumes that the plane has at least two points. You can easily modify the pro- 
gram to handle the case if the plane has zero or one point, 
multiple closest pairs Note that there might be more than one closest pair of points with the same minimum dis- 

tance. The program finds one such pair. You may modify the program to find all closest pairs 
in Programming Exercise 7.8. 

# Tip 

It is cumbersome to enter all points from the keyboard. You may store the input in a file, say 
FindNearestPoints.txt, and compile and run the program using the following command: 

java FindNearestPoints < FindNearestPoints.txt 

7.7 Problem: Sudoku 

This book teaches how to program using a wide variety of problems with various levels of dif- 
ficulty. We use simple, short, and stimulating examples to introduce programming and 
problem-solving techniques and use interesting and challenging examples to motivate stu- 
dents. This section presents an interesting problem of a sort that appears in the newspaper 
every day. It is a number-placement puzzle, commonly known as Sudoku. This is a very chal- 
lenging problem. To make it accessible to the novice, this section presents a solution to a sim- 
plified version of the Sudoku problem, which is to verify whether a solution is correct. The 
complete solution for solving the Sudoku problem is presented in Supplement VILA. 

Sudoku is a 9 X 9 grid divided into smaller 3X3 boxes (also called regions or blocks), as 
shown in Figure 7.4(a). Some cells, called fixed cells, are populated with numbers from 1 to 
9. The objective is to fill the empty cells, also called free cells, with numbers 1 to 9 so that 
every row, every column, and every 3X3 box contains the numbers 1 to 9, as shown in 
Figure 7.4(b). 



input file 



Video Note 

Sudoku 



fixed cells 
free cells 
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Solution 
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(a) Puzzle 

Figure 7.4 The Sudoku puzzle in (a) is solved in (b). 



(b) Solution 
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For convenience, we use value to indicate a free cell, as shown in Figure 7.5(a). The grid representing a grid 
can be naturally represented using a two-dimensional array, as shown in Figure 7.5(a). 



530070000 
600195000 
098000060 
800060003 
400803001 
700020006 
060000000 
000419005 
000080079 

(a) 



int[] [] grid = 

{{5, 3, 0, 0, 7, 0, 0, 0, 0} 

{6, 0, 0, 1, 9, 5, 0, 0, 0} 

{0, 9, 8, 0, 0, 0, 0, 6, 0} 

{8, 0, 0, 0, 6, 0, 0, 0, 3} 

{4, 0, 0, 8, 0, 3, 0, 0, 1} 

{7, 0, 0, 0, 2, 0, 0, 0, 6} 

{0, 6, 0, 0, 0, 0, 2, 8, 0} 

{0, 0, 0, 4, 1, 9, 0, 0, 5} 

{0, 0, 0, 0, 8, 0, 0, 7, 9} 

}; 



(b) 



Figure 7.5 A grid can be represented using a two-dimensional array. 



To find a solution for the puzzle we must replace each in the grid with an appropriate num- 
ber from 1 to 9. For the solution in Figure 7.4(b), the grid should be as shown in Figure 7.6. 



A solution gric 


is 








{{5, 
















2}, 


{6, 
















8}, 


{1, 
















7}, 


{8, 
















3}, 


{4, 
















1}, 


{7, 
















6}, 


{9, 
















4}, 


{2, 
















5}, 


{3, 

}; 
















9} 



Figure 7.6 A solution is stored in grid. 



A simplified version of the Sudoku problem is to check the validity of a solution. The pro- 
gram in Listing 7.4 prompts the user to enter a solution and reports whether it is valid. 

Listing 7.4 CheckSudokuSol ution . java 

1 import java. util .Scanner; 

2 

3 public class CheckSudokuSol uti on { 

4 public static void main(String[] args) { 

5 // Read a Sudoku solution 

6 int[][] grid = readASolution() ; read input 
7 

8 System. out. println(isValid(grid) ? "Valid solution" : solution valid? 

9 "Invalid solution") ; 
10 } 

11 

12 /** Read a Sudoku solution from the console */ 

13 public static int[][] readASol 

UtionO { read solution 

14 // Create a Scanner 

15 Scanner input = new Scanner(System.in) ; 



246 Chapter 7 Multidimensional Arrays 



check solution 
check rows 

check columns 



check small boxes 



all valid 



contains 1 to 9 ? 



copy of array 



sort array 



check 1 to 9 



16 
17 
18 
19 
20 
21 
22 
23 
24 
25 
26 
27 
28 
29 
30 
31 
32 
33 
34 
35 
36 
37 
38 
39 
40 
41 
42 
43 
44 
45 
46 
47 
48 
49 
50 
51 
52 
53 
54 
55 
56 
57 
58 
59 
60 
61 
62 
63 
64 
65 
66 
67 
68 
69 
70 
71 
72 
73 



); 



System. out. pri ntl n ("Enter a Sudoku puzzle solution: 
int[][] grid = new int[9][9]; 
for (int i =0; i < 9; 
for (int j = 0; j < 9; 

grid[i] [j] = input. nextlntO ; 

return grid; 

} 

/** Check whether a solution is valid */ 
public static boolean i sVal i d(int [] [] grid) { 
// Check whether each row has numbers 1 to 9 
for (int i =0; i < 9; i++) 

if ( ! i slTo9(gri d [i ] ) ) // If grid[i] does not contain 1 
return false; 

// Check whether each column has numbers 1 to 9 
for (int j = 0; j < 9; { 

// Obtain a column in the one-dimensional array 

int[] column = new int[9]; 

for (int i =0; i < 9; i++) { 
column[i] = grid[i] [j] ; 

} 



to 9 



if (!islTo9(column) ) 
return false; 



} 



// If column does not contain 1 to 9 



has numbers 1 to 9 



small 3-by-3 box 



// Check whether each 3-by-3 box 
for (int i = 0; i < 3; i++) { 
for (int j = 0; j < 3; { 

// The starting element in a 

int k = 0; 

int[] list = new int[9]; // Get all numbers in the box to list 
for (int row = i * 3; row < i * 3 + 3; row ++) 

for (int column = j * 3; column < j * 3 + 3; column++) 
list[k++] = gri d [row] [col umn] ; 



if (!islTo9(list) ) 
return false; 



// If list does not contain 1 to 9 



return true; // The fixed cells are valid 

} 

/** Check whether the one-dimensional array contains 1 to 9 */ 
public static boolean islTo9(int[] list) { 

// Make a copy of the array 

int[] temp = new int[list. length] ; 

System. arraycopy (list, 0, temp, 0, 1 i st . 1 ength) ; 

// Sort the array 

java.util .Arrays . sort(temp) ; 

// Check whether the list contains 1, 2, 3 9 

for (int i =0; i < 9; i++) 



7.7 Problem: Sudoku 247 



74 if (temp[i] != i + 1) 

75 return false; 

76 

77 return true; // The list contains exactly 1 to 9 

78 } 

79 } 



Enter a Sudoku 


puzz" 


e solution: 


9 6 3 1 7 4 2 


5 8 


«J Enter 




1 7 8 3 2 5 6 


4 9 


^ Enter 




2 5 4 6 8 9 7 


3 1 


■ — ' Enter 




8 2 1 4 3 7 5 


9 6 


-J Enter 




4 9 6 8 5 2 3 


1 7 


^ Enter 




7 3 5 9 6 1 8 


2 4 


*J Enter 




5 8 9 7 1 3 4 


6 2 


•J Enter 




3 1 7 2 4 6 9 


8 5 


^ Enter 




6 4 2 5 9 8 1 


7 3 


•J Enter 




Valid solution 







The program invokes the readASolutionO method (line 6) to read a Sudoku solution and 
return a two-dimensional array representing a Sudoku grid. 

The isVal id (grid) method (lines 27-61) checks whether every row contains numbers 1 
to 9 (lines 29-31). grid is a two-dimensional array. grid[i] is a one-dimensional array for 
the rth row. Invoking islTo9(grid[i]) returns true if the row grid[i] contains exactly 
numbers from 1 to 9 (line 30). 

To check whether each column in grid has numbers 1 to 9, get a column into a one- 
dimensional array (lines 36-39) and invoke the islTo9 method to check whether it has 1 to 
9 (line 41). 

To check whether each small 3X3 box in grid has numbers 1 to 9, get a box into a one- 
dimensional array (lines 49-53) and invoke the islTo9 method to check whether it has 1 to 
9 (line 55). 

How do you locate all the cells in the same box? First, locate the starting cells of the 
3X3 boxes. They are at (3i , 3j) for i = 0, 1, 2 and j = 0, 1, 2, as illustrated in 
Figure 7.7. 



i sVal i d method 
check rows 



check columns 



check small boxes 



grid[0][0] 



grid[6][3] 



The location of the starting cell for - 
each grid is at (3*i, 3*j) for i = 0, 1, 
2 and j = 0, 1, 2. For example, 
grid[6][3]). 



grid[0][6] 



Figure 7.7 The location of the first cell in a 3 X 3 box determines the locations of other cells 
in the box. 
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With this observation, you can easily identify all the cells in the box. Suppose 
grid[r] [c] is the starting cell of a 3 X 3 box. The cells in the box can be traversed in a 
nested loop as follows: 

// Get all cells in a 3-by-3 box starting at grid[r][c] 
for (int row = r; row < r + 3; row++) 

for (int column = c; column < c + 3; column++) 
// gri d [row] [col umn] is in the box 

All the numbers in a small box are collected into a one-dimensional array list (line 53), and 
invoking islTo9(l i st) checks whether list contains numbers 1 to 9 (line 55). 

islTo9 method The islTo9(list) method (lines 64-78) checks whether array list contains exactly 

numbers 1 to 9. It first copies 1 i st to a new array temp, then sorts temp. Note that if you sort 
list, the contents of grid will be changed. After temp is sorted, the numbers in temp 
should be 1, 2, . . . , 9, if temp contains exactly 1 to 9. The loop in lines 73-75 checks 
whether this is the case. 

It is cumbersome to enter 81 numbers from the console. When you test the program, you 

input file may store the input in a file, say CheckSudokuSolution.txt, and run the program using the fol- 

lowing command: 

java CheckSudokuSol uton < CheckSudokuSoluton.txt 



7.8 Multidimensional Arrays 

In the preceding section, you used a two-dimensional array to represent a matrix or a table. 
Occasionally, you will need to represent w-dimensional data structures. In Java, you can cre- 
ate ^-dimensional arrays for any integer n. 

The way to declare two-dimensional array variables and create two-dimensional arrays can 
be generalized to declare n-dimensional array variables and create w-dimensional arrays for 
n > = 3. For example, the following syntax declares a three-dimensional array variable 
scores, creates an array, and assigns its reference to scores. 

double[][][] data = new double[10] [24] [2] ; 

A multidimensional array is actually an array in which each element is another array. A three- 
dimensional array consists of an array of two-dimensional arrays, each of which is an array of 
one-dimensional arrays. For example, suppose x = new int[2] [2] [5], x[0] and x[l] 
are two-dimensional arrays. X[0][0], x[0][l], x[l][0], and x[l][l] are one- 
dimensional arrays and each contains five elements, x. length is 2, x[0] .length and 
x[l]. length are 2, and X[0] [0] .length, x[0] [1] .length, x[l] [0] .length, and 
x[l] [1] .length are 5. 



7.8.1 Problem: Daily Temperature and Humidity 

Suppose a meteorology station records the temperature and humidity at each hour of every 
day and stores the data for the past ten days in a text file named weather.txt. Each line of the 
file consists of four numbers that indicate the day, hour, temperature, and humidity. The con- 
tents of the file may look like the one in (a): 



1 1 76.4 





92 




10 24 98 


7 


0.74 


1 2 77.7 





93 




1 2 77.7 





93 


10 23 97 


7 


0.71 




10 23 97 


7 


0.71 


10 24 98 


7 


0.74 




1 1 76.4 





92 






(a) 






(b) 
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Note that the lines in the file are not necessary in order. For example, the file may appear 
as shown in (b). 

Your task is to write a program that calculates the average daily temperature and humidity 
for the 10 days. You can use the input redirection to read the file and store the data in a three- 
dimensional array, named data. The first index of data ranges from to 9 and represents 10 
days, the second index ranges from to 23 and represents 24 hours, and the third index 
ranges from to 1 and represents temperature and humidity, respectively. Note that the days 
are numbered from 1 to 10 and hours from 1 to 24 in the file. Since the array index starts from 
0, data[0] [0] [0] stores the temperature in day 1 at hour 1 and data[9] [23] [1] stores 
the humidity in day 10 at hour 24. 

The program is given in Listing 7.5. 

Listing 7.5 Weather, java 

1 import java. util .Scanner; 
2 

3 public class Weather { 

4 public static void main(String[] args) { 



5 final int NUMBER_0F_DAYS = 10; 

6 final int NUMBER_0F_H0URS = 24; 

7 double [] [] [] data 

8 = new double [NUMBER_0F_DAYS] [NUMBER_0F_H0URS] [2] ; three-dimensional array 
9 

10 Scanner input = new Scanner(System . i n) ; 

11 // Read input using input redirection from a file 

12 for (int k = 0; k < NUMBER_0F_DAYS * NUMBER_0F_H0URS ; k++) { 

13 int day = i nput . nextlntO ; 

14 int hour = i nput . nextlntO ; 

15 double temperature = i nput . nextDoubl e() ; 

16 double humidity = i nput . nextDoubl e() ; 

17 data[day - 1] [hour - 1] [0] = temperature; 

18 data[day - 1] [hour - 1] [1] = humidity; 

19 } 
20 

21 // Find the average daily temperature and humidity 

22 for (int i = 0; i < NUMBER_0F_DAYS ; i++) { 

23 double dai 1 yTemperatureTotal = 0, dailyHumidityTotal = 0; 

24 for (int j = 0; j < NUMBER_0F_H0URS ; { 

25 dai 1 yTemperatureTotal += data[i ] [j] [0] ; 

26 dailyHumidityTotal += data[i ] [j] [1] ; 

27 } 
28 

29 // Display result 

30 System. out . pri ntl n("Day " + i + "'s average temperature is " 

31 + dai 1 yTemperatureTotal / NUMBER_0F_H0URS) ; 

32 System. out . pri ntl n("Day " + i + "'s average humidity is " 

33 + dailyHumidityTotal / NUMBER_0F_H0URS) ; 

34 } 



35 } 
35 } 



Day 


0's 


average 


temperature 


is 77.7708 


Day 


0's 


average 


humidity is 


0.929583 


Day 


l's 


average 


temperature 


is 77.3125 


Day 


l's 


average 


humidity is 


0.929583 


Day 


9's 


average 


temperature 


is 79.3542 


Day 


9's 


average 


humidity is 


0.9125 
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You can use the following command to run the program: 

java Weather < Weather.txt 

A three-dimensional array for storing temperature and humidity is created in line 8. The loop 
in lines 12-19 reads the input to the array. You can enter the input from the keyboard, but doing 
so will be awkward. For convenience, we store the data in a file and use the input redirection to 
read the data from the file. The loop in lines 24-27 adds all temperatures for each hour in a day 
to dailyTemperatureTotal and all humidity for each hour to dailyHumidityTotal . The 
average daily temperature and humidity are displayed in lines 30-33. 



Listing 3.3, GuessBirthday.java, gives a program that guesses a birthday. The program can be 
simplified by storing the numbers in five sets in a three-dimensional array, and it prompts the 
user for the answers using a loop, as shown in Listing 7.6. The sample run of the program can 
be the same as shown in Listing 3.3. 

Listing 7.6 GuessBi rthdayUsi ngArray . java 

1 import java. util .Scanner; 

2 

3 public class GuessBi rthdayUsi ngArray { 

4 public static void main(String[] args) { 

5 int day = 0; // Day to be determined 

6 int answer; 



7.8.2 Problem: Guessing Birthdays 



three-dimensional array 



Seti 



7 
8 
9 
10 
11 
12 
13 
14 
15 
16 
17 
18 
19 
20 
21 
22 
23 
24 
25 
26 
27 
28 
29 
30 
31 
32 
33 
34 
35 
36 
37 
38 
39 



// Create a Scanner 

Scanner input = new Scanner(System.in) ; 



for (int i = 0; i < 5; i++) { 



int[] [] [] dates 



System. out . pri ntl n("Is your birthday in Set" + (i + 1) + "?") ; 
for (int j = 0; j < 4; { 



System. out. pri ntln() ; 

} 



{{ 1, 3, 5, 

{ 9, 11, 13, 

{17, 19, 21, 

{25, 27, 29, 

{{ 2, 3, 6, 

{10, 11, 14, 

{18, 19, 22, 

{26, 27, 30, 

{{ 4, 5, 6, 

{12, 13, 14, 

{20, 21, 22, 

{28, 29, 30, 

{{ 8, 9, 10, 

{12, 13, 14, 

{24, 25, 26, 

{28, 29, 30, 

{{16, 17, 18, 

{20, 21, 22, 

{24, 25, 26, 

{28, 29, 30, 



for (int k = 0; k < 4; k++) 



System. out. pri ntf("%4d", dates [i] [j] [k] ) ; 



= { 
7}, 
15}, 
23}, 
31}}, 

7}, 
15}, 
23}, 
31}}, 

7}, 
15}, 
23}, 
31}}, 
11}, 
15}, 
27}, 
31}}, 
19}, 
23}, 
27}, 



31}}}; 



Review Questions 25 1 



40 
41 
42 
43 
44 
45 
46 
47 
48 
49 
50 } 



} 



} 



System. out. print! n ("Your birth day is " + day); 



System. out . pri nt("\nEnter for No and 1 for Yes: ") ; 
answer = i nput . nextlntQ ; 



if (answer == 1) 

day += dates [i] [0] [0] ; 



add to Set i 



A three-dimensional array dates is created in Lines 8-28. This array stores five sets of num- 
bers. Each set is a 4-by-4 two-dimensional array. 

The loop starting from line 33 displays the numbers in each set and prompts the user to 
answer whether the birthday is in the set (lines 41-42). If the day is in the set, the first number 
(dates [i] [0] [0]) in the set is added to variable day (line 45). 



1 . A two-dimensional array can be used to store a table. 

2. A variable for two-dimensional arrays can be declared using the syntax: 
elementType[] [] arrayVar. 

3. A two-dimensional array can be created using the syntax: new el ementType- 
[R0W_SIZE] [COLUMN_SIZE] . 

4. Each element in a two-dimensional array is represented using the syntax: 
arrayVar [rowlndex] [col umnlndex] . 

5 . You can create and initialize a two-dimensional array using an array initializer with the 
syntax: el ementType[] [] arrayVar = {{row values} {row values}}. 

6. You can use arrays of arrays to form multidimensional arrays. For example, a vari- 
able for three-dimensional arrays can be declared as elementType[] [] [] 
arrayVar and a three-dimensional array can be created using new element- 
Type[sizel] [size2] [size3] . 



7. 1 Declare and create a 4-by-5 i nt matrix. 

7.2 Can the rows in a two-dimensional array have different lengths? 

7.3 What is the output of the following code? 

int[][] array = new int[5][6]; 
int[] x = {1, 2}; 
array[0] = x; 

System. out. pri ntln ("array [0] [1] is " + array[0] [1]) ; 

7.4 Which of the following statements are valid array declarations? 

int[][] r = new int[2]; 
int[] x = new int[] ; 
int[] [] y = new int[3] [] ; 



Chapter Summary 



Review Questions 
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7.5 Why does the i slTo9 method need to copy 1 i st to temp? What happens if you 
replace the code in lines 66-70 in Listing 7.4 with the following code: 

java. uti 1 .Arrays . sort (1 "i st) ; 

7.6 Declare and create a4x6x 5 int array. 

Programming Exercises 

7. 1 * (Summing all the numbers in a matrix) Write a method that sums all the integers in 
a matrix of integers using the following header: 

public static double sumMatrix(int[] [] m) 

Write a test program that reads a 4-by-4 matrix and displays the sum of all its ele- 
ments. Here is a sample run: 



Enter a 4-by-4 matrix row by row: 



1 


2 3 


4 


Enter 


5 


6 7 


8 


Enter 


9 


10 


11 


]_2 |^ Enter 


13 


14 


15 


]_5 Enter 



Sum of the matrix is 136 



7.2* (Summing the major diagonal in a matrix) Write a method that sums all the inte- 
gers in the major diagonal in an n X n matrix of integers using the following 
header: 

public static int sumMajorDi agonal (int[] [] m) 

Write a test program that reads a 4-by-4 matrix and displays the sum of all its ele- 
ments on the major diagonal. Here is a sample ran: 



Enter a 4-by- 


4 matrix row by row: 


1 2 3 4 |^ Enter 




5 6 7 8 |^ Enter 




9 10 11 12 


• — ' Enter 


13 14 15 16 


-J Enter 


Sum of the el 


ements in the major diagonal is 34 



7.3* (Sorting students on grades) Rewrite Listing 7.2, GradeExam.java, to display the 
students in increasing order of the number of correct answers. 

7.4** (Computing the weekly hours for each employee) Suppose the weekly hours for all 
employees are stored in a two-dimensional array. Each row records an employee's 
seven-day work hours with seven columns. For example, the array shown below 
stores the work hours for eight employees. Write a program that displays employ- 
ees and their total hours in decreasing order of the total hours. 
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Su 


M 


T 


W 


H 


F 


Sa 


Employee 


2 


4 


3 


4 


5 


8 


8 


Employee 1 


7 


3 


4 


3 


3 


4 


4 


Employee 2 


3 


3 


4 


3 


3 


2 


2 


Employee 3 


9 


3 


4 


7 


3 


4 


1 


Employee 4 


3 


5 


4 


3 


6 


3 


8 


Employee 5 


3 


4 


4 


6 


3 


4 


4 


Employee 6 


3 


7 


4 


8 


3 


8 


4 


Employee 7 


6 


3 


5 


9 


2 


7 


9 



7.5 (Algebra: adding two matrices) Write a method to add two matrices. The header 
of the method is as follows: 

public static double[][] addMatrix(double[] [] a, double[][] b) 

In order to be added, the two matrices must have the same dimensions and the 
same or compatible types of elements. Let c be the resulting matrix. Each element 
Cjj is a t j + bjj . For example, for two 3X3 matrices a and b, c is 

a n a l2 a l3 \ fb n b l2 b l3 \ I a n + b u a u + b u a X3 + b X3 
«2i a 2 2 a 23 \ + \ b 2 \ b 22 b 23 \ = \ a 2 \ + b 2l a 22 + b 22 a 23 + b 23 





f b u b 12 b l3 \ 




1* 


b 2 \ b 22 b 23 


■( 




\b 3X b 32 b 33 ) 





a 3X a 32 a 33 J \b 31 b 32 b 33 J \a 3l + b 3l a 32 + b 32 a 33 + b 33/ 

Write a test program that prompts the user to enter two 3X3 matrices and dis- 
plays their sum. Here is a sample run: 



Enter matrixl: 1 


2 3 4 5 


6 7 8 9 


^ Enter 




Enter matrix2: 


2 4 14. 


5 2.2 1. 


1 4.3 


5 . 2 ^ Enter 


The matrices are 


added as 


follows 






1.0 2.0 3.0 


0.0 2.0 


4.0 


1.0 


4.0 7.0 


4.0 5.0 6.0 + 


1.0 4.5 


2.2 = 


5.0 


9.5 8.2 


7.0 8.0 9.0 


1.1 4.3 


5.2 


8.1 


12.3 14.2 



7.6** (Algebra: multiplying two matrices) Write a method to multiply two matrices. The 
header of the method is as follows: 

public static double[][] multiplyMatrix(double[] [] a, double[][] b) Video Note 

Multiply two matrices 

To multiply matrix a by matrix b, the number of columns in a must be the same as 
the number of rows in b, and the two matrices must have elements of the same or 
compatible types. Let c be the result of the multiplication. Assume the column size 
of matrix a is n. Each element cy is a^ X by + a j2 X b 2 j + ■ ■ ■ + a jn X b„j. 
For example, for two 3X3 matrices a and b, c is 

a n a n a X3 \ (b n b l2 b X3 \ (c n c n c l3 
a 2l a 22 a 23 X b 2l b 22 b 23 = c 2X c 22 c 23 
,a 31 a 32 a 33 J \ b 3l b 32 b 33 J \ c 31 c 32 c 33 , 

where c,j = a a X + a i2 X b 2] + a j3 X by. 

Write a test program that prompts the user to enter two 3X3 matrices and displays 
their product. Here is a sample run: 
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Enter matrixl: 123456789 ^ Enter 
Enter matrix2: 2 4 1 4.5 2.2 1.1 4.3 5.2 
The matrices are multiplied as follows: 
12 3 2.0 4.0 5.3 23.9 24 

4 5 6 * 1 4.5 2.2 = 11.6 56.3 58.2 
7 8 9 1.1 4.3 5.2 17.9 88.7 92.4 



7.7* {Points nearest to each other) Listing 7.3 gives a program that finds two points in 
a two-dimensional space nearest to each other. Revise the program so that it finds 
two points in a three-dimensional space nearest to each other. Use a two-dimen- 
sional array to represent the points. Test the program using the following points: 

double[][] points = {{-1, 0, 3}, {-1, -1, -1}, {4, 1, 1}, 
{2, 0.5, 9}, {3.5, 2, -1}, {3, 1.5, 3}, {-1.5, 4, 2}, 
{5.5, 4, -0.5}}; 

The formula for com puting the distance between two points (x l , yl , zl) and 
(x2, y2, z2) is V(x 2 - .q) 2 + (y 2 - Vi) 2 + (z 2 - Zi) 2 - 
7.8** (All closest pairs of points) Revise Listing 7.3, FindNearestPoints.java, to find 
all closest pairs of points with same minimum distance. 

7.9*** (Game: playing a TicTacToe game) In a game of TicTacToe, two players take 
turns marking an available cell in a 3 X 3 grid with their respective tokens (either 
X or O). When one player has placed three tokens in a horizontal, vertical, or 
diagonal row on the grid, the game is over and that player has won. A draw (no 
winner) occurs when all the cells on the grid have been filled with tokens and nei- 
ther player has achieved a win. Create a program for playing TicTacToe. 

The program prompts two players to enter X token and O token alternately. When- 
ever a token is entered, the program redisplays the board on the console and deter- 
mines the status of the game (win, draw, or continue). Here is a sample run: 



Enter a row (1, 2, or 3) for player X: 1 j-^ 
Enter a column (1, 2, or 3) for player X: 1 



Enter a row (1, 2, or 3) for player 0: 1 |^ Enter 
Enter a column (1, 2, or 3) for player 0: 2 |^ Enter 



X I 
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Enter a row (1, 2, or 3) for player X: 



I X | | | 
| | X | | 

I I I x I 

X player won 



7.10* (Game: TicTacToe board) Write a program that randomly fills in Os and Is into a 
TicTacToe board, prints the board, and finds the rows, columns, or diagonals with 
all Os or Is. Use a two-dimensional array to represent a TicTacToe board. Here is a 
sample run of the program: 

001 
001 
111 

Al 1 Is on row 2 
All Is on column 2 

7.1 I ** (Game: nine heads and tails) Nine coins are placed in a 3-by-3 matrix with some 
face up and some face down. You can represent the state of the coins using a 3-by-3 
matrix with values (head) and 1 (tail). Here are some examples: 

000 101 110 101 100 
010 001 100 110 111 
000 100 001 100 110 

Each state can also be represented using a binary number. For example, the pre- 
ceding matrices correspond to the numbers 

000010000 101001100 110100001 101110100 100111110 

There are a total of 512 possibilities. So, you can use decimal numbers 0, 1, 2, 3, 
. . . , and 511 to represent all states of the matrix. Write a program that prompts the 
user to enter a number between and 511 and displays the corresponding matrix 
with characters H and T. Here is a sample run: 







Enter a number between and 511: 7 
H H H 
H H H 
T T T 


|-J Enter 





The user entered 7, which corresponds to 000000111. Since stands for H and 1 
for T, the output is correct. 

7. 1 2** (Financial application: computing tax) Rewrite Listing 3.6, ComputeTax.java, 
using arrays. For each filing status, there are six tax rates. Each rate is applied to a 
certain amount of taxable income. For example, from the taxable income of 
$400,000 for a single filer, $8,350 is taxed at 10%, (33,950 - 8,350) at 15%, 
(82,250 - 33,950) at 25%, (171,550 - 82,550) at 28%, (372,550 - 82,250) at 33%, 
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and (400,000 - 372,950) at 36%. The six rates are the same for all filing statuses, 
which can be represented in the following array: 

doublet] rates = {0.10, 0.15, 0.25, 0.28, 0.33, 0.35}; 

The brackets for each rate for all the filing statuses can be represented in a two- 
dimensional array as follows: 

int[] [] brackets = { 

{8350, 33950, 82250, 171550, 372950}, // Single filer 
{16700, 67900, 137050, 20885, 372950}, // Married jointly 
{8350, 33950, 68525, 104425, 186475}, // Married separately 
{11950, 45500, 117450, 190200, 372950} // Head of household 

}; 

Suppose the taxable income is $400,000 for single filers. The tax can be computed 
as follows: 

tax = brackets [0] [0] * rates [0] + 

(brackets [0] [1] - brackets [0] [0] ) * rates [1] + 
(brackets [0] [2] - brackets [0] [1] ) * rates[2] + 
(brackets [0] [3] - brackets [0] [2] ) * rates[3] + 
(brackets [0] [4] - brackets [0] [3] ) * rates[4] + 
(400000 - brackets [0] [4]) * rates[5] 

7. 1 3* (Locating the largest element) Write the following method that returns the location 
of the largest element in a two-dimensional array. 

public static int[] locateLargest(double[] [] a) 

The return value is a one-dimensional array that contains two elements. These two 
elements indicate the row and column indices of the largest element in the two- 
dimensional array. Write a test program that prompts the user to enter a two-dimen- 
sional array and displays the location of the largest element in the array. Here is a 
sample run: 



Enter the number of rows and columns of the array: 3 



Enter the array: 



23.5 35 2 10 


«-J Enter 


4.5 3 45 3.5 


|^^nter"j 


35 44 5.5 9.6 


■-i Enter 



The location of the largest element is at (1, 2) 



7. 1 4** (Exploring matrix) Write a program that prompts the user to enter the length of a square 
matrix, randomly fills in 0s and Is into the matrix, prints the matrix, and finds the rows, 
columns, and diagonals with all 0s or Is. Here is a sample run of the program: 



Enter the size for 


the matrix: 4 Renter 


0111 




0000 




0100 




1111 




Al 1 0s on row 1 




Al 1 Is on row 3 




No same numbers on 


a column 


No same numbers on 


the major diagonal 


No same numbers on 


the sub-diagonal 
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7. 1 5* (Geometry: same line?) Suppose a set of points are given. Write a program to 
check whether all the points are on the same line. Use the following sets to test 
your program: 

double[][] setl = {{1, 1}, {2, 2}, {3, 3}, {4, 4}}; 
double[][] set2 = {{0, 1}, {1, 2}, {4, 5}, {5, 6}}; 
double[][] set3 = {{0, 1}, {1, 2}, {4, 5}, {4.5, 4}}; 

7.16* (Sorting two-dimensional array) Write a method to sort a two-dimensional 
array using following header: 

public static void sort(int m[][]) 

The method performs a primary sort on rows and a secondary sort on columns. 
For example, the array {{4, 2}, {1, 7}, {4, 5}, {1, 2}, {1, 1}, {4, 1}} will be 
sorted to {{1, 1}, {1, 2}, {1, 7}, {4, 1}, {4, 2}, {4, 5}}. 

7.1 7*** (Financial tsunami) Banks lend money to each other. In tough economic times, 
if a bank goes bankrupt, it may not be able to pay back the loan. A bank's total 
assets are its current balance plus its loans to other banks. Figure 7.8 is a dia- 
gram that shows five banks. The banks' current balances are 25, 125, 175, 75, 
and 181 million dollars, respectively. The directed edge from node 1 to node 2 
indicates that bank 1 lends 40 million dollars to bank 2. 



125 




Figure 7.8 Banks lend money to each other. 

If a bank's total assets are under a certain limit, the bank is unsafe. The money it 
borrowed cannot be returned to the lender, and the lender cannot count the loan in 
its total assets. Consequently, the lender may also be unsafe, if its total assets are 
under the limit. Write a program to find all unsafe banks. Your program reads the 
input as follows. It first reads two integers n and limit, where n indicates the 
number of banks and 1 i mi t is the minimum total assets for keeping a bank safe. It 
then reads n lines that describe the information for n banks with id from to n-1. 
The first number in the line is the bank's balance, the second number indicates the 
number of banks that borrowed money from the bank, and the rest are pairs of two 
numbers. Each pair describes a borrower. The first number in the pair is the bor- 
rower's id and the second is the amount borrowed. For example, the input for the 
five banks in Figure 7.8 is as follows (note that the limit is 201): 

5 201 

25 2 1 100.5 4 320.5 
125 2 2 40 3 85 
175 2 125 3 75 
75 1 125 
181 1 2 125 
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The total assets of bank 3 are (75 + 125), which is under 201. So bank 3 is 
unsafe. After bank 3 becomes unsafe, the total assets of bank 1 fall below (125 + 
40). So, bank 1 is also unsafe. The output of the program should be 

Unsafe banks are 3 1 

(Hint: Use a two-dimensional array borrowers to represent loans, 
borrowers [i] [j] indicates the loan that bank i loans to bank j. Once bank j 
becomes unsafe, borrowers [i] [j] should be set to 0.) 

7. 1 8* (Shuffling rows) Write a method that shuffles the rows in a two-dimensional i nt 
array using the following header: 

public static void shuffle(int[] [] m) 

Write a test program that shuffles the following matrix: 



int[][] m = {{1, 2}, {3, 4}, {5, 6}, {7, 8}, {9, 10}}; 

7.19** (Pattern recognition: consecutive four equal numbers) Write the following 
method that tests whether a two-dimensional array has four consecutive num- 
bers of the same value, either horizontally, vertically, or diagonally. 

public static boolean isConsecutiveFour(int[] [] values) 

Write a test program that prompts the user to enter the number of rows and 
columns of a two-dimensional array and then the values in the array and dis- 
plays true if the array contains four consecutive numbers with the same value. 
Otherwise, display false. Here are some examples of the true cases: 






1 





3 


1 


6 


1 







1 





3 


1 


6 


1 







1 





3 


1 


6 


1 







1 





3 


1 


6 


1 





1 


6 


8 


6 





1 







1 


6 


8 


6 





1 







1 


6 


8 


6 





1 







1 


6 


8 


6 





1 




6 


2 


1 


8 


2 


9 




5 


5 


2 


1 


8 


2 


9 




5 


6 


2 


1 


6 


2 


9 




9 


6 


2 


1 


8 


2 


9 


6 


5 


6 


1 


1 


9 


1 




6 


5 


6 


1 


1 


9 


1 




6 


5 


6 


6 


1 


9 


1 




6 


9 


6 


1 


1 


9 


1 


1 


3 


6 


1 


4 





7 




1 


5 


6 


1 


4 





7 




1 


3 


6 


1 


4 





7 




1 


3 


9 


1 


4 





7 


3 


3 


3 


3 


4 





7 




3 


5 


3 


3 


4 





7 




3 


6 


3 


3 


4 





7 




3 


3 


3 


9 


4 





7 



7.20*** (Game: connect four) Connect four is a two-player board game in which the 
players alternately drop colored disks into a seven-column, six-row vertically- 
suspended grid, as shown below. 
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The objective of the game is to connect four same-colored disks in a row, a col- 
umn, or a diagonal before your opponent can do likewise. The program prompts 
two players to drop a RED or YELLOW disk alternately. Whenever a disk is 
dropped, the program redisplays the board on the console and determines the 
status of the game (win, draw, or continue). Here is a sample run: 



Drop a red disk at column (0-6): |^ Er "* r 



Drop a yellow disk at column (0-6): 3 | ^ Enter 



IRI I IYI 



Drop a yellow disk at column (0-6): 6 jEnter 



I R I Y 





R 










Y 


R 


Y 




R 


Y 


Y 


Y 


Y 


R 


Y 


R 


R 


R 



The yellow player won 



7.2 I *** (Game: multiple Sudoku solutions) The complete solution for the Sudoku prob- 
lem is given in Supplement VILA. A Sudoku problem may have multiple solu- 
tions. Modify Sudoku.java in Supplement VILA to display the total number of 
the solutions. Display two solutions if multiple solutions exist. 

7.22* (Algebra: 2X2 matrix inverse) The inverse of a square matrix A is denoted A" 1 , 
such that AxA" 1 = I, where I is the identity matrix with all l's on the diagonal 

"l 2 

and on all other cells. For example, the inverse of matrix 

"-0.5 r 



1.5 



3 4 



i.e.. 



1 2 


X 


-0.5 1 




1 





3 4 




1.5 







1 
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The inverse of a 2 X 2 matrix A can be obtained using the following formula: 

d -b 
— c a 

Implement the following method to obtain an inverse of the matrix: 
public static double[][] inverse(double[] [] A) 
The method returns nul 1 if ad - be is 0. 

Write a test program that prompts the user to enter a, b, c, d for a matrix and dis- 
plays its inverse matrix. Here is a sample ran: 



a b 
c d 



1 



ad — be 



Enter a, b, c, d: 12 3 4 " 
-2.0 1.0 
1.5 -0.5 



Enter a, b, c, d: 0.5 2 1.5 4.5 
-6.0 2.6666666666666665 
2.0 -0.6666666666666666 



7.23* (Algebra: 3X3 matrix inverse) The inverse of a square matrix A is denoted A 1 , 
such that AxA" 1 = I, where I is the identity matrix with all l's on the diagonal 

~1 2 1~ 

and on all other cells. The inverse of matrix 



for example, is 



-2 0.5 0.5 

1 0.5 -0.5 

_ 1 -1.5 0.5 

— that is, 



1 


2 


1 




-2 0.5 


0.5 




1 








2 


3 


1 


X 


1 0.5 


-0.5 







1 





4 


5 


3 




1 -1.5 


0.5 










1 



The inverse of a 3 X 3 matrix 



a u a\2 «13 

a 21 a 22 a 23 
a 31 a 32 a 33. 
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can be obtained using the following formula if \A\ 0: 



A" 



J_ 
\A\ 



«22«33 
023 a 31 
L fl 21 a 32 



fl 23 fl 32 fl 13 fl 32 
fl 21 fl 33 a ll#33 
a 22 a 3l a l2 a 3l 



a l2 a 33 fl 12 fl 23 ~~ fl 13 fl 22 
fl 13 a 31 a 13 fl 21 — a U a 23 
#11^32 ^11^22 #12^21 



"11 "12 
fl 21 fl 22 
«31 «32 



«13 

"23 
«33 



fl ll fl 22 fl 33 + fl 31 fl 12 fl 23 + a 13 a 21 fl 32 



fl 13 fl 22 a 31 ~~ a ll fl 23 fl 32 ~~ «33 a 21 a 12- 



Implement the following function to obtain an inverse of the matrix: 
public static double[][] inverse(double[] [] A) 
The method returns null if |A| is 0. 

Write a test program that prompts the user to enter an, avi, «13> fl 2i> a 22> #23 > 
«3i , fl32 , «33 for a matrix and displays its inverse matrix. Here is a sample run: 



Enter all, al2 , 


al3, a21, a22, a23, a31, a32, a33: 


12 12 3 14 


53 j Enter 


-2 0.5 0.5 




1 0.5 -0.5 




1 -1.5 0.5 





Enter all, al2 , al3, a21, a22, a23, a31, a32, a33: 

142258218 f^] 
2.0 -1.875 1.375 
0.0 0.25 -0.25 
-0.5 0.4375 -0.1875 
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Chapter 



Objects and Classes 



Objectives 



To describe objects and classes, and use classes to model objects (§8.2). 

To use UML graphical notations to describe classes and objects (§8.2). 

To demonstrate defining classes and creating objects (§8.3). 

To create objects using constructors (§8.4). 

To access objects via object reference variables (§8.5). 

To define a reference variable using a reference type (§8.5.1). 

To access an object's data and methods using the 
object member access operator ( , ) (§8.5.2). 

To define data fields of reference types and assign 
default values for an object's data fields (§8.5.3). 

To distinguish between object reference variables 
and primitive data type variables (§8.5.4). 



To use classes Date, Random, and J Frame in 
the Java library (§8.6). 

To distinguish between instance and static variables 
and methods (§8.7). 

To define private data fields with appropriate get 
and set methods (§8.8). 

To encapsulate data fields to make classes easy 
to maintain (§8.9). 

To develop methods with object arguments and 
differentiate between primitive-type arguments 
and object-type arguments (§8.10). 

To store and process objects in arrays (§8.1 1). 
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why OOP? 



8.1 Introduction 

Having learned the material in earlier chapters, you are able to solve many programming prob- 
lems using selections, loops, methods, and arrays. However, these Java features are not suffi- 
cient for developing graphical user interfaces and large-scale software systems. Suppose you 
want to develop a GUI (graphical user interface, pronounced goo-ee) as shown in Figure 8.1. 
How do you program it? 



Button 



Label 



Text Field Check Box 



Radio Button 



Combo Box 















1 






bhow GUT Components 










I 




tyni 1 t , — i : j 

OK Cancel Enter your name: Type Name Here| [ 


]Bold □ Italic C 


S Red O Yellow Frestiman 













Figure 8.1 The GUI objects are created from classes. 

This chapter begins the introduction of object-oriented programming, which will enable 
you to develop GUI and large-scale software systems effectively. 



8.2 Defining Classes for Objects 



object 



state 



behavior 



instantiation 

object 

instance 



Object-oriented programming (OOP) involves programming using objects. An object repre- 
sents an entity in the real world that can be distinctly identified. For example, a student, a 
desk, a circle, a button, and even a loan can all be viewed as objects. An object has a unique 
identity, state, and behavior. 

■ The state of an object (also known as its properties or attributes) is represented by 
data fields with their current values. A circle object, for example, has a data field 
radius, which is the property that characterizes a circle. A rectangle object has data 
fields width and height, which are the properties that characterize a rectangle. 

■ The behavior of an object (also known as its actions) is defined by methods. To 
invoke a method on an object is to ask the object to perform an action. For example, 
you may define a method named getAreaO for circle objects. A circle object may 
invoke getAreaO to return its area. 

Objects of the same type are defined using a common class. A class is a template, blueprint, 
or contract that defines what an object's data fields and methods will be. An object is an 
instance of a class. You can create many instances of a class. Creating an instance is referred 
to as instantiation. The terms object and instance are often interchangeable. The relationship 
between classes and objects is analogous to that between an apple-pie recipe and apple pies. 
You can make as many apple pies as you want from a single recipe. Figure 8.2 shows a class 
named Ci rcl e and its three objects. 



Class Name: Circle 

Data Fields: 
radius is 



Methods: 
getArea 



A class template 



Circle Object 1 

Data Fields: 
radius is 10 



Circle Object 2 

Data Fields: 
radius is 2 5 



Circle Object 3 

Data Fields: 
radius is 12 5 



Three objects of 
the Circle class 



Figure 8.2 A class is a template for creating objects. 
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A Java class uses variables to define data fields and methods to define actions. Addition- class 

ally, a class provides methods of a special type, known as constructors, which are invoked to data field 

create a new object. A constructor can perform any action, but constructors are designed to method 

perform initializing actions, such as initializing the data fields of objects. Figure 8.3 shows an constructor 
example of defining the class for circle objects. 



class Circle { 

/** The radius of this circle */ 
double radius = 1.0; 



/** Construct a circle object */- 

CircleO { 

} 

/** Construct a circle object */ 
Ci rcle (double newRadius) { 
radius = newRadius; 

} 



/** Return the area of this circle */ 
double getArea() { -< 

return radius * radius * Math. PI; 

} 



Data field 



Constructors 



Method 



Figure 8.3 A class is a construct that defines objects of the same type. 



The Ci rcl e class is different from all of the other classes you have seen thus far. It does 
not have a main method and therefore cannot be run; it is merely a definition for circle 
objects. The class that contains the main method will be referred to in this book, for conve- 
nience, as the main class. main class 

The illustration of class templates and objects in Figure 8.2 can be standardized using UML 
(Unified Modeling Language) notations. This notation, as shown in Figure 8.4, is called a UML 
class diagram, or simply a class diagram. In the class diagram, the data field is denoted as class diagram 

dataFi el dName : dataFi el dType 



UML Class Diagram 



Circle 



radius: double 



Ci rcle() 

Ci rcle(newRadius: double) 
getAreaQ : doubl e 



circlel: Circle 



radius = 10 



circle2: Circle 



radius = 25 



circle3: Circle 



radius = 1 25 



Class name 

Data fields 

Constructors and 
methods 



UML notation 
for objects 



Figure 8.4 Classes and objects can be represented using UML notations. 



The constructor is denoted as 

CI assName (parameterName : parameterType) 
The method is denoted as 

methodNameCparameterName: parameterType): returnType 
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8.3 Example: Defining Classes and Creating Objects 

This section gives two examples of defining classes and uses the classes to create objects. 
Listing 8.1 is a program that defines the Ci rcl e class and uses it to create objects. To avoid a 
naming conflict with several improved versions of the Ci rcl e class introduced later in this 
book, the Ci rcl e class in this example is named Ci rcl el. 

The program constructs three circle objects with radius 1.0, 25, and 125 and displays the 
radius and area of each of the three circles. Change the radius of the second object to 100 and 
display its new radius and area. 



Listing 8.1 TestCi rcl el. java 



main class 
main method 
create object 

create object 

create object 



class Circlel 
data field 



no-arg constructor 



second constructor 



method 



public class TestCi rclel { 

/** Main method */ 

public static void main(String[] args) { 

// Create a circle with radius 1.0 
Circlel circlel = new CirclelO; 

System . out . pri ntl n("The area of the circle of radius 



+ ci rclel. radius + " is 



ci rclel. getArea() ); 



1 
2 
3 
4 
5 
6 
7 
8 
9 
10 
11 
12 
13 
14 
15 
16 
17 
18 
19 
20 
21 
22 
23 
24 
25 

26 // Define the circle class with two constructors 

27 cl ass Ci rcl el { 



// Create a circle with radius 25 
Circlel circle2 = new Circlel(25); 

System . out . pri ntl n("The area of the circle of radius 
+ ci rcl e2 . radi us + " is " + ci rcl e2 . getAreaO) ; 

// Create a circle with radius 12 5 
Circlel circle3 = new Ci rcl el(125) ; 
System . out . pri ntl n("The area of the circle of radius 
+ ci rcl e3 . radi us + " is " + ci rcl e3 . getAreaO) ; 

// Modify circle radius 
ci rcl e2 . radius = 100; 

System. out. println("The area of the circle of radius 
+ ci rcl e2 . radi us + " is " + ci rcl e2 . getAreaO ); 



} 



28 
29 
30 
31 
32 
33 
34 
35 
36 
37 
38 
39 
40 
41 
42 
43 
44 



double radius 

/** Construct 
CirclelO { 
radius = 1 

} 



a circle with radius 1 */ 



; 



/** Construct a circle with a specified radius */ 
Ci rclel(double newRadius) { 
radius = newRadius; 

} 

/** Return the area of this circle */ 
double getAreaO { 

return radius * radius * Math. PI; 

} 
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The 


area 


of 


the 


ci rcl e 


of 


radi us 


1.0 is 3.141592653589793 


The 


area 


of 


the 


ci rcl e 


of 


radi us 


25.0 is 1963.4954084936207 


The 


area 


of 


the 


ci rcle 


of 


radi us 


125.0 is 49087.385212340516 


The 


area 


of 


the 


ci rcl e 


of 


radi us 


100.0 is 31415.926535897932 



The program contains two classes. The first of these, TestCi rcl el, is the main class. Its sole 
purpose is to test the second class, Circlel. Such a program that uses the class is often 
referred to as a client of the class. When you run the program, the Java runtime system 
invokes the man n method in the main class. 

You can put the two classes into one file, but only one class in the file can be a public class. 
Furthermore, the public class must have the same name as the file name. Therefore, the file 
name is TestCirclel.java, since TestCi rcl el is public. 

The main class contains the man n method (line 3) that creates three objects. As in creating 
an array, the new operator is used to create an object from the constructor, new Ci rcl el() 
creates an object with radius 1 . (line 5), new Ci rcl el (2 5) creates an object with radius 25 
(line 10), and new Circlel (12 5) creates an object with radius 125 (line 15). 

These three objects (referenced by ci rcl el, ci rcl e2, and ci rcl e3) have different data but 
the same methods. Therefore, you can compute their respective areas by using the get Area O 
method. The data fields can be accessed via the reference of the object using ci rcl el . radi us, 
ci rcl e2 . radi us, and ci rcl e3 . radi us, respectively. The object can invoke its method via 
the reference of the object using circlel.getAreaO, circle2.getArea(), and 
ci rcl e3 . getAreaO, respectively. 

These three objects are independent. The radius of ci rcl e2 is changed to 100 in line 20. 
The object's new radius and area is displayed in lines 21-22. 

There are many ways to write Java programs. For instance, you can combine the two 
classes in the example into one, as shown in Listing 8.2. 



client 



public class 



Listing 8.2 Ci rclel. java 



i 

2 
3 
4 
5 
6 
7 
8 
9 
10 
11 
12 
13 
14 
15 
16 
17 
18 
19 
20 
21 
22 
23 
24 



public class Circlel { 

/** Main method */ 

public static void main(String[] args) { 

// Create a circle with radius 1.0 
Circlel circlel = new CirclelO; 
System. out. println("The area of the ci 



+ ci rclel. radius + " is 



rcle of radius 
circlel.getAreaO ); 



// Create a circle with radius 25 
Circlel circle2 = new Circlel(25); 
System. out. println("The area of the ci 
+ ci rcl e2 . radi us + " is " + circle2. 

// Create a circle with radius 12 5 
Circlel circle3 = new Ci rcl el(125) ; 
System. out. println("The area of the ci 
+ ci rcl e3 . radi us + " is " + circle3. 

// Modify circle radius 
ci rcl e2 . radius = 100; 
System. out. println("The area of the ci 
+ ci rcl e2 . radi us + " is " + circle2. 



rcle of radius 

getAreaO) ; 



rcle of radius 

getAreaO) ; 



rcle of radius 

getAreaO) ; 



main method 
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data field 



no-arg constructor 



second constructor 



method 



25 
26 
27 
28 
29 
30 
31 
32 
33 
34 
35 
36 
37 
38 
39 
40 

41 } 



double radius; 

/** Construct a circle with radius 1 */ 
CirclelO { 
radius = 1.0; 

} 

/** Construct a circle with a specified radius */ 
Ci rclel(double newRadius) { 
radius = newRadius; 

} 

/** Return the area of this circle */ 
double getAreaO { 

return radius * radius * Math. PI; 

} 



Since the combined class has a main method, it can be executed by the Java interpreter. The 
main method is the same as in Listing 1.1. This demonstrates that you can test a class by sim- 
ply adding a man n method in the same class. 

As another example, consider TV sets. Each TV is an object with states (current channel, 
current volume level, power on or off) and behaviors (change channels, adjust volume, turn 
on/off). You can use a class to model TV sets. The UML diagram for the class is shown in 
Figure 8.5. 

Listing 8.3 gives a program that defines the TV class. 



TV 



channel : i nt 
vol umeLevel : i nt 
on: boolean 



+TVO 

+turnOn(): void 
+turnOff(): void 

+setChannel (newChannel : int): void 
+setVol ume(newVol umeLevel : int): void 
+channelUp(): void 
+channelDown() : void 
+vol umellpO : void 
+volumeDown() : void 



The current channel (1 to 120) of this TV. 
The current volume level (1 to 7) of this TV. 
Indicates whether this TV is on/off. 

Constructs a default TV object. 
Turns on this TV. 
Turns off this TV. 
Sets a new channel for this TV. 
Sets a new volume level for this TV. 
Increases the channel number by 1. 
Decreases the channel number by 1. 
Increases the volume level by 1. 
Decreases the volume level by 1. 



Figure 8.5 The TV class models TV sets. 



Listing 8.3 TV.java 

1 public class TV { 

data fields 2 int channel =1; // Default channel is 1 

3 int vol umeLevel =1; // Default volume level is 

4 boolean on = false; // By default TV is off 
5 

constructor 6 public TV() { 

7 } 
8 
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9 public void turnOnO { turn on TV 

10 on = true; 

11 } 
12 

13 public void turnOffO { turn off TV 

14 on = false; 

15 } 
16 

17 public void setChannel (int newChannel) { set a new channel 

18 if (on && newChannel >= 1 && newChannel <= 120) 

19 channel = newChannel ; 

20 } 
21 

22 public void setVol ume(int newVol umeLevel ) { set a new volume 

23 if (on && newVol umeLevel >= 1 && newVol umeLevel <= 7) 

24 vol umeLevel = newVol umeLevel ; 

25 } 
26 

27 public void channel Up() { increase channel 

28 if (on && channel < 120) 

29 channel++; 

30 } 
31 

32 public void channelDown() { decrease channel 

33 if (on && channel > 1) 

34 channel--; 

35 } 
36 

37 public void VolumeUpO { increase volume 

38 if (on && vol umeLevel < 7) 

39 vol umeLevel ++; 

40 } 
41 

42 public void volumeDown() { decrease volume 

43 if (on && vol umeLevel > 1) 

44 vol umeLevel -- ; 

45 } 



46 } 

Note that the channel and volume level are not changed if the TV is not on. Before either of 
these is changed, its current value is checked to ensure that it is within the correct range. 
Listing 8.4 gives a program that uses the TV class to create two objects. 

Listing 8.4 TestTV.java 

1 public class TestTV { 

2 public static void main(String[] args) { 

3 TV tvl = new TV() ; 

4 tvl.turnOnO; 

5 tvl. setChannel (30) ; 

6 tvl. setVol ume (3) ; 
7 

8 TV tv2 = new TV() ; 

9 tv2.turn0n() ; 

10 tv2. channel Up(); 

11 tv2.channelUp() ; 

12 tv2 .volumeUpO ; 
13 

14 System. out. println("tvl's channel is " + tvl. channel 

15 + " and volume level is " + tvl. vol umeLevel ); 



main method 
create a TV 
turn on 

set a new channel 
set a new volume 

create a TV 
turn on 

increase channel 
increase volume 
display state 
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16 
17 
18 

19 } 



System. out. pri ntl n("tv2 ' s channel is " + tv2. channel 
+ " and volume level is " + tv2 .volumeLevel) ; 



} 



constructor's name 
no return type 
new operator 

overloaded constructors 
no voi d 

constructing objects 



no-arg constructor 
default constructor 



tvl's channel is 30 and volume level is 3 
tv2's channel is 3 and volume level is 2 



The program creates two objects in lines 3 and 8 and invokes the methods on the objects to 
perform actions for setting channels and volume levels and for increasing channels and vol- 
umes. The program displays the state of the objects in lines 14-17. The methods are invoked 
using a syntax such as tvl.turnOnO (line 4). The data fields are accessed using a syntax 
such as tvl . channel (line 14). 

These examples have given you a glimpse of classes and objects. You may have many 
questions regarding constructors, objects, reference variables, and accessing data fields, and 
invoking object's methods. The sections that follow discuss these issues in detail. 



Constructors are a special kind of method. They have three peculiarities: 

■ A constructor must have the same name as the class itself. 

■ Constructors do not have a return type — not even voi d. 

■ Constructors are invoked using the new operator when an object is created. Con- 
structors play the role of initializing objects. 

The constructor has exactly the same name as the defining class. Like regular methods, con- 
structors can be overloaded (i.e., multiple constructors can have the same name but different 
signatures), making it easy to construct objects with different initial data values. 

It is a common mistake to put the voi d keyword in front of a constructor. For example, 

public void CircleO { 
} 

In this case, Ci rcl e() is a method, not a constructor. 

Constructors are used to construct objects. To construct an object from a class, invoke a 
constructor of the class using the new operator, as follows: 

new ClassName(arguments) ; 

For example, new Ci rcl e() creates an object of the Ci rcl e class using the first construc- 
tor defined in the Circle class, and new Circle(25) creates an object using the second 
constructor defined in the Ci rcl e class. 

A class normally provides a constructor without arguments (e.g., Ci rcl e()). Such a con- 
structor is referred to as a no-arg or no-argument constructor. 

A class may be defined without constructors. In this case, a no-arg constructor with an 
empty body is implicitly defined in the class. This constructor, called a default constructor, is 
provided automatically only if no constructors are explicitly defined in the class. 



8.4 Constructing Objects Using Constructors 



8.5 Accessing Objects via Reference Variables 

Newly created objects are allocated in the memory. They can be accessed via reference 
variables. 
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8.5.1 Reference Variables and Reference Types 

Objects are accessed via object reference variables, which contain references to the objects, reference variable 
Such variables are declared using the following syntax: 

ClassName objectRefVar ; 

A class is essentially a programmer-defined type. A class is a reference type, which means reference type 
that a variable of the class type can reference an instance of the class. The following statement 
declares the variable myCi rcl e to be of the Ci rcl e type: 

Ci rcle myCi rcle; 

The variable myCi rcl e can reference a Ci rcl e object. The next statement creates an object 
and assigns its reference to myCi rcl e: 

myCircle = new CircleO; 

Using the syntax shown below, you can write a single statement that combines the declaration 
of an object reference variable, the creation of an object, and the assigning of an object refer- 
ence to the variable. 

ClassName objectRefVar = new ClassNameO; 
Here is an example: 

Circle myCircle = new CircleO; 
The variable myCi rcl e holds a reference to a Ci rcl e object. 

§ Note 

An object reference variable that appears to hold an object actually contains a reference to that object vs. object reference 

object. Strictly speaking, an object reference variable and an object are different, but most of the variable 
time the distinction can be ignored. So it is fine, for simplicity, to say that myCircle is a 
Circle object rather than use the longer-winded description that myCircle is a variable that 
contains a reference to a Ci rcl e object. 

^0 Note 

Arrays are treated as objects in Java. Arrays are created using the new operator. An array variable array object 

is actually a variable that contains a reference to an array 

8.5.2 Accessing an Object's Data and Methods 

After an object is created, its data can be accessed and its methods invoked using the dot oper- 
ator ( . ), also known as the object member access operator. dot operator 

■ objectRefVar . dataFiel d references a data field in the object. 

■ objectRefVar . method (arguments) invokes a method on the object. 

For example, myCircle. radius references the radius in myCircle, and 
myCircle.getAreaO invokes the getArea method on myCircle. Methods are invoked 
as operations on objects. 

The data field radius is referred to as an instance variable, because it is dependent on a instance variable 
specific instance. For the same reason, the method getArea is referred to as an instance instance method 
method, because you can invoke it only on a specific instance. The object on which an 
instance method is invoked is called a calling object. calling object 



272 Chapter 8 Objects and Classes 



|p Caution 

Recall that you use Math . methodName (arguments) (e.g.. Math .pow(3 , 2. 5)) to invoke a 
invoking methods method in the Math class. Can you invoke getArea() using Circle. getAreaO? The answer 

is no. All the methods in the Math class are static methods, which are defined using the static 
keyword. However, getAreaO is an instance method, and thus nonstatic. It must be invoked from 
an object using objectRefVar.methodName(arguments) (e.g., myCircle. getAreaO). 
Further explanation is given in §8.7, "Static Variables, Constants, and Methods." 




Usually you create an object and assign it to a variable. Later you can use the variable to reference 
the object. Occasionally an object does not need to be referenced later. In this case, you can cre- 
ate an object without explicitly assigning it to a variable, as shown below: 

new Ci rcleQ ; 



or 



System. out. pri ntl n("Area is " + new Ci rcl e(5) . getAreaO) ; 



The former statement creates a Ci rcl e object. The latter creates a Ci rcl e object and invokes 
anonymous object its getArea method to return its area. An object created in this way is known as an anonymous 

object. 



8.5.3 Reference Data Fields and the null Value 

reference data fields The data fields can be of reference types. For example, the following Student class contains 

a data field name of the Stri ng type. Stri ng is a predefined Java class. 

class Student { 

String name; // name has default value null 
int age; // age has default value 

boolean i sSci enceMajor ; // i sSci enceMajor has default value false 
char gender; // c has default value '\u0000' 



If a data field of a reference type does not reference any object, the data field holds a special 
null value Java value, null, null is a literal just like true and false. While true and false are 

Boolean literals, nul 1 is a literal for a reference type, 
default field values The default value of a data field is nul 1 for a reference type, for a numeric type, f al se 

for a bool ean type, and ' \u0000 ' for a char type. However, Java assigns no default value 
to a local variable inside a method. The following code displays the default values of data 
fields name, age, isScienceMajor, and gender for a Student object: 

class Test { 

public static void main(String[] args) { 
Student student = new StudentO; 
System . out . pri ntl n("name? " + student . name) ; 
System . out . pri ntl n("age? " + student . age ) ; 

System. out. println("isScienceMajor? " + student . i sSci enceMajor ) ; 
System . out . pri ntl n("gender? " + student . gender) ; 

} 

} 



The code below has a compile error, because local variables x and y are not initialized: 



class Test { 

public static void main(String[] args) { 
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int x; // x has no default value 
String y; // y has no default value 
System . out . pri ntl n("x is " + x); 
System. out. println("y is " + y); 

} 

} 




Caution 



NuHPointerException is a common runtime error. It occurs when you invoke a method on NullPointerException 

a reference variable with null value. Make sure you assign an object reference to the variable 
before invoking the method through the reference variable. 

8.5.4 Differences Between Variables of Primitive Types 
and Reference Types 

Every variable represents a memory location that holds a value. When you declare a variable, 
you are telling the compiler what type of value the variable can hold. For a variable of a prim- 
itive type, the value is of the primitive type. For a variable of a reference type, the value is a 
reference to where an object is located. For example, as shown in Figure 8.6, the value of i nt 
variable i is int value 1, and the value of Circle object c holds a reference to where the 
contents of the Ci rcl e object are stored in the memory. 



Created using new Ci rcl e () 

Primitive type i nt 1 = 1 i 1 



Object type Circle c c reference [ ■*• c: Circle 



radius = 1 



Figure 8.6 A variable of a primitive type holds a value of the primitive type, and a variable 
of a reference type holds a reference to where an object is stored in memory. 



When you assign one variable to another, the other variable is set to the same value. For a 
variable of a primitive type, the real value of one variable is assigned to the other variable. For 
a variable of a reference type, the reference of one variable is assigned to the other variable. 
As shown in Figure 8.7, the assignment statement i = j copies the contents of j into i for 
primitive variables. As shown in Figure 8.8, the assignment statement cl = c2 copies the 
reference of c2 into cl for reference variables. After the assignment, variables cl and c2 
refer to the same object. 



Primitive type assignment i = j 
Before: After: 




Figure 8.7 Primitive variable j is copied to variable i. 
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Object type assignment cl = c2 
Before: After: 
cl — I 1 cl 



c2 



c2: Circle 

radius = 9 



cl: Circle 



radius = 5 



c2 



X 



c2: Circle 



radius = 9 



cl: Circle 



radius = 5 



Figure 8.8 Reference variable c2 is copied to variable cl. 



garbage collection 



|g| Note 

As shown in Figure 8.8, after the assignment statement cl = c2, cl points to the same object 
referenced by c2. The object previously referenced by cl is no longer useful and therefore is now 
known as garbage. Garbage occupies memory space. The Java runtime system detects garbage 
and automatically reclaims the space it occupies. This process is called garbage collection. 



Tip 

If you know that an object is no longer needed, you can explicitly assign nul 1 to a reference vari- 
able for the object. The JVM will automatically collect the space if the object is not referenced by 
any reference variable. 



8.6 Using Classes from the Java Library 

Listing 8.1 defined the Circlel class and created objects from the class. You will frequently 
use the classes in the Java library to develop programs. This section gives some examples of 
the classes in the Java library. 

8.6.1 The Date Class 

In Listing 2.8, ShowCurrenfTime.java, you learned how to obtain the current time using 
System. currentTimeMill is(). You used the division and remainder operators to extract 
current second, minute, and hour. Java provides a system-independent encapsulation of date 
java.util .Date class and time in the java. util .Date class, as shown in Figure 8.9. 



java.util.Date 



The + sign indicates 
public modifier — 



+Date() 

+Date(elapseTime: long) 

+toString(): String 
+getTime(): long 

+setTime(elapseTime: long): void 



Constructs a Date object for the current time. 
Constructs a Date object for a given time in 

milliseconds elapsed since January f , 1970, GMT. 
Returns a string representing the date and time. 
Returns the number of milliseconds since January 1, 

1970, GMT. 
Sets a new elapse time in the object. 



Figure 8.9 A Date object represents a specific date and time. 



You can use the no-arg constructor in the Date class to create an instance for the current date 
and time, its getTimeO method to return the elapsed time since January 1, 1970, GMT, and its 
toString method to return the date and time as a string. For example, the following code 
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java.util .Date date = new java.util .Date() ; 

System. out. println ("The elapsed time since Jan 1, 1970 is 

date.getTimeO + " milliseconds"); 
System. out. print~ln(date.toStringO ) ; 



create object 

get elapsed time 
invoke toString 



displays the output like this: 

The elapsed time since Jan 1, 1970 is 1100547210284 milliseconds 
Mon Nov 15 14:33:30 EST 2004 



The Date class has another constructor, Date(long el apseTime), which can be used to 
construct a Date object for a given time in milliseconds elapsed since January 1, 1970, GMT. 



8.6.2 The Random Class 

You have used Math . random () to obtain a random double value between 0.0 and 1.0 
(excluding 1 . 0). Another way to generate random numbers is to use the java. util . Random 
class, as shown in Figure 8.10, which can generate a random int, long, double, float, and 
bool ean value. 



_ 



java.util.Random 



+Random() 

+Random(seed : long) 
+nextlnt(): int 
+nextlnt(n: int): int 
+nextl_ong(): long 
+nextDouble() : double 
+nextFloat() : float 
+nextBool ean () : bool ean 



Constructs a Random object with the current time as its seed. 
Constructs a Random object with a specified seed. 
Returns a random i nt value. 

Returns a random int value between and n (exclusive). 
Returns a random 1 ong value. 

Returns a random doubl e value between . and 1 . (exclusive). 
Returns a random f 1 oat value between . OF and 1 . OF (exclusive). 
Returns a random bool ean value. 



Figure 8.1 A Random object can be used to generate random values. 



When you create a Random object, you have to specify a seed or use the default seed. The 
no-arg constructor creates a Random object using the current elapsed time as its seed. If two 
Random objects have the same seed, they will generate identical sequences of numbers. For 
example, the following code creates two Random objects with the same seed, 3. 

Random randoml = new Random(3) ; 
System . out . pri nt("From randoml: ") ; 
for (int i = 0; i < 10; i++) 

System. out. pri nt(randoml. nextlnt(1000) + " ") ; 

Random random2 = new Random(3) ; 
System . out . pri nt("\nFrom random2: ") ; 
for (int i = 0; i < 10; i++) 

System. out . pri nt(random2 . nextlnt(1000) + " ") ; 

The code generates the same sequence of random int values: 

From randoml: 734 660 210 581 128 202 549 564 459 961 
From random2: 734 660 210 581 128 202 549 564 459 961 

§ Note 

The ability to generate the same sequence of random values is useful in software testing and same sequence 

many other applications. In software testing, you can test your program using a fixed sequence of 
numbers before using different sequences of random numbers. 
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8.6.3 Displaying GUI Components 
fBl Pedagogical Note 

Graphical user interface (GUI) components are good examples for teaching OOP. Simple GUI 
examples are introduced for this purpose. The full introduction to GUI programming begins with 
Chapter 12, "GUI Basics." 

When you develop programs to create graphical user interfaces, you will use Java 
classes such as JFrame, JButton, JRadioButton, JComboBox, and JList to create 
frames, buttons, radio buttons, combo boxes, lists, and so on. Listing 8.5 is an example 
that creates two windows using the J Frame class. The output of the program is shown in 
Figure 8.11. 



I Window 



Jn]j<J 



I Window 



JoJjcj 



Figure 8.1 1 The program creates two windows using the DFrame class. 



Listing 8.5 Test Frame, java 

1 import javax. swing. J Frame; 





2 

3 


public class TestFrame { 




4 


public static void main(String[] args) { 


create an object 


5 


DFrame framel = new JFrameO; 


invoke a method 


6 


framel.setTi tie ("Window 1"); 




7 


framel. setSize(200, 150); 




8 


framel.setLocation(200, 100); 




9 


framel . setDef aul tCl oseOpe rati on (J Frame 




10 


framel. setVi si bl e(true) ; 




11 




create an object 


12 


JFrame frame2 = new JFrameO; 


invoke a method 


13 


frame2.setTi tie ("Window 2"); 




14 


frame2.setSize(200, 150); 




15 


frame2.setLocation(410, 100); 




16 


f rame2 . setDef aul tCl oseOperati on (1 Frame 




17 


f rame2 . setVi si bl e(true) ; 




18 


} 




19 


} 



This program creates two objects of the JFrame class (lines 5, 12) and then uses the methods 
setTitle, setSize, setLocation, setDefaultCloseOperation, and setVisible to 

set the properties of the objects. The setTitle method sets a title for the window (lines 6, 
13). The setSize method sets the window's width and height (lines 7, 14). The 
setLocation method specifies the location of the window's upper-left corner (lines 8, 15). 
The setDefaultCloseOperation method terminates the program when the frame is 
closed (lines 9, 16). The setVisible method displays the window. 

You can add graphical user interface components, such as buttons, labels, text fields, 
check boxes, and combo boxes to the window. The components are defined using 
classes. Listing 8.6 gives an example of creating a graphical user interface, as shown in 
Figure 8.1. 



8.6 Using Classes from the Java Library 277 



Listing 8.6 GUIComponents . java 



i 

2 
3 
4 
5 
6 
7 
8 
9 
10 
11 
12 
13 
14 
15 
16 
17 
18 
19 
20 
21 
22 
23 
24 
25 
26 
27 
28 
29 
30 
31 
32 
33 
34 
35 
36 
37 
38 
39 
40 
41 
42 
43 
44 
45 
46 
47 
48 
49 
50 
51 
52 
53 



import javax. swi ng . * ; 

public class GUIComponents { 

public static void main(String[] args) { 

// Create a button with text OK 
JButton jbtOK = new JButton("0K") ; 

// Create a button with text Cancel 
JButton jbtCancel = new JButton("Cancel ") ; 

// Create a label with text "Enter your name: 
JLabel jlblName = new JLabel ("Enter your name: 



); 



// Create a text field with text "Type Name Here" 
JTextField jtfName = new JTextField ("Type Name Here"); 

// Create a check box with text bold 
JCheckBox jchkBold = new JCheckBox("Bol d") ; 

// Create a check box with text italic 
JCheckBox jchkltalic = new JCheckBox("Ital ic") ; 

// Create a radio button with text red 
JRadioButton jrbRed = new JRadioButton("Red") ; 

// Create a radio button with text yellow 
JRadioButton jrbYellow = new JRadioButton ("Yellow") ; 

// Create a combo box with several choices 
JComboBox jcboColor = new JComboBox(new Stri ng [] {"Freshman" , 
"Sophomore", "Junior", "Senior"}); 

// Create a panel to group components 
J Panel panel = new JPanelO; 

panel .add (jbtOK) ; // Add the OK button to the panel 
panel .add(jbtCancel) ; // Add the Cancel button to the panel 
panel .add(jlblName) ; // Add the label to the panel 
panel . add( jtfName) ; // Add the text field to the panel 
panel .add(jchkBold) ; // Add the check box to the panel 
panel .add(jchkltalic) ; // Add the check box to the panel 
panel .add(j rbRed) ; // Add the radio button to the panel 
panel . add (j rbYel 1 ow) ; // Add the radio button to the panel 
panel .add(jcboColor) ; // Add the combo box to the panel 

JFrame frame = new JFrameO; // Create a frame 
frame . add(panel ) ; // Add the panel to the frame 
frame. setTi tie ("Show GUI Components"); 
frame.setSize(450, 100); 
frame. setLocati on (200, 100); 

frame . setDef aul tCl oseOperati on (J Frame . EXIT_0N_CL0SE) ; 
frame . setVi si bl e (true) ; 



Video Note 

Use classes 



create a button 



create a button 



create a label 



create a text field 



create a check box 



create a check box 



create a radio button 



create a radio button 



create a combo box 



create a panel 
add to panel 



create a frame 
add panel to frame 



display frame 



} 



This program creates GUI objects using the classes JButton, JLabel, JTextField, 
JCheckBox, JRadioButton, and JComboBox (lines 6-31). Then, using the JPanel class 
(line 34), it then creates a panel object and adds to it the button, label, text field, check box, 
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radio button, and combo box (lines 35-43). The program then creates a frame and adds the 
panel to the frame (line 45). The frame is displayed in line 51. 



instance variable 



Video Note 

static vs. instance 



static variable 



static method 



8.7 Static Variables, Constants, and Methods 

The data field radius in the circle class in Listing 8.1 is known as an instance variable. An 
instance variable is tied to a specific instance of the class; it is not shared among objects of the 
same class. For example, suppose that you create the following objects: 



Circle circlel 
Circle circle2 



new Ci rcl e() ; 
new Ci rcl e(5) ; 



The radi us in ci rcl el is independent of the radi us in ci rcl e2 and is stored in a different mem- 
ory location. Changes made to ci rcl el's radi us do not affect ci rcl e2's radi us, and vice versa. 

If you want all the instances of a class to share data, use static variables, also known as 
class variables. Static variables store values for the variables in a common memory location. 
Because of this common location, if one object changes the value of a static variable, all 
objects of the same class are affected. Java supports static methods as well as static variables. 
Static methods can be called without creating an instance of the class. 

Let us modify the Circle class by adding a static variable numberOfObjects to count 
the number of circle objects created. When the first object of this class is created, 
numberOfObjects is 1. When the second object is created, numberOfObjects becomes 2. 
The UML of the new circle class is shown in Figure 8.12. The Circle class defines the 
instance variable radius and the static variable numberOfObjects, the instance methods 
getRadius, setRadius, and getArea, and the static method getNumberOf Objects. 
(Note that static variables and methods are underlined in the UML class diagram.) 



UML Notation: 
underline: static variables or methods 



Circle 



instantiate 



Memory 



radius: double 
numberOfObjects: int 



qetNumberOfObjectsO 



getAreaQ : doubl e 




After two Ci rcl e 
Objects were created, 
numberOfObjects 

is 2. 



numberOfObjects 



radi us 



Figure 8.12 Instance variables belong to the instances and have memory storage independent of one another. Static 
variables are shared by all the instances of the same class. 

To declare a static variable or define a static method, put the modifier static in the vari- 
able or method declaration. The static variable numberOfObjects and the static method 
getNumberOfObjectsQ can be declared as follows: 



declare static variable 
define static method 



static int numberOfObjects; 

static int getNumberObjects () { 
return numberOfObjects; 

} 

Constants in a class are shared by all objects of the class. Thus, constants should be declared 
final static. For example, the constant PI in the Math class is defined as: 



declare constant 



final static double PI = 3.14159265358979323846; 
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The new circle class, named Ci rcl e2, is declared in Listing 8.7: 

Listing 8.7 Circle2.java 

1 public class Circle2 { 

2 /** The radius of the circle */ 

3 double radius; 
4 

5 /** The number of objects created */ 

6 static int numberOfObjects = 0; static variable 
7 

8 /** Construct a circle with radius 1 */ 

9 Circle2() { 

10 radius = 1.0; 

11 number0f0bjects++; increase by 1 

12 } 
13 

14 /** Construct a circle with a specified radius */ 

15 Ci rcl e2 (double newRadius) { 

16 radius = newRadius; 

17 number0f0bjects++; increase by 1 

18 } 
19 

20 /** Return numberOfObjects */ 

21 static int getNumberOfObjectsO { static method 

22 return numberOfObjects; 

23 } 
24 

2 5 /** Return the area of this circle */ 

26 double getAreaO { 

27 return radius * radius * Math. PI; 

28 } 

29 } 

Method getNumberOfObjectsO in Circle2 is a static method. Other examples of static 
methods are showMessageDialog and showInputDialog in the JOptionPane class and 

all the methods in the Math class. The main method is static, too. 

Instance methods (e.g., getAreaO) and instance data (e.g., radius) belong to instances 
and can be used only after the instances are created. They are accessed via a reference variable. 
Static methods (e.g., getNumberOfObjectsO) and static data (e.g., numberOfObjects) 
can be accessed from a reference variable or from their class name. 

The program in Listing 8.8 demonstrates how to use instance and static variables and 
methods and illustrates the effects of using them. 

Listing 8.8 TestCi rcle2. java 

1 public class TestCi rcle2 { 

2 /** Main method */ 

3 public static void main(String[] args) { 

4 System. out. pri ntl n("Before creating objects"); 

5 System. out. println("The number of Circle objects is " + 

6 Ci rcl e2 . numberOfObjects) ; static variable 
7 

8 // Create cl 

9 Circle2 cl = new Circle2(); 
10 

11 // Display cl BEFORE c2 is created 

12 System. out. pri ntl n("\nAfter creating cl") ; 

13 System. out. println("cl: radius (" + cl. radius + instance variable 

14 ") and number of Circle objects (" + 
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15 cl.numberOf Objects + ")"); 
16 

17 // Create c2 

18 Circle2 c2 = new Circle2(5); 
19 

20 // Modify cl 

21 cl. radius = 9; 
22 

23 // Display cl and c2 AFTER c2 was created 

24 System. out. pri ntl n("\nAfter creating c2 and modifying cl") ; 

25 System. out. pri ntl n("cl: radius (" + cl. radius + 

26 ") and number of Circle objects (" + 

27 cl.numberOfObjects + ")"); 

28 System. out. println("c2: radius (" + c2. radius + 

29 ") and number of Circle objects (" + 

30 c2.number0f0bjects + ")"); 

31 } 

32 } 



Before creating objects 




The number of Circle objects is 




After creating cl 




cl: radius (1.0) and number of Circle objects 


(1) 


After creating c2 and modifying cl 




cl: radius (9.0) and number of Circle objects 


(2) 


c2 : radius (5.0) and number of Circle objects 


(2) 



When you compile TestCi rcl e2. java, the Java compiler automatically compiles 
Ci rcl e2 .java if it has not been compiled since the last change. 

Static variables and methods can be accessed without creating objects. Line 6 displays the 
number of objects, which is 0, since no objects have been created. 

The main method creates two circles, cl and c2 (lines 9, 18). The instance variable radius 
in cl is modified to become 9 (line 21). This change does not affect the instance variable radi us 
in c2, since these two instance variables are independent. The static variable numberOfObjects 
becomes 1 after cl is created (line 9), and it becomes 2 after c2 is created (line 18). 

Note that PI is a constant defined in Math, and Math. PI references the constant, 
c. numberOfObjects could be replaced by Ci rcl e2. numberOfObjects. This improves 
readability, because the reader can easily recognize the static variable. You can also replace 
Circle2 . numberOfObjects by Circle2 .getNumberOfObjects(). 

§ Tip 

Use Cl assName . methodName(arguments) to invoke a static method and Cl assName . - 

staticVariable to access a static variable. This improves readability, because the user can 
easily recognize the static method and data in the class. 

Static variables and methods can be used from instance or static methods in the class. How- 
ever, instance variables and methods can be used only from instance methods, not from static 
methods, since static variables and methods don't belong to a particular object. Thus the code 
given below is wrong. 

1 public class Foo { 

2 int i = 5; 

3 static int k = 2; 

4 

5 public static void main(String[] args) { 

6 int j = i; // Wrong because i is an instance variable 

7 ml() ; // Wrong because ml() is an instance method 
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9 
10 
11 
12 
13 
14 
15 
16 
17 
18 

19 } 



} 

public void ml() { 

// Correct since instance and static variables and methods 
// can be used in an instance method 
i = i + k + m2 (i , k) ; 

} 

public static int m2(int i, int j) { 
return (int) (Math . pow(i , j)); 

} 



Note that if you replace the code in lines 5-8 with the following new code, the program is fine, 
because the instance data field i and method ml are now accessed from an object f oo (lines 6-7): 



1 
2 
3 
4 
5 
6 
7 
8 
9 
10 
11 
12 
13 
14 
15 
16 
17 
18 



public class Foo { 
int i = 5; 
static int k = 2; 

public static void main(String[] args) { 
Foo foo = new Foo(); 

int j = foo.i; // OK, foo.i accesses the object's instance variable 
foo.mlO; // OK. Foo.mlO invokes object's instance method 

} 



public void ml() { 
i = i + k + m2 (i , 

} 



k); 



public static int m2(int i 
return (int) (Math . pow(i , 

} 



, int j) { 

j)); 



} 



Design Guide 

How do you decide whether a variable or method should be an instance one or a static one? A vari- 
able or method that is dependent on a specific instance of the class should be an instance variable or 
method. A variable or method that is not dependent on a specific instance of the class should be a 
static variable or method. For example, every circle has its own radius. Radius is dependent on a spe- 
cific circle. Therefore, radius is an instance variable of the Circle class. Since the getArea 
method is dependent on a specific circle, it is an instance method. None of the methods in the Math 
class, such as random, pow, sin, and cos, is dependent on a specific instance. Therefore, these 
methods are static methods. The main method is static and can be invoked directly from a class. 

Caution 

It is a common design error to define an instance method that should have been defined static. 
For example, the method factorial (int n) should be defined static, as shown below, 
because it is independent of any specific instance. 



public class Test { 




public int factori al (int 


n) { 


int result = 1; 




for (int i =1; i <= n 


; i++) 


resul t *= i ; 




return result; 




} 




} 




(a) Wrong design 



instance or static? 



common design error 



public class Test { 

public static int factori al (int n) 
int result = 1; 
for (int i =1; i <= n; i++) 
resul t *= i ; 

return result; 



(b) Correct design 
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8.8 Visibility Modifiers 

You can use the publ ic visibility modifier for classes, methods, and data fields to denote that 
they can be accessed from any other classes. If no visibility modifier is used, then by default 
the classes, methods, and data fields are accessible by any class in the same package. This is 
known as package-private or package-access. 

S Note 

using packages Packages can be used to organize classes. To do so, you need to add the following line as the first 

noncomment and nonblank statement in the program: 

package packageName ; 

If a class is defined without the package statement, it is said to be placed in the default package. 

Java recommends that you place classes into packages rather using a default package. For simplic- 
ity, however, this book uses default packages. For more information on packages, see Supplement 
lll.G, "Packages." 

In addition to the publ ic and default visibility modifiers, Java provides the private and 
protected modifiers for class members. This section introduces the private modifier. The 
protected modifier will be introduced in §11.13, "The protected Data and Methods." 

The private modifier makes methods and data fields accessible only from within its own 
class. Figure 8.13 illustrates how a public, default, and private data field or method in class CI 
can be accessed from a class C2 in the same package and from a class C3 in a different package. 



package pi; 

public class CI { 
public int x; 
int y; 

private int z; 

public void ml() { 
} 

void m2() { 
} 

private void m30 { 

} 

} 



package pi; 

public class C2 { 
void aMethodO { 
CI o = new Cl() ; 
can access o.x; 
can access o.y; 
cannot access o.z; 

can invoke o.ml() ; 
can invoke o.m2() ; 
cannot invoke o.m3(); 



} 



package p2 ; 

public class C3 { 
void aMethodO { 
CI o = new Cl() ; 
can access o.x; 
cannot access o.y; 
cannot access o.z; 

can invoke o.ml() ; 
cannot invoke o.m2(); 
cannot invoke o.m3(); 



} 



Figure 8.1 3 The private modifier restricts access to its defining class, the default modifier restricts access to a package, 
and the public modifier enables unrestricted access. 



If a class is not defined public, it can be accessed only within the same package. As shown 
in Figure 8.14, CI can be accessed from C2 but not from C3. 



package pi; 
class CI { 

} 



package pi; 




public class 


C2 { 


can access 


CI 


} 





package p2 ; 




public class C3 


{ 


cannot access 


CI; 


can access C2 ; 




} 





Figure 8.14 A nonpublic class has package-access. 



A visibility modifier specifies how data fields and methods in a class can be accessed from 
outside the class. There is no restriction on accessing data fields and methods from inside the 
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class. As shown in Figure 8.15(b), an object foo of the Foo class cannot access its private 
members, because foo is in the Test class. As shown in Figure 8.15(a), an object foo of the 
Foo class can access its private members, because foo is defined inside its own class. inside access 



public class Foo { 
private boolean x; 

public static void main(String[] args) { 
Foo foo = new Foo(); 
System. out. println(foo.x) ; 
System . out . pri ntl n (foo . convert () ) ; 

} 

private int convert() { 
return x ? 1 : 1; 

} 

} 



public class Test { 

public static void main(String[] args) { 
Foo foo = new Foo() ; 
System . out . pri ntl n (foo . x) ; 
System . out . pri ntl n (foo . convert ()) ; 

} 

} 




(a) This is OK because object foo is used inside the Foo class (b) This is wrong because x and convert are private in Foo. 



Figure 8.1 5 An object can access its private members if it is defined in its own class. 



<jw£ Caution 

The private modifier applies only to the members of a class. The pub! ic modifier can apply 
to a class or members of a class. Using modifiers publ ic and private on local variables would 
cause a compile error. 

§ Note 

In most cases, the constructor should be public. However, if you want to prohibit the user from 

creating an instance of a class, use a private constructor. For example, there is no reason to create private constructor 

an instance from the Math class, because all of its data fields and methods are static. To prevent 
the user from creating objects from the Math class, the constructor in java.lang.Math is 
defined as follows: 

private MathO { 
} 



8.9 Data Field Encapsulation 

The data fields radius and numberOfObjects in the Circle2 class in Listing 8.7 can be 
modified directly (e.g., myCircle. radius = 5 or Ci rcl e2 . numberOfObjects = 10). 

This is not a good practice — for two reasons: 

■ First, data may be tampered with. For example, numberOfObjects is to count the 
number of objects created, but it may be mistakenly set to an arbitrary value (e.g., 
Ci rcl e2. numberOfObjects = 10). 

■ Second, the class becomes difficult to maintain and vulnerable to bugs. Suppose you 
want to modify the Ci rcl e2 class to ensure that the radius is nonnegative after other 
programs have already used the class. You have to change not only the Circle2 
class but also the programs that use it, because the clients may have modified the 
radius directly (e.g., myCircle. radius = -5). 

To prevent direct modifications of data fields, you should declare the data fields private, 
using the private modifier. This is known as data field encapsulation. data field encapsulation 

A private data field cannot be accessed by an object from outside the class that defines the 
private field. But often a client needs to retrieve and modify a data field. To make a private 




Video Note 

Data field encapsulation 
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data field accessible, provide a get method to return its value. To enable a private data field to 
be updated, provide a set method to set a new value. 

HI Note 

accessor " Colloquially, a get method is referred to as a getter (or accessor), and a set method is referred 

mutator to as a setter (or mutator). 

A get method has the following signature: 

public returnType getPropertyNameQ 
boolean accessor If the returnType is boo! ean, the get method should be defined as follows by convention: 

public boolean isPropertyNameQ 
A set method has the following signature: 

public void setPropertyName(dataType propertyVal ue) 

Let us create a new circle class with a private data-field radius and its associated accessor and 
mutator methods. The class diagram is shown in Figure 8.16. The new circle class, named 
Ci rcl e3, is defined in Listing 8.9: 



The - sign indicates 
private modifier — 



Circle 



-radius: double 
- numberOfObjects : int 



+Ci rcl e() 

+Ci rcl e(radi us : double) 
+getRadi us() : double 
+setRadi us(radi us : double): void 
+ getNumberOfObjectsQ : int 
+getArea() : double 



The radius of this circle (default: 1.0). 
The number of circle objects created. 

Constructs a default circle object. 

Constructs a circle object with the specified radius. 

Returns the radius of this circle. 

Sets a new radius for this circle. 

Returns the number of circle objects created. 

Returns the area of this circle. 



Figure 8.1 6 The Ci rcl e class encapsulates circle properties and provides get/set and other methods. 



Listing 8.9 Circle3.java 



encapsulate radius 



encapsulate 

numberOfObjects 



1 
2 
3 
4 
5 
6 
7 
8 
9 
10 
11 
12 
13 
14 
15 
16 
17 
18 



public class Circle 3 { 

/** The radius of the circle 
private double radius = 1; 



V 



/** The number of the objects created */ 
private static int numberOfObjects = 0; 



with radius 1 */ 



/** Construct a circle 
public Ci rcle3() { 
number0f0bjects++ ; 

} 



/** Construct a circle with a specified radius */ 
public Ci rcl e3 (double newRadius) { 

radius = newRadius; 

number0f0bjects++; 

} 
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19 /** Return radius */ 

20 public double getRadiusO { 

21 return radius; 

22 } 
23 

24 /** Set a new radius */ 

25 public void setRadi us (double newRadius) { 

26 radius = (newRadius >= 0) ? newRadius : 0; 

27 } 
28 

29 /** Return numberOfObjects */ 

30 public static int getNumberOfObjectsO { 

31 return numberOfObjects; 

32 } 
33 

34 /** Return the area of this circle */ 

35 public double getAreaO { 

36 return radius * radius * Math. PI; 

37 } 

38 } 

The getRadiusO method (lines 20-22) returns the radius, and the setRadi us (newRadius) 
method (line 25-27) sets a new radius into the object. If the new radius is negative, is set to the 
radius in the object. Since these methods are the only ways to read and modify radius, you have 
total control over how the radi us property is accessed. If you have to change the implementation 
of these methods, you need not change the client programs. This makes the class easy to maintain. 

Listing 8.10 gives a client program that uses the Ci rcl e class to create a Ci rcl e object 
and modifies the radius using the setRadi us method. 

Listing 8.10 TestCi rcle3. java 

1 public class TestCi rcle3 { 

2 /** Main method */ 

3 public static void main(String[] args) { 

4 // Create a Circle with radius 5.0 

5 Circle3 myCircle = new Ci rcl e3 (5.0) ; 

6 System. out. println("The area of the circle of radius " 

7 + myCircle. getRadiusO + " is " + myCi rcl e. getAreaO ) ; invoke public method 
8 

9 // Increase myCircle' s radius by 10% 

10 myCi rcl e. setRadi us (myCi rcl e. getRadiusO * 1-1); 

11 System. out. println("The area of the circle of radius " 

12 + myCircle. getRadiusO + " is " + myCi rcl e. getAreaO ) ; invoke public method 
13 

14 System. out. println("The number of objects created is " 

15 + Ci rcle3. getNumberOfObjectsO ) ; invoke public method 

16 } 

17 } 

The data field radius is declared private. Private data can be accessed only within their 
defining class. You cannot use myCircle. radius in the client program. A compile error 
would occur if you attempted to access private data from a client. 

Since numberOfObjects is private, it cannot be modified. This prevents tampering. For 
example, the user cannot set numberOfObjects to 100. The only way to make it 100 is to 
create 100 objects of the Ci rcl e class. 

Suppose you combined TestCi rcl e and Circle into one class by moving the main 
method in TestCi rcl e into Circle. Could you use myCircle. radius in the main 
method? See Review Question 8.15 for the answer. 



access method 



mutator method 



access method 
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Design Guide 

To prevent data from being tampered with and to make the class easy to maintain, declare data 
fields private. 



8.10 Passing Objects to Methods 

You can pass objects to methods. Like passing an array, passing an object is actually passing 
the reference of the object. The following code passes the myCi rcl e object as an argument to 
the pr i ntCi rcl e method: 

1 public class Test { 

2 public static void main(String[] args) { 

3 // Circle3 is defined in Listing 8.9 

4 Circle3 myCircle = new Ci rcl e3 (5.0) ; 
pass an object 5 pri ntCi rcl e(myCi rcl e) ; 

6 } 
7 

8 public static void pri ntCi rcl e(Ci rcl e3 c) { 

9 System. out. pri ntln ("The area of the circle of radius " 

10 + c.getRadiusO + " is " + c.getAreaO) ; 

11 } 

12 } 

pass-by-value Java uses exactly one mode of passing arguments: pass-by-value. In the preceding code, the 

value of myCircle is passed to the printCircle method. This value is a reference to a 
Ci rcl e object. 

Let us demonstrate the difference between passing a primitive type value and passing a ref- 
erence value with the program in Listing 8.1 1: 

Listing 8.1 1 TestPassObject . java 

1 public class TestPassObject { 

2 /** Main method */ 

3 public static void main(String[] args) { 

4 // Create a Circle object with radius 1 

5 Circle3 myCircle = new Circle3(l); 
6 

7 // Print areas for radius 1, 2, 3, 4, and 5. 

8 int n = S; 

pass object 9 pri ntAreas (myCi rcl e , n) ; 

10 

11 // See myCi rcl e . radi us and times 

12 System. out. println("\n" + "Radius is " + myCi rcle.getRadiusO) ; 

13 System. out. println("n is " + n) ; 

14 } 
15 

16 /** Print a table of areas for radius */ 

object parameter 17 public static void pri ntAreas (Ci rcl e3 c, int times) { 

18 System. out. println("Radius \t\tArea") ; 

19 while (times >= 1) { 

20 System. out. println(c.getRadius() + "\t\t" + c.getAreaO); 

21 c.setRadius(c.getRadius() + 1); 

22 times--; 

23 } 

24 } 

25 } 
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Radi us 


Area 


1.0 


3.141592653589793 


2.0 


12.566370614359172 


3.0 


29.274333882308138 


4.0 


50.26548245743669 


5.0 


79.53981633974483 


Radius is 6.0 




n i s 5 





The Circle3 class is defined in Listing 8.9. The program passes a Circle3 object 
myCircle and an integer value from n to invoke printAreas (myCircle, n) (line 9), 
which prints a table of areas for radii 1, 2, 3, 4, 5, as shown in the sample output. 

Figure 8.17 shows the call stack for executing the methods in the program. Note that the 
objects are stored in a heap. 



Stack 

Space required for the 
pri ntArea method 

int times: 5 -* — 
Circle c: | reference |-* 


Pass-by-value (here 
the value is 5) 

/ Pass-by-value 

- - J / (here the value is 

_ 4 the reference for 

___!____ the object) 

» 

— i > 


Heap 


Space required for the 
mai n method 
int n: 5 


A Ci rcl e 

object 


myCi rcle: 


reference 







Figure 8.1 7 The value of n is passed to times, and the reference of myCi rcle is passed to 
c in the printAreas method. 

When passing an argument of a primitive data type, the value of the argument is passed. In 
this case, the value of n (5) is passed to times. Inside the printAreas method, the content 
of times is changed; this does not affect the content of n. 

When passing an argument of a reference type, the reference of the object is passed. In this 
case, c contains a reference for the object that is also referenced via myCi rcl e. Therefore, 
changing the properties of the object through c inside the printAreas method has the same 
effect as doing so outside the method through the variable myCi rcl e. Pass-by- value on refer- 
ences can be best described semantically as pass-by-sharing; i.e., the object referenced in the pass-by-sharing 
method is the same as the object being passed. 

8.1 1 Array of Objects 

In Chapter 6, "Single-Dimensional Arrays," arrays of primitive type elements were created. 
You can also create arrays of objects. For example, the following statement declares and cre- 
ates an array of ten Ci rcl e objects: 

Circle[] circleArray = new Circle [10]; 
To initialize the ci rcl eArray, you can use a for loop like this one: 

for (int i = 0; i < ci rcleArray. length; i++) { 
ci rcleArray[i] = new CircleO; 

} 
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An array of objects is actually an array of reference variables. So, invoking circleArray- 
[1] .getAreaO involves two levels of referencing, as shown in Figure 8.18. ci rcl eArray 
references the entire array, ci rcl eArray [1] references a Ci rcl e object. 



ci rcl eArray reference [ - 



ci rcl eArray [0] 




Ci rcle object | 




ci rcl eArray [1] 










Ci rcle object 1 | 


ci rcl eArray [9] 


Ci rcle object 9 | 





Figure 8.1 8 In an array of objects, an element of the array contains a reference to an object. 



gj| Note 

When an array of objects is created using the new operator, each element in the array is a refer- 
ence variable with a default value of nul 1 . 

Listing 8.12 gives an example that demonstrates how to use an array of objects. The program 
summarizes the areas of an array of circles. The program creates ci rcl eArray, an array 
composed of five Ci rcl e objects; it then initializes circle radii with random values and dis- 
plays the total area of the circles in the array. 

Listing 8.12 Total Area, java 

1 public class Total Area { 

2 /** Main method */ 

3 public static void main(String[] args) { 

4 // Declare circleArray 
array of objects 5 Circle3[] circleArray; 

6 

7 // Create circleArray 

8 circleArray = createCi rcl eArray () ; 
9 

10 // Print circleArray and total areas of the circles 

11 pri ntCi rcl eArray (ci rcl eArray) ; 

12 } 
13 

14 /** Create an array of Circle objects */ 

return array of objects 15 public static Circle3[] created' rcl eArray () { 

16 Circle3[] circleArray = new Circle3[5]; 
17 

18 for (int i =0; i < ci rcl eArray . 1 ength ; i++) { 

19 ci rcl eArray [i ] = new Ci rcle3(Math. randomO * 100); 

20 } 
21 

22 // Return Circle array 

23 return circleArray; 

24 } 
25 

26 /** Print an array of circles and their total area */ 

pass array of objects 27 public static void pri ntCi rcl eArray(Ci rcl e3 [] circleArray) { 

28 System. out. pri ntf ("%-30s%-15s\n" , "Radius", "Area"); 

29 for (int i = 0; i < ci rcl eArray . 1 ength ; i++) { 

30 System.out.printf ("%-30f%-15f\n" , ci rcl eArray [i] .getRadius() , 

31 ci rcleArray[i] .getAreaO) ; 

32 } 
33 

34 System. out. println(" ") ; 
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35 

36 // Compute and display the result 

37 System. out. pri ntf ("%-30s%-15f\n" , "The total area of circles is", 

38 sum(ci rcleArray) ) ; 

39 } 
40 

41 /** Add circle areas */ 

42 public static double sum(Ci rcl e3 [] ci rcleArray) { pass array of objects 

43 // Initialize sum 

44 double sum = 0; 
45 

46 // Add areas to sum 

47 for (int i = 0; i < ci rcl eArray . 1 ength ; i++) 

48 sum += ci rcleArray[i] .getAreaO ; 
49 

50 return sum; 

51 } 

52 } 



Radi us 
70.577708 
44.152266 
24.867853 

5.680718 
36.734246 




Area 
15648.941866 
6124.291736 
1942.792644 
101.380949 
4239.280350 


The total area of circles 


i s 


28056.687544 


The program invokes created rcl eArray () (line 8) to create an array of five Circle 
objects. Several Ci rcl e classes were introduced in this chapter. This example uses the 
Ci rcl e class introduced in §8.9, "Data Field Encapsulation." 

The circle radii are randomly generated using the Math . random () method (line 19). The 
createCi rcl eArray method returns an array of Circle objects (line 23). The array is 
passed to the pr i ntCi rcl eArray method, which displays the radius and area of each circle 
and the total area of the circles. 

The sum of the circle areas is computed using the sum method (line 38), which takes the 
array of Ci rcl e objects as the argument and returns a doubl e value for the total area. 

Key Terms 
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mutator method (setter) 285 
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Chapter Summary 



1 . A class is a template for objects. It defines the properties of objects and provides con- 
structors for creating objects and methods for manipulating them. 

2. A class is also a data type. You can use it to declare object reference variables. An 
object reference variable that appears to hold an object actually contains a reference to 
that object. Strictly speaking, an object reference variable and an object are different, 
but most of the time the distinction can be ignored. 

3. An object is an instance of a class. You use the new operator to create an object, 
and the dot (.) operator to access members of that object through its reference 
variable. 

4. An instance variable or method belongs to an instance of a class. Its use is associ- 
ated with individual instances. A static variable is a variable shared by all instances 
of the same class. A static method is a method that can be invoked without using 
instances. 

5. Every instance of a class can access the class's static variables and methods. For clarity, 
however, it is better to invoke static variables and methods using CI assName . vari abl e 
and CI assName . method. 

6. Modifiers specify how the class, method, and data are accessed. A public class, 
method, or data is accessible to all clients. A private method or data is accessible 
only inside the class. 

7. You can provide a get method or a set method to enable clients to see or modify the 
data. Colloquially, a get method is referred to as a getter (or accessor), and a set 
method as a setter (or mutator). 

8. A get method has the signature pub! ic returnType getPropertyName(). If the 
returnType is boolean, the get method should be defined as public boolean 
isPropertyNameO. A set method has the signature publ ic void setProper- 
tyName(dataType propertyValue). 

9. All parameters are passed to methods using pass-by-value. For a parameter of a prim- 
itive type, the actual value is passed; for a parameter of a reference type, the reference 
for the object is passed. 

1 0. A Java array is an object that can contain primitive type values or object type values. 
When an array of objects is created, its elements are assigned the default value of 
null. 

Review Questions 



Sections 8.2-8.5 

8.1 Describe the relationship between an object and its defining class. How do you 
define a class? How do you declare an object reference variable? How do you cre- 
ate an object? How do you declare and create an object in one statement? 

8.2 What are the differences between constructors and methods? 

8.3 Is an array an object or a primitive type value? Can an array contain elements of an 
object type as well as a primitive type? Describe the default value for the elements 
of an array. 

8.4 What is wrong with the following program? 
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1 public class ShowErrors { 

2 public static void main(String[] args) { 

3 ShowErrors t = new ShowErrors(5) ; 

4 } 

5 } 



(a) 



1 public class ShowErrors { 

2 public static void main(String[] args) { 

3 ShowErrors t = new ShowErrorsO ; 

4 t.x(); 

5 } 

6 } 



(b) 



1 public class ShowErrors { 

2 public void methodl() { 

3 Circle c; 

4 System. out. println ("What is radius " 

5 + c.getRadiusO) ; 

6 c = new Ci rcl e() ; 

7 } 

8 } 



(c) 



1 public class ShowErrors { 

2 public static void main(String[] args) { 

3 C c = new C(5.0); 

4 System . out . pri ntl n (c . val ue) ; 

5 } 

6 } 
7 

8 class C { 

9 int value = 2; 
10 } 



(d) 



8.5 What is wrong in the following code? 

1 class Test { 

2 public static void mai n(Stri ng [] args) { 

3 A a = new A() ; 

4 a.printO; 

5 } 

6 } 
7 

8 class A { 

9 String s; 
10 

11 A(String s) { 

12 this.s = s; 

13 } 
14 

15 public void printO { 

16 System. out . pri nt(s) ; 

17 } 

18 } 

8.6 What is the printout of the following code? 

public class Foo { 
private boolean x; 

public static void mai n(Stri ng [] args) { 
Foo foo = new Foo(); 
System. out. pri ntln(foo.x) ; 

} 

} 

Section 8.6 

8.7 How do you create a Date for the current time? How do you display the current 
time? 

8.8 How do you create a JFrame, set a title in a frame, and display a frame? 
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8.9 Which packages contain the classes Date, JFrame, JOptionPane, System, and 
Math? 

Section 8.7 

8.10 Suppose that the class Foo is defined in (a). Let f be an instance of Foo. Which of 
the statements in (b) are correct? 



8.12 



public class Foo { 
int i; 

static String s; 

void i method () { 
} 

static void smethodO { 
} 



System . out . pri ntl n(f . i ) ; 
System . out . pri ntl n(f . s) ; 
f .imethodO ; 
f. smethodO ; 

System . out . pri ntl n(Foo. i ) ; 
System . out . pri ntl n( Foo . s) ; 
Foo. imethodO ; 
Foo. smethodO ; 



(a) 



(b) 



8.11 Add the stati c keyword in the place of ? if appropriate. 

public class Test { 
private int count; 

public ? void mai n(Stri ng [] args) { 
} 

public ? int getCountO { 
return count; 

} 

public ? int factorial (int n) { 
int result = 1; 
for (int i = 1; i <= n; i++) 
resul t *= i ; 



return result; 



} 



Can you invoke an instance method or reference an instance variable from a static 
method? Can you invoke a static method or reference a static variable from an 
instance method? What is wrong in the following code? 



1 public class Foo { 

2 public static void mai n(Stri ng [] args) { 

3 methodlO; 

4 } 
5 

6 public void methodlO { 

7 method2(); 

8 } 
9 

10 public static void method2() { 

11 System. out . pri ntl n ("What is radius " + c.getRadiusO) ; 

12 } 
13 

14 Circle c = new CircleO; 

15 } 
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Sections 8.8-8.9 

8.1 3 What is an accessor method? What is a mutator method? What are the naming 
conventions for accessor methods and mutator methods? 

8.14 What are the benefits of data-field encapsulation? 

8.15 In the following code, radi us is private in the Ci rcl e class, and myCi rcl e is an 
object of the Ci rcl e class. Does the highlighted code below cause any problems? 
Explain why. 

public class Circle { 

private double radius = 1.0; 

/** Find the area of this circle */ 
public double getAreaO { 

return radius * radius * Math. PI; 

} 

public static void mai n(Stri ng [] args) { 
Circle myCircle = new CircleO; 

System. out . pri ntl n("Radius is " + myCi rcl e . radi us ) ; 

} 

} 

Section 8.10 

8.16 Describe the difference between passing a parameter of a primitive type and pass- 
ing a parameter of a reference type. Show the output of the following program: 



public class Test { 

public static void mai n (Stri ng [] args) { 
Count myCount = new Count (); 
int times = 0; 

for (int i =0; i < 100; i++) 
i ncrement(myCount , times); 

System. out. pri ntl n("count is " + myCount . count) ; 
System. out. pri ntl n("times is " + times); 

} 

public static void i ncrement(Count c, int times) { 
c.count++; 
times++; 

} 

} 



8.17 Show the output of the following program: 

public class Test { 

public static void mai n(Stri ng [] args) { 
Circle circlel = new Circle(l); 
Circle circle2 = new Circle (2); 

swapl(ci rcl el , circle2); 
System. out . pri ntl n("After swapl: circlel = " + 
ci rcl el. radius + " circle2 = " + ci rcl e2 . radi us) ; 

swap2 (ci rcl el , circle2); 

System. out . pri ntl n ("After swap2: circlel = " + 
ci rclel. radius + " circle2 = " + ci rcl e2 . radi us) ; 

} 



public class Count { 
public int count; 

public Count(int c) { 
count = c; 

} 

public Count() { 
count = 1; 

} 

} 
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public static void swapl(Circle x, Circle y) { 
Ci rcl e temp = x ; 
x = y; 
y = temp; 

} 

public static void swap2 (Circle x, Circle y) { 
double temp = x. radius; 
x. radius = y. radius; 
y . radi us = temp ; 

} 

} 

class Circle { 
double radius; 

Ci rcle(double newRadius) { 
radius = newRadius; 

} 

} 

8. 1 8 Show the printout of the following code: 



public class Test { 

public static void main(String[] args) { 
int[] a = {1, 2}; 
swap(a[0], a[l]); 

System. out. println("a[0] = " + a[0] 
+ " a[l] = " + a[l]); 

} 

public static void swap(int nl, int n2) { 
int temp = nl; 
nl = n2 ; 
n2 = temp; 

} 

} 



(a) 



public class Test { 

public static void main(String[] args) { 
T t = new TO ; 

swap(t) ; 

System. out. println("el = " + t.el 
+ " e2 = " + t.e2); 

} 

public static void swap(T t) { 
int temp = t.el; 
t.el = t.e2; 
t.e2 = temp; 

} 

} 

class T { 
int el = 1; 
int e2 = 2; 

} 



(c) 



public class Test { 

public static void mai n(Stri ng [] args) { 
int[] a = {1, 2}; 

swap (a) ; 

System. out. print! n("a[0] = " + a[0] 
+ " a[l] = " + a[l]); 

} 

public static void swap(int[] a) { 
int temp = a[0] ; 
a[0] = a[l]; 
a[l] = temp; 

} 

} 



(b) 



public class Test { 

public static void main(String[] args) { 
T tl = new T() ; 
T t2 = new T() ; 

System. out. println("tl's i = " + 
tl.i + " and j = " + tl.j); 

System. out. println("t2's i = " + 
t2.i + " and j = " + t2.j); 

} 

} 

class T { 

static int i = 0; 
int j = 0; 

TO { 
i++; 

j = i; 

} 

} 



(d) 
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8.19 What is the output of the following program? 



import java.util .Date; 

public class Test { 

public static void mai n(Stri ng [] args) { 
Date date = null ; 
ml(date) ; 

System. out . pri ntl n(date) ; 

} 

public static void ml(Date date) { 
date = new Date() ; 

} 

} 



(a) 



import java.util .Date; 

public class Test { 

public static void mai n (Stri ng [] args) { 
Date date = new Date(1234567) ; 
ml(date) ; 

System. out . pri ntl n(date .getTimeO) ; 

} 

public static void ml(Date date) { 
date.setTime(7654321) ; 

} 

} 



import java.util .Date; 

public class Test { 

public static void main(String[] args) { 
Date date = new Date(1234567) ; 
ml(date) ; 

System . out . pri ntl n (date . getTi me () ) ; 

} 

public static void ml(Date date) { 
date = new Date(7654321) ; 

} 

} 



(b) 



import java.util .Date; 

public class Test { 

public static void mai n(Stri ng [] args) { 
Date date = new Date(1234567) ; 
ml(date) ; 

System . out . pri ntl n (date . getTi me()) ; 

} 

public static void ml(Date date) { 
date = null ; 

} 

} 



(c) (d) 

Section 8. 1 1 

8.20 What is wrong in the following code? 

1 public class Test { 

2 public static void mai n(Stri ng [] args) { 

3 java.util .Date[] dates = new java.util .Date[10] ; 

4 System. out. println(dates[0]) ; 

5 System, out. pri ntl n (dates [0] .toStringO) ; 

6 } 

7 } 

Programming Exercises 



tj| Pedagogical Note 

The exercises in Chapters 8-14 achieve three objectives: three objectives 

■ Design classes and draw UML class diagrams; 

■ Implement classes from the UML; 

■ Use classes to develop applications. 

Solutions for the UML diagrams for the even-numbered exercises can be downloaded from the 
Student Website and all others can be downloaded from the Instructor Website. 
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Sections 8.2-8.5 

8.1 (The Rectangle class) Following the example of the Circle class in §8.2, 
design a class named Rectangl e to represent a rectangle. The class contains: 

■ Two double data fields named width and height that specify the width 
and height of the rectangle. The default values are 1 for both width and 
height. 

■ A no-arg constructor that creates a default rectangle. 

■ A constructor that creates a rectangle with the specified width and height. 

■ A method named getAreaO that returns the area of this rectangle. 

■ A method named getPeri meter () that returns the perimeter. 

Draw the UML diagram for the class. Implement the class. Write a test program 
that creates two Rectangl e objects — one with width 4 and height 40 and the 
other with width 3 . 5 and height 35.9. Display the width, height, area, and 
perimeter of each rectangle in this order. 

8.2 (The Stock class) Following the example of the Ci rcl e class in §8.2, design a 
class named Stock that contains: 

■ A string data field named symbol for the stock's symbol. 

■ A string data field named name for the stock's name. 

■ A double data field named previousClosingPrice that stores the stock 
price for the previous day. 

■ A double data field named currentPrice that stores the stock price for the 
current time. 

■ A constructor that creates a stock with specified symbol and name. 

■ A method named getChangePercentO that returns the percentage changed 
from previousClosingPrice to currentPrice. 

Draw the UML diagram for the class. Implement the class. Write a test program 
that creates a Stock object with the stock symbol JAVA, the name Sun Microsys- 
tems Inc, and the previous closing price of 4 . 5. Set a new current price to 4.35 
and display the price-change percentage. 



Section 8.6 

8.3* (Using the Date class) Write a program that creates a Date object, sets its elapsed 
time to 10000, 100000, 10000000, 10000000, 100000000, 1000000000, 
10000000000, 100000000000, and displays the date and time using the 
toStringO method, respectively. 

8.4* (Using the Random class) Write a program that creates a Random object with seed 
1000 and displays the first 50 random integers between and 100 using the 
nextlnt(lOO) method. 

8.5* (Using the CregorianCal endar class) Java API has the GregorianCalendar 
class in the j ava . u t i 1 package that can be used to obtain the year, month, and day of 
a date. The no-arg constructor constructs an instance for the current date, and the meth- 
ods get (GregorianCalendar .YEAR), get(GregorianCal endar .MONTH), and 
get(GregorianCal endar . DAY_0F_M0NTH) return the year, month, and day. 
Write a program to perform two tasks: 

■ Display the current year, month, and day. 

■ The GregorianCalendar class has the setTimelnMill is (long), which 
can be used to set a specified elapsed time since January 1, 1970. Set the value 
to 1234567898765L and display the year, month, and day. 
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Sections 8.7-8.9 

8.6** (Displaying calendars) Rewrite the PrintCalendar class in Listing 5.12 to dis- 
play calendars in a message dialog box. Since the output is generated from several 
static methods in the class, you may define a static String variable output for 
storing the output and display it in a message dialog box. 

8.7 (The Account class) Design a class named Account that contains: 

■ A private i nt data field named i d for the account (default 0). 

■ A private doubl e data field named bal ance for the account (default 0). 

■ A private doubl e data field named annual InterestRate that stores the cur- 
rent interest rate (default 0). Assume all accounts have the same interest rate. 

■ A private Date data field named dateCreated that stores the date when the 
account was created. 

■ A no-arg constructor that creates a default account. 

■ A constructor that creates an account with the specified id and initial balance. 

■ The accessor and mutator methods for i d, bal ance, and annual InterestRate. 

■ The accessor method for dateCreated. 

■ A method named getMonthl ylnterestRateO that returns the monthly 
interest rate. 

■ A method named withdraw that withdraws a specified amount from the 
account. 

■ A method named deposi t that deposits a specified amount to the account. 

Draw the UML diagram for the class. Implement the class. Write a test program 
that creates an Account object with an account ID of 1 122, a balance of $20,000, 
and an annual interest rate of 4.5%. Use the withdraw method to withdraw 
$2,500, use the deposit method to deposit $3,000, and print the balance, the 
monthly interest, and the date when this account was created. 

8.8 (The Fan class) Design a class named Fan to represent a fan. The class contains: 

■ Three constants named SLOW, MEDIUM, and FAST with values 1, 2, and 3 to 
denote the fan speed. Video Note 

■ A private int data field named speed that specifies the speed of the fan The Fan class 
(default SLOW). 

■ A private bool ean data field named on that specifies whether the fan is on 
(default f al se). 

■ A private double data field named radius that specifies the radius of the fan 
(default 5). 

■ A string data field named color that specifies the color of the fan (default 
blue). 

■ The accessor and mutator methods for all four data fields. 

■ A no-arg constructor that creates a default fan. 

■ A method named toStringO that returns a string description for the fan. If 
the fan is on, the method returns the fan speed, color, and radius in one com- 
bined string. If the fan is not on, the method returns fan color and radius along 
with the string "fan is off' in one combined string. 

Draw the UML diagram for the class. Implement the class. Write a test program 
that creates two Fan objects. Assign maximum speed, radius 10, color yellow, 
and turn it on to the first object. Assign medium speed, radius 5, color bl ue, and 
turn it off to the second object. Display the objects by invoking their toString 
method. 

8.9** (Geometry: n-sided regular polygon) In an n-sided regular polygon all sides 
have the same length and all angles have the same degree (i.e., the polygon is 
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both equilateral and equiangular). Design a class named Regul arPol ygon that 
contains: 

■ A private int data field named n that defines the number of sides in the poly- 
gon with default value 3. 

■ A private doubl e data field named side that stores the length of the side with 
default value 1. 

■ A private doubl e data field named x that defines the x-coordinate of the center 
of the polygon with default value 0. 

■ A private doubl e data field named y that defines the y-coordinate of the center 
of the polygon with default value 0. 

■ A no-arg constructor that creates a regular polygon with default values. 

■ A constructor that creates a regular polygon with the specified number of sides 
and length of side, centered at (0, 0). 

■ A constructor that creates a regular polygon with the specified number of sides, 
length of side, and x-and y-coordinates. 

■ The accessor and mutator methods for all data fields. 

■ The method getPeri meter () that returns the perimeter of the polygon. 

■ The method getAreaO that returns the area of the polygon. The formula for 
computing the area of a regular polygon is 

n X s 2 
Area = 

4 X tan 

Draw the UML diagram for the class. Implement the class. Write a test program 
that creates three Regul arPol ygon objects, created using the no-arg constructor, 
using Regul arPol ygon (6, 4), and using Regul arPol ygon (10, 4, 5.6, 
7.8). For each object, display its perimeter and area. 

8.10* (Algebra: quadratic equations) Design a class named Quadrat icEquat ion for a 
quadratic equation ax 2 + bx + x = 0. The class contains: 

■ Private data fields a, b, and c that represents three coefficients. 

■ A constructor for the arguments for a, b, and c. 

■ Three get methods for a, b, and c. 

■ A method named getDi scr i mi nant () that returns the discriminant, which is 
b 2 - 4ac. 

■ The methods named getRootlO and getRoot2() for returning two roots of 
the equation 

-b + Vb 2 - Aac -b - Vb 2 - 4ac 

r\ = ~ and r 2 = 

2a 2a 

These methods are useful only if the discriminant is nonnegative. Let these meth- 
ods return if the discriminant is negative. 

Draw the UML diagram for the class. Implement the class. Write a test program 
that prompts the user to enter values for a, b, and c and displays the result based on 
the discriminant. If the discriminant is positive, display the two roots. If the dis- 
criminant is 0, display the one root. Otherwise, display "The equation has no roots." 
See Exercise 3.1 for sample runs. 
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8.1 I * (Algebra: 2X2 linear equations) Design a class named LinearEquation for a 

2X2 system of linear equations: 

ax + by = e ed — bf af — ec 



cx + dy = f ad — be ad — be 

The class contains: 

■ Private data fields a, b, c, d, e, and f . 

■ A constructor with the arguments for a, b, c, d, e, and f . 

■ Six get methods for a, b, c, d, e, and f . 

■ A method named i sSol vabl e () that returns true if ad — be is not 0. 

■ Methods getXO and getYO that return the solution for the equation. 

Draw the UML diagram for the class. Implement the class. Write a test program 
that prompts the user to enter a, b, c, d, e, and f and displays the result. If 
ad — be is 0, report that "The equation has no solution." See Exercise 3.3 for 
sample runs. 

8.12** (Geometry: intersection) Suppose two line segments intersect. The two endpoints 
for the first line segment are (xl, yl) and (x2, y2) and for the second line seg- 
ment are (x3, y3) and (x4, y5). Write a program that prompts the user to enter 
these four endpoints and displays the intersecting point. 

(Hint: Use the LinearEquation class from the preceding exercise.) 



The intersecting point is: (1.0, 1.0) 



2 





2 








^ Enter 





2 





2 





1^ Enter 



8.1 3** (The Location class) Design a class named Location for locating a maximal 
value and its location in a two-dimensional array. The class contains public data 
fields row, col umn, and maxVal ue that store the maximal value and its indices 
in a two dimensional array with row and col umn as int type and maxVal ue as 
doubl e type. 

Write the following method that returns the location of the largest element in a 
two-dimensional array. 

public static Location locateLargest (doublet] □ a) 

The return value is an instance of Location. Write a test program that prompts 
the user to enter a two-dimensional array and displays the location of the largest 
element in the array. Here is a sample run: 



Enter the number of 


rows and columns of the array: 3 4 |^ Enter 


Enter the array: 




23.5 35 2 10 


|— i Enter 




4.5 3 45 3.5 


^^nterj 




35 44 5.5 9.6 


-i Enter 




The location of the 


largest element is 45 at (1, 2) 
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Chapter 



Strings and Text I/O 

Objectives 

■ To use the Stri ng class to process fixed strings (§9.2). 

■ To use the Character class to process a single character (§9.3). 

■ To use the StringBuilder/StringBuffer class to process flexible strings (§9.4) 

■ To distinguish among the String, StringBuilder, and StringBuffer classes 
(§9.2-9.4). 

■ To learn how to pass arguments to the mai n method from 
the command line (§9.5). 

■ To discover file properties and to delete and rename files 
using the File class (§9.6). 

■ To write data to a file using the PrintWriter class (§9.7.1). 

■ To read data from a file using the Scanner class (§9.7.2). 

■ (GUI) To open files using a dialog box (§9.8). 
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9.1 Introduction 

problem Often you encounter problems that involve string processing and file input and output. Sup- 

pose you need to write a program that replaces all occurrences of a word in a file with a new 
word. How do you accomplish this? This chapter introduces strings and text files, which will 
enable you to solve problems of this type. (Since no new concepts are introduced here, 
instructors may assign this chapter for students to study on their own.) 

9.2 The String Class 

A string is a sequence of characters. In many languages, strings are treated as an array of char- 
acters, but in Java a string is an object. The String class has 11 constructors and more than 
40 methods for manipulating strings. Not only is it very useful in programming, but also it is 
a good example for learning classes and objects. 

9.2.1 Constructing a String 

You can create a string object from a string literal or from an array of characters. To create a 
string from a string literal, use a syntax like this one: 

String newString = new String(stringLiteral) ; 

The argument stringLiteral is a sequence of characters enclosed inside double quotes. 
The following statement creates a String object message for the string literal "Welcome 
to Java": 

String message = new Stri ng("Wel come to Java"); 

string literal object Java treats a string literal as a Stri ng object. So, the following statement is valid: 

String message = "Welcome to Java"; 

You can also create a string from an array of characters. For example, the following state- 
ments create the string "Good Day": 

char[] char-Array = {'C , 'o' , 'o' , 'd', ' ', 'D' , 'a', 'y'}; 
String message = new Stri ng(charArray) ; 

fj| Note 

A String variable holds a reference to a String object that stores a string value. Strictly speak- 
ing, the terms String variable, String object, and string value are different, but most of the 
time the distinctions between them can be ignored. For simplicity, the term string will often be 
used to refer to String variable, String object, and string value. 

9.2.2 Immutable Strings and Interned Strings 

immutable A String object is immutable; its contents cannot be changed. Does the following code 

change the contents of the string? 

String s = "Java"; 
s = "HTML" ; 

The answer is no. The first statement creates a String object with the content "Java" and 
assigns its reference to s. The second statement creates a new String object with the con- 
tent "HTML" and assigns its reference to s. The first String object still exists after the 
assignment, but it can no longer be accessed, because variable s now points to the new 
object, as shown in Figure 9.1. 



string variable, string object, 
string value 
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After executing St ri ng s = "Java" 
s | > : String 



String object for "Java" 



After executing s 



Contents cannot be changed 



\ String o 



"HTML" ; 
: String 



object for "Java" 



This string object is 
now unreferenced 



String 

String object for "HTML' 



Figure 9.1 Strings are immutable; once created, their contents cannot be changed. 

Since strings are immutable and are ubiquitous in programming, the JVM uses a unique 
instance for string literals with the same character sequence in order to improve efficiency and 
save memory. Such an instance is called interned. For example, the following statements: 



interned string 



String si = "Welcome to Java"; 
String s2 = new Stri ng ("Wei come to Java"); 
String s3 = "Welcome to Java"; 

System. out. println("sl == s2 is " + (si == s2)); s2 , 
System. out. println("sl == s3 is " + (si == s3)); 



: String 



Interned string object for 
"Welcome to Java" 



: String 



A string object for 
"Welcome to Java" 



display 

si = 
si = 



s2 is false 
s3 is true 



In the preceding statements, si and s3 refer to the same interned string "Welcome to Java", 
therefore si == s3 is true. However, si == s2 is fal se, because si and s2 are two differ- 
ent string objects, even though they have the same contents. 

9.2.3 String Comparisons 

The String class provides the methods for comparing strings, as shown in Figure 9.2. 



java.lang.String 



+equals(sl: String): boolean 

+equal sIgnoreCase(sl: String): 
bool ean 

+compareTo(sl: String): int 



+compareToIgnoreCase(sl: String) : 
int 

+regionMatches(index: int, si: String, 
sllndex: int, len: int): boolean 

+regi onMatches (i gnoreCase : bool ean , 
index: int, si: String, sllndex: int, 
len: int): boolean 

+startsWith(prefix: String): boolean 

+endsWith(suffix: String): boolean 



Returns true if this string is equal to string si. 

Returns true if this string is equal to string si case 
insensitive. 

Returns an integer greater than 0, equal to 0, or less than 
to indicate whether this string is greater than, equal to, or 
less than si. 

Same as compareTo except that the comparison is case 
insensitive. 

Returns true if the specified subregion of this string exactly 
matches the specified subregion in string si. 

Same as the preceding method except that you can specify 
whether the match is case sensitive. 

Returns true if this string starts with the specified prefix. 
Returns true if this string ends with the specified suffix. 



Figure 9.2 The Stri ng class contains the methods for comparing strings. 
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How do you compare the contents of two strings? You might attempt to use the == opera- 
tor, as follows: 

if (stringl == string2) 

System. out. pri ntl n("stringl and string2 are the same object"); 
el se 

System. out. pri ntl n("stringl and string2 are different objects"); 

However, the == operator checks only whether stringl and string2 refer to the same 
object; it does not tell you whether they have the same contents. Therefore, you cannot use the 
== operator to find out whether two string variables have the same contents. Instead, you 
should use the equal s method. The code given below, for instance, can be used to compare 
two strings: 



System. out. pri ntl n("stringl and string2 have the same contents"); 
else 

System. out. println("stringl and string2 are not equal"); 

For example, the following statements display true and then fal se. 

String si = new Stri ng("Wel come to Java"); 

String s2 = "Welcome to Java"; 

String s3 = "Welcome to C++"; 

System. out. println(sl. equals(s2)) ; // true 

System. out. println(sl. equals(s3)) ; // false 

The compareTo method can also be used to compare two strings. For example, consider the 
following code: 



The method returns the value if si is equal to s2, a value less than if si is lexicographi- 
cally (i.e., in terms of Unicode ordering) less than s2, and a value greater than if si is lexi- 
cographically greater than s2. 

The actual value returned from the compareTo method depends on the offset of the first 
two distinct characters in si and s2 from left to right. For example, suppose si is "abc" and 
s2 is "abg", and si . compareTo (s 2) returns -4. The first two characters (a vs. a) from si 
and s2 are compared. Because they are equal, the second two characters (b vs. b) are com- 
pared. Because they are also equal, the third two characters (c vs. g) are compared. Since the 
character c is 4 less than g, the comparison returns -4. 

i|| Caution 

Syntax errors will occur if you compare strings by using comparison operators, such as >, >=, <, 
or <=. Instead, you have to use si . compareTo(s2) . 

§ Note 

The equals method returns true if two strings are equal and false if they are not. The 
compareTo method returns 0, a positive integer, or a negative integer, depending on whether 
one string is equal to, greater than, or less than the other string. 

The String class also provides equal slgnoreCase, compareToIgnoreCase, and 
regionMatches methods for comparing strings. The equal slgnoreCase and compare- 
ToIgnoreCase methods ignore the case of the letters when comparing two strings. The 
regionMatches method compares portions of two strings for equality. You can also use 
str.startsWith(prefix) to check whether string str starts with a specified prefix, and 
str.endsWith (suffix) to check whether string str ends with a specified suffix. 



stringl . equal s (stri ng2) 



if (stri ngl. equal s(stri ng2)) 



si . compareTo(s2) 



sl. compareTo (s2) 
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9.2.4 String Length, Characters, and Combining Strings 

The Stri ng class provides the methods for obtaining length, retrieving individual characters, 
and concatenating strings, as shown in Figure 9.3. 



java.lang.String 


+length(): int 




+charAt(i ndex : int): 


char 


+concat(sl: String): 


Stri ng 



Returns the number of characters in this string. 

Returns the character at the specified index from this string. 

Returns a new string that concatenates this string with string si. 



Figure 9.3 The String class contains the methods for getting string length, individual characters, and combining 
strings. 



You can get the length of a string by invoking its lengthO method. For example, lengthO 
message . 1 engthO returns the length of the string message. 

||| Caution 

length is a method in the String class but is a property of an array object. So you have to use lengthO 
s. lengthO to get the number of characters in string s, and a. length to get the number of 
elements in array a. 

The s.charAt (index) method can be used to retrieve a specific character in a string s, charAt (index) 
where the index is between and s . 1 ength()-l. For example, message. charAt (0) 

returns the character W, as shown in Figure 9.4. 
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message . charAt(O) message . 1 ength() is 15 message . charAt(14) 
Figure 9.4 A Stri ng object is represented using an array internally. 



§ Note 

When you use a string, you often know its literal value. For convenience, Java allows you to use 

the string literal to refer directly to strings without creating new variables. Thus, "Wei come to string literal 

Java" .charAt (0) is correct and returns W. 

§ Note 

A string value is represented using a private array variable internally. The array cannot be accessed 
outside of the String class. The String class provides many public methods, such as 
lengthO and charAt (index), to retrieve the array information. This is a good example of 

encapsulation: the data field of the class is hidden from the user through the private modifier, and encapsulating string 

thus the user cannot directly manipulate it. If the array were not private, the user would be able to 
change the string content by modifying the array. This would violate the tenet that the String 
class is immutable. 

|fi> Caution 

Attempting to access characters in a string s out of bounds is a common programming error. To string index range 

avoid it, make sure that you do not use an index beyond s. lengthO - 1- For example, 
s.charAt(s. lengthO) would cause a StringlndexOutOfBoundsException. 
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sl.concat(s2) 



si + s2 



You can use the concat method to concatenate two strings. The statement shown below, for 
example, concatenates strings si and s2 into s3: 

String s3 = si. concat(s2) ; 

Since string concatenation is heavily used in programming, Java provides a convenient way to 
accomplish it. You can use the plus (+) sign to concatenate two or more strings. So the above 
statement is equivalent to 

String s3 = si + s2; 

The following code combines the strings message, " and ", and "HTML" into one string: 

String myString = message + " and " + "HTML"; 

Recall that the + sign can also concatenate a number with a string. In this case, the number is 
converted into a string and then concatenated. Note that at least one of the operands must be a 
string in order for concatenation to take place. 

9.2.5 Obtaining Substrings 

You can obtain a single character from a string using the charAt method, as shown in Figure 
9.3. You can also obtain a substring from a string using the substring method in the 
String class, as shown in Figure 9.5. 



java.lang.String 



+substring(beginlndex: int): 
Stri ng 

+substring(beginlndex: int, 
endlndex: int): String 



Returns this string's substring that begins with the character at the 
specified begi nlndex and extends to the end of the string, as 
shown in Figure 9.6. 

Returns this string's substring that begins at the specified 
begi nlndex and extends to the character at index endlndex - 1, as 
shown in Figure 9.6. Note that the character at endlndex is not 
part of the substring. 



Figure 9.5 The String class contains the methods for obtaining substrings. 
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message. substring(0, 11) message . substri ng(ll) 
Figure 9.6 The substri ng method obtains a substring from a string. 

For example, 

String message = "Welcome to Dava". substri ng(0, 11) + "HTML"; 
The string message now becomes "Welcome to HTML". 



begi nlndex <= endlndex 



Note 

If beginlndex is endlndex, substring(beginlndex, endlndex) returns an empty 
string with length 0. If begi nlndex > endlndex, it would be a runtime error. 
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9.2.6 Converting, Replacing, and Splitting Strings 

The String class provides the methods for converting, replacing, and splitting strings, as 
shown in Figure 9.7. 



java.lang.String 



+toLowerCase() : String 

+toUpperCase() : String 

+trim(): String 

+replace(oldChar: char, 
newChar: char): String 

+replaceFi rst(ol dStri ng : String, 
newString: String): String 

+replaceAll (oldString: String, 
newString: String): String 

+split(delimiter: String): 
Stri ng [] 



Returns a new string with all characters converted to lowercase. 

Returns a new string with all characters converted to uppercase. 

Returns a new string with blank characters trimmed on both sides. 

Returns a new string that replaces all matching characters in this 
string with the new character. 

Returns a new string that replaces the first matching substring in 
this string with the new substring. 

Returns a new string that replaces all matching substrings in this 
string with the new substring. 

Returns an array of strings consisting of the substrings split by the 
delimiter. 



Figure 9.7 The String class contains the methods for converting, replacing, and splitting strings. 



Once a string is created, its contents cannot be changed. The methods toLowerCase, 
toUpperCase, trim, replace, replaceFirst, and replaceAll return a new string 
derived from the original string (without changing the original string!). The toLowerCase 
and toUpperCase methods return a new string by converting all the characters in the string 
to lowercase or uppercase. The trim method returns a new string by eliminating blank char- 
acters from both ends of the string. Several versions of the repl ace methods are provided to 
replace a character or a substring in the string with a new character or a new substring. 

For example, 

"Welcome" .toLowerCase () returns a new string, welcome. toLowerCaseO 
"Welcome" .toUpperCase returns a new string, WELCOME. toUpperCaseO 
11 Welcome ".trimO returns a new string, Welcome. trimO 
"Welcome" . replace( 'e ' , 'A') returns a new string, WAlcomA. replace 
"Welcome" . repl aceFi rst("e" , "AB") returns a new string, WABlcome. replaceFirst 
"Welcome" . repl ace("e" , "AB") returns a new string, WABlcomAB. replace 
"Welcome" . repl ace("el " , "AB") returns a new string, WABcome. replace 



The spl it method can be used to extract tokens from a string with the specified delimiters. 
For example, the following code 

String[] tokens = "Java#HTML#Perl " . spl i t("#" , 0); 
for (int i = 0; i < tokens . 1 ength ; i++) 
System. out. pri nt(tokens [i ] + " ") ; 

displays 

Java HTML Perl 



split 



9.2.7 Matching, Replacing and Splitting by Patterns 

You can match, replace, or split a string by specifying a pattern. This is an extremely useful 

and powerful feature, commonly known as regular expression. Regular expressions seem regular expression 

complex to beginning students. For this reason, two simple patterns are used in this section. 

Please refer to Supplement III.H, "Regular Expressions," for further studies. 
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matches (regex) Let us begin with the matches method in the Stri ng class. At first glance, the matches 

method is very similar to the equal s method. For example, the following two statements 
both evaluate to true. 

"Java". matches ("Java") ; 
"Java". equals ("Java") ; 



However, the matches method is more powerful. It can match not only a fixed string, but also 
a set of strings that follow a pattern. For example, the following statements all evaluate to 
true: 



"Java is fun" .matches(" Java. *" ) 
"Java is cool " . matches ("Java. *" ) 
"Java is powerful " .matches ("Java. *" ) 



"Java.-" in the preceding statements is a regular expression. It describes a string pattern 
that begins with Java followed by any zero or more characters. Here, the substring ■ * matches 
any zero or more characters. 

The replaceAll, replaceFi rst, and split methods can be used with a regular 
expression. For example, the following statement returns a new string that replaces $, +, or # 
in "a+b$#c" with the string NNN. 

replaceAll (regex) String s = "a+b$#c" . repl aceAl 1 ("[$+#]" , "NNN"); 

System. out. println(s) ; 

Here the regular expression [$+#] specifies a pattern that matches $, +, or #. So, the output is 
aNNNbNNNNNNc. 

The following statement splits the string into an array of strings delimited by punctuation 
marks. 

split(regex) String[] tokens = "Java, C?C#, C++". split("[. ,:;?]") ; 

for (int i = 0; i < tokens . 1 ength ; i++) 
System. out. pri ntl n(tokens [i ] ) ; 

Here the regular expression [.,:;?] specifies a pattern that matches . , , , : , ; , or ?. Each of 
these characters is a delimiter for splitting the string. So, the string is split into Java, C, C#, 
and C++, which are stored into array tokens. 



indexOf 



lastlndexOf 



9.2.8 Finding a Character or a Substring in a String 

The String class provides several overloaded indexOf and lastlndexOf methods to find 
a character or a substring in a string, as shown in Figure 9.8. 
For example, 



"Wei come 
"Wei come 
"Wei come 
"Wei come 
"Wei come 
"Wei come 

"Wei come 
"Wei come 
"Wei come 
"Wei come 
"Wei come 
"Wei come 



to Java' 
to Java' 
to Java' 
to Java' 
to Java' 
to Java' 

to Java' 
to Java' 
to Java' 
to Java' 
to Java' 
to Java' 



indexOf ('W') returns 0. 
indexOf('o') returns 4. 
index0f('o', 5) returns 9. 
i ndexOf ("come") returns 3. 
indexOf ("Java", 5) returns 11. 
i ndexOf (" java" , 5) returns -1. 

lastlndexOf ('W') returns 0. 
1 astlndexOf ( ' o ' ) returns 9. 
lastlndexOf ('o' , 5) returns 4. 
1 astlndexOf ("come") returns 3. 
lastlndexOf ("Java" , 5) returns -1. 
lastlndexOf ("Java") returns 11. 
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I 



java.lang.String 



+i ndexOf (ch : char): int 

+i ndexOf (ch : char, fromlndex: 
int): int 

+i ndexOf (s: String): int 

+indexOf(s: String, fromlndex: 
int): int 

+lastlndex0f (ch: int): int 

+1 astlndexOf (ch : int, 
fromlndex: int): int 

+1 astlndexOf (s : String): int 

+1 astlndexOf (s: String, 
fromlndex: int): int 



Returns the index of the first occurrence of ch in the string. 

Returns -1 if not matched. 
Returns the index of the first occurrence of ch after fromlndex in 

the string. Returns -1 if not matched. 

Returns the index of the first occurrence of string s in this string. 
Returns -1 if not matched. 

Returns the index of the first occurrence of string s in this string 
after fromlndex. Returns -1 if not matched. 

Returns the index of the last occurrence of ch in the string. 
Returns - 1 if not matched. 

Returns the index of the last occurrence of ch before fromlndex 
in this string. Returns -1 if not matched. 

Returns the index of the last occurrence of string s. Returns -1 if 
not matched. 

Returns the index of the last occurrence of string s before 
fromlndex. Returns -1 if not matched. 



Figure 9.8 The String class contains the methods for matching substrings. 



9.2.9 Conversion between Strings and Arrays 

Strings are not arrays, but a string can be converted into an array, and vice versa. To convert a 
string to an array of characters, use the toCharArray method. For example, the following 
statement converts the string "Java" to an array. 

char[] chars = "Java" . toCharArray () ; toCharArray 

So chars [0] is ' J ' , chars [1] is ' a ' , chars [2] is ' v ' , and chars [3] is ' a ' . 

You can also use the getChars (i nt srcBegin, intsrcEnd, char[] dst, int dst- 
Begin) method to copy a substring of the string from index srcBegin to index srcEnd-1 
into a character array dst starting from index dstBegin. For example, the following code 
copies a substring "3720" in "CS3720" from index 2 to index 6-1 into the character array 
dst starting from index 4. 

char[] dst={'J", 'A', 'V, 'A', '1', '3', '0', '1'}; getChars 
"CS3720". getChars (2, 6, dst, 4); 

Thus dst becomes {' J ' , 'A', 'V, 'A', '3', '7', '2', '0'}. 

To convert an array of characters into a string, use the String (char []) constructor or 
the valueOf (char[]) method. For example, the following statement constructs a string 
from an array using the String constructor. 

String str = new String(new char[]{'J', 'a', 'v' , 'a'}); 

The next statement constructs a string from an array using the val ueOf method. 

String str = String. val ueOf (new char[]{'J', 'a', 'v', 'a'}); valueOf 



9.2. 1 Converting Characters and Numeric Values to Strings 

The static val ueOf method can be used to convert an array of characters into a string. There overloaded val ueOf 
are several overloaded versions of the val ueOf method that can be used to convert a charac- 
ter and numeric values to strings with different parameter types, char, double, long, int, 
and float, as shown in Figure 9.9. 
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java.lang.String 



+val ueOf (c : 


char): String 


+val ueOf (data: char[]): String 


+val ueOf (d : 


double): String 


+val ueOf (f : 


float): String 


+val ueOf (i : 


int): String 


+val ueOf (1 : 


long): String 


+valueOf (b: 


boolean) : String 





Returns a string consisting of the character c. 
Returns a string consisting of the characters in the array. 
Returns a string representing the doubl e value. 
Returns a string representing the f 1 oat value. 
Returns a string representing the i nt value. 
Returns a string representing the 1 ong value. 
Returns a string representing the bool ean value. 



Figure 9.9 The String class contains the static methods for creating strings from primi- 
tive type values. 



For example, to convert a doubl e value 5 . 44 to a string, use Stri ng . val ueOf (5 . 44) . 
The return value is a string consisting of the characters 1 5 ' , ' . ' , ' 4 ' , and ' 4 ' . 

§ Note 

Use Doubl e.parseDouble(str) or Integer .parselnt(str) to convert a string to a 
doubl e value or an int value. 



9.2.1 1 Formatting Strings 

The String class contains the static format method in the String class to create a format- 
ted string. The syntax to invoke this method is 

St ring, format (format, iteml, item2, item/c) 

This method is similar to the printf method except that the format method returns a for- 
matted string, whereas the printf method displays a formatted string. For example, 

String s = Stri ng . format("%5 . 2f " , 45.556); 

creates a formatted string "45 . 56". 



9.2.12 Problem: Checking Palindromes 

A string is a palindrome if it reads the same forward and backward. The words "mom," "dad," 

and "noon," for instance, are all palindromes. 
Video Note . . , 

Check palindrome problem is to write a program that prompts the user to enter a string and reports 

whether the string is a palindrome. One solution is to check whether the first character in the 

string is the same as the last character. If so, check whether the second character is the same 

as the second-to-last character. This process continues until a mismatch is found or all the 

characters in the string are checked, except for the middle character if the string has an odd 

number of characters. 

To implement this idea, use two variables, say 1 ow and high, to denote the position of two 
characters at the beginning and the end in a string s, as shown in Listing 9.1 (lines 22, 25). Ini- 
tially, low is and high is s.lengthO - 1. If the two characters at these positions match, 
increment low by 1 and decrement high by 1 (lines 31-32). This process continues until 
(low >= high) or a mismatch is found. 

Listing 9.1 CheckPalindrome. java 

1 import java. util .Scanner; 
2 

3 public class CheckPalindrome { 

4 /** Main method */ 
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5 public static void main(String[] args) { 

6 // Create a Scanner 

7 Scanner input = new Scanner(System.in) ; 
8 

9 // Prompt the user to enter a string 

10 System . out . pri nt("Enter a string: ") ; 

11 String s = input. nextLineO ; input string 
12 

13 if (isPalindrome(s)) 

14 System. out . pri ntl n(s + " is a palindrome"); 

15 else 

16 System. out . pri ntl n(s + " is not a palindrome"); 

17 } 
18 

19 /** Check if a string is a palindrome */ 

20 public static boolean i sPal i ndrome(Stri ng s) { 

21 // The index of the first character in the string 

22 int low = 0; low index 
23 

24 // The index of the last character in the string 

2 5 int high = s.lengthO - 1; high index 

26 

27 while (low < high) { 

28 if (s.charAt(low) != s . charAt (hi gh) ) 

29 return false; // Not a palindrome 
30 

31 1 0W++ ; update indices 

32 high--; 

33 } 
34 

35 return true; // The string is a palindrome 

36 } 



37 } 



Enter a string: noon |^ enter 

noon is a palindrome 

Enter a string: moon |^ enter 

moon is not a palindrome 



The nextLi ne() method in the Scanner class (line 1 1) reads a line into s. i sPal i ndrome(s) 

checks whether s is a palindrome (line 13). 

9.2.13 Problem: Converting Hexadecimals to Decimals 

Section 5.7 gives a program that converts a decimal to a hexadecimal. This section presents a 
program that converts a hex number into a decimal. 

Given a hexadecimal number h n h n -\h n -2 ■ ■ ■ hjh\hQ, the equivalent decimal value is 

h„ X 16" + h n - x X 16"" 1 + h n - 2 X 16"~ 2 + ... + h 2 X 16 2 + h x X 16 1 + h X 16° 

For example, the hex number AB8C is 

10 X 16 3 + 11 X 16 2 + 8 X 16 1 + 12 X 16° = 43916 

Our program will prompt the user to enter a hex number as a string and convert it into a deci- 
mal using the following method: 

public static int hexToDeci mal (Stri ng hex) 
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A brute-force approach is to convert each hex character into a decimal number, multiply it by 
16' for a hex digit at the i 's position, and add all the items together to obtain the equivalent 
decimal value for the hex number. 
Note that 

h„ X 16" + h n - x X 16"" 1 + h n -2 X 16"~ 2 + ... + hi X 16 1 + h X 16° 

= ( . . . {{h n X 16 + h n -i) X 16 + h n - 2 ) X 16 + ... + hi) X 16 + h 

This observation leads to the following efficient algorithm for converting a hex string to a dec- 
imal number: 

int decimal Value = 0; 

for (int i =0; i < hex.lengthO ; i++) { 
char hexChar = hex . charAt(i ) ; 

decimal Value = decimalValue * 16 + hexCharToDecimal (hexChar) ; 

} 

Here is a trace of the algorithm for hex number AB8C: 





i 


hexChar 


hexCharToDecimal(hexChar) 


decimalValue 


before the loop 











after the 1st iteration 
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10 


after the 2nd iteration 


1 


B 
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10* 16+ 11 


after the 3rd iteration 


2 
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8 


(10* 16+ 11)* 16 + 8 


after the 4th iteration 
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C 


12 


((10* 16+ 11) * 16 + 8) * 16+ 12 



input string 



hex to decimal 



Listing 9.2 gives the complete program. 

Listing 9.2 HexToDeci mal Conve rsi on . j ava 



1 

2 
3 
4 
5 
6 
7 
8 
9 
10 
11 
12 
13 
14 
15 
16 
17 
18 
19 
20 
21 
22 
23 



import java.util .Scanner; 

public class HexToDeci mal Conversion { 

/** Main method */ 

public static void main(String[] args) { 

// Create a Scanner 

Scanner input = new Scanner(System.in) ; 

// Prompt the user to enter a string 
System . out . pri nt("Enter a hex number: ") ; 
String hex = i nput . nextLi ne() ; 

System. out. pri ntln ("The decimal value for hex number " 
+ hex + " is " + hexToDecimal (hex.toUpperCaseO) ) ; 

} 

public static int hexToDecimal (Stri ng hex) { 
int decimalValue = 0; 

for (int i = 0; i < hex.lengthO; { 
char hexChar = hex . charAt(i ) ; 

decimalValue = decimalValue * 16 + hexCharToDecimal (hexChar) ; 

} 



9.3 The Character Class 313 



24 return decimal Val ue ; 

25 } 
26 

27 public static int hexCharToDeci mal (char ch) { hex char to decimal 

28 if (ch >= 'A' && ch <= 'F') 

29 return 10 + ch - 'A' ; 

30 else // ch is '0' , '1' , . . . , or '9' 

31 return ch - '0' ; 

32 } 

33 } 



Enter a hex number: AB8C h 

The decimal value for hex number AB8C is 43916 



Enter a hex number: af71 |^ Enter 

The decimal value for hex number af71 is 44913 



The program reads a string from the console (line 11), and invokes the hexToDecimal 
method to convert a hex string to decimal number (line 14). The characters can be in either 
lowercase or uppercase. They are converted to uppercase before invoking the hexToDecimal 
method (line 14). 

The hexToDecimal method is defined in lines 17-25 to return an integer. The length of 
the string is determined by invoking hex. length () in line 19. 

The hexCharToDeci mal method is defined in lines 27-32 to return a decimal value for a 
hex character. The character can be in either lowercase or uppercase. Recall that to subtract 
two characters is to subtract their Unicodes. For example, ' 5 ' - ' ' is 5. 



9.3 The Character Class 

Java provides a wrapper class for every primitive data type. These classes are Character, 
Boolean, Byte, Short, Integer, Long, Float, and Double for char, boolean, byte, 
short, int, long, float, and double. All these classes are in the java.lang package. 
They enable the primitive data values to be treated as objects. They also contain useful meth- 
ods for processing primitive values. This section introduces the Character class. The other 
wrapper classes will be introduced in Chapter 14, "Abstract Classes and Interfaces." 

The Character class has a constructor and several methods for determining a character's 
category (uppercase, lowercase, digit, and so on) and for converting characters from upper- 
case to lowercase, and vice versa, as shown in Figure 9.10. 

You can create a Character object from a char value. For example, the following state- 
ment creates a Character object for the character ' a ' . 

Character character = new Character('a') ; 

The charVal ue method returns the character value wrapped in the Character object. The 
compareTo method compares this character with another character and returns an integer 
that is the difference between the Unicodes of this character and the other character. The 
equal s method returns true if and only if the two characters are the same. For example, 
suppose charObject is new Character C'b'): 

charObject . compareTo(new Character('a')) returns 1 

charObject . compareTo(new Character( ' b ' )) returns 

charObject . compareTo(new Character( ' c 1 )) returns -1 

charObject . compareTo(new Character( ' d ' )) returns -2 
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java.lang.Character 

+Character(val ue : char) 
+charVal ue() : char 

+compareTo(anotherCharacter: Character): int 
+equals(anotherCharacter: Character): boolean 
+ isDigit(ch: char): boolean 
+ i sLetter(ch : char): boolean 
+ isLetterOrDigit(ch: char): boolean 
+ i sLowerCase(ch : char): boolean 
+ i sUpperCase(ch : char): boolean 
+ toLowerCase(ch : char): char 
+ toUpperCase(ch : char): char 



Figure 9.1 The Character class provides the methods for manipulating a character. 

charObject.equals(new Character('b')) returns true 
charObject.equals(new Character('d')) returns false 

Most of the methods in the Character class are static methods. The isDi git (char ch) 
method returns true if the character is a digit. The isLetter(char ch) method returns true 
if the character is a letter. The isLetterOrDi git (char ch) method returns true if the char- 
acter is a letter or a digit. The i sLowerCase(char ch) method returns true if the character is 
a lowercase letter. The isUpperCase(char ch) method returns true if the character is an 
uppercase letter. The toLowerCase(char ch) method returns the lowercase letter for the char- 
acter, and the toUpperCase(char ch) method returns the uppercase letter for the character. 

9.3.1 Problem: Counting Each Letter in a String 

The problem is to write a program that prompts the user to enter a string and counts the num- 
ber of occurrences of each letter in the string regardless of case. 
Here are the steps to solve this problem: 

1. Convert all the uppercase letters in the string to lowercase using the toLowerCase 
method in the String class. 

2. Create an array, say counts of 26 int values, each of which counts the occurrences of 
a letter. That is, counts [0] counts the number of a's, counts [1] counts the number 
of b's, and so on. 

3. For each character in the string, check whether it is a (lowercase) letter. If so, increment 
the corresponding count in the array. 

Listing 9.3 gives the complete program: 

Listing 9.3 CountEachLetter . java 

1 import java. util .Scanner; 
2 

3 public class CountEachLetter { 

4 /** Main method */ 

5 public static void main(String[] args) { 

6 // Create a Scanner 

7 Scanner input = new Scanner(System.in) ; 



Constructs a character object with char value. 
Returns the char value from this object. 
Compares this character with another. 
Returns true if this character is equal to another. 
Returns true if the specified character is a digit. 
Returns true if the specified character is a letter. 
Returns true if the character is a letter or a digit. 
Returns true if the character is a lowercase letter. 
Returns true if the character is an uppercase letter. 
Returns the lowercase of the specified character. 
Returns the uppercase of the specified character. 
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8 

9 // Prompt the user to enter a string 

10 System . out . pri nt("Enter a string: ") ; 

11 String s = input. nextLineO ; input string 
12 

13 // Invoke the countLetters method to count each letter 

14 int[] counts = countLetters(s.toLowerCaseO) ; count letters 
15 

16 // Display results 

17 for (int i = 0; i < counts . 1 ength ; i++) { 

18 if (counts [i] != 0) 

19 System . out . pri ntl n((char) (' a ' + i) + " appears " + 

20 counts[i] + ((counts[i] == 1) ? " time" : " times")); 

21 } 

22 } 
23 

24 /** Count each letter in the string */ 

25 public static int[] countLetters(Stri ng s) { 

26 int[] counts = new int[26] ; 
27 

28 for (int i = 0; i < s.length() ; i++) { 

29 if (Character. i sLetter(s . charAt(i )) ) 

30 counts [s . charAt(i ) - 'a']++; count a letter 

31 } 
32 

33 return counts; 

34 } 

35 } 



Enter a string: abababx 
a appears 3 times 
b appears 3 times 
x appears 1 time 



The main method reads a line (line 11) and counts the number of occurrences of each letter in 
the string by invoking the countLetters method (line 14). Since the case of the letters is 
ignored, the program uses the toLowerCase method to convert the string into all lowercase 
and pass the new string to the countLetters method. 

The countLetters method (lines 25-34) returns an array of 26 elements. Each element 
counts the number of occurrences of a letter in the string s. The method processes each char- 
acter in the string. If the character is a letter, its corresponding count is increased by 1. For 
example, if the character (s.charAr(i)) is 'a', the corresponding count is counts ['a' - 
'a'] (i.e., counts [0]). If the character is 'b', the corresponding count is counts['b' - 
' a ' ] (i.e., counts [1] ), since the Unicode of ' b ' is 1 more than that of ' a ' . If the character 
is 'z', the corresponding count is counts ['z' - 'a'] (i.e., counts [2 5]), since the Uni- 
code of ' z ' is 2 5 more than that of 1 a ' . 

9.4 The StringBuilder/StringBuffer Class 

The StringBuilder/StringBuffer class is an alternative to the String class. In general, 
a StringBuilder/StringBuffer can be used wherever a string is used. 
StringBuilder/StringBuffer is more flexible than String. You can add, insert, or 
append new contents into a StringBuilder or a StringBuffer, whereas the value of a 
String object is fixed, once the string is created. 
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Strings and Text I/O 



StringBuilder 



StringBuil der 

constructors 



The StringBuilder class is similar to StringBuf fer except that the methods for mod- 
ifying buffer in StringBuf fer are synchronized. Use StringBuf fer if it may be accessed 
by multiple tasks concurrently. Using StringBuilder is more efficient if it is accessed by a 
single task. The constructors and methods in StringBuffer and StringBuilder are 
almost the same. This section covers StringBuilder. You may replace StringBuilder 
by StringBuffer. The program can compile and run without any other changes. 

The StringBuilder class has three constructors and more than 30 methods for manag- 
ing the builder and modifying strings in the builder. You can create an empty string builder or 
a string builder from a string using the constructors, as shown in Figure 9.1 1. 



java.lang.StringBuilder 



+StringBuilder() 
+StringBuilder(capacity: int) 
+StringBuilder(s: String) 



Constructs an empty string builder with capacity 16. 
Constructs a string builder with the specified capacity. 
Constructs a string builder with the specified string. 



Figure 9.1 1 The StringBuilder class contains the constructors for creating instances of 
StringBuilder. 

9.4-1 Modifying Strings in the StringBuilder 

You can append new contents at the end of a string builder, insert new contents at a specified 
position in a string builder, and delete or replace characters in a string builder, using the meth- 
ods listed in Figure 9.12: 



java.lang.StringBuilder 



+append(data: char[]): StringBuilder 

+append(data: char[], offset: int, len: int): 
StringBuilder 

+append(v: aPrimitiveType) : StringBuilder 

+append(s: String): StringBuilder 

+delete(startlndex: int, endlndex: int): 
StringBuilder 

+deleteCharAt (index: int): StringBuilder 

+insert(index: int, data: char[], offset: int, 
len: int): StringBuilder 

+i nsert(offset : int, data: char[]): 
StringBuilder 

+i nsert(offset : int, b: aPrimitiveType'): 
StringBuilder 

+i nsert(offset : int, s: 

+replace(startlndex: 
String): StringBuilder 

+ reverse(): StringBuilder 

+setCharAt(index: int, ch: char): void 



String): StringBuilder 
int, endlndex: int, s: 



Appends a char array into this string builder. 
Appends a subarray in data into this string builder. 

Appends a primitive type value as a string to this 
builder. 

Appends a string to this string builder. 

Deletes characters from startlndex to endlndex-l. 

Deletes a character at the specified index. 

Inserts a subarray of the data in the array to the builder 

at the specified index. 
Inserts data into this builder at the position offset. 

Inserts a value converted to a string into this builder. 

Inserts a string into this builder at the position offset. 

Replaces the characters in this builder from startlndex 
to endlndex-l with the specified string. 

Reverses the characters in the builder. 

Sets a new character at the specified index in this 
builder. 



Figure 9.12 The StringBuilder class contains the methods for modifying string builders. 

The StringBuilder class provides several overloaded methods to append boolean, 
char, char array, doubl e, f 1 oat, i nt, 1 ong, and Stri ng into a string builder. For exam- 
ple, the following code appends strings and characters into StringBuilder to form a new 
string, "Welcome to Java". 



StringBuilder StringBuilder = new Stri ngBui 1 der() ; 
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st ri ngBuil der. append ("Welcome") ; append 
stringBuilder.appendC '); 
stringBuilder.append("to") ; 
stringBuilder.appendC '); 
stri ngBui 1 der . append ("Java") ; 

The Stri ngBuil der class also contains overloaded methods to insert boolean, char, 
char array, double, float, int, long, and String into a string builder. Consider the 
following code: 

stri ngBui 1 der . i nsert(ll , "HTML and ") ; insert 

Suppose stri ngBuil der contains "Welcome to Java" before the insert method is 
applied. This code inserts "HTML and " at position 11 in stringBuil der (just before J). 
The new stringBuilder is "Welcome to HTML and Java". 

You can also delete characters from a string in the builder using the two del ete methods, 
reverse the string using the reverse method, replace characters using the replace method, 
or set a new character in a string using the setCharAt method. 

For example, suppose stringBuilder contains "Welcome to Java" before each of the 
following methods is applied. 

stringBuilder. delete(8, 11) changes the builder to Wei come Java. 
stringBuilder .del eteCharAt (8) changes the builder to Welcome o Java. 
stringBuilder . reverseC) changes the builder to avaJ ot emocleW. 
stringBuilder . replace(ll, 15, "HTML") changes the builder to Welcome to HTML 
stringBuilder. setCharAt(0, 'w') sets the builder to wel come to Java. 

All these modification methods except setCharAt do two things: 

1 . Change the contents of the string builder 

2. Return the reference of the string builder 
For example, the following statement 

StringBuilder stri ngBui 1 derl = stringBuilder. reverse() ; 

reverses the string in the builder and assigns the reference of the builder to stringBuil derl. 
Thus, stringBuilder and stringBuilderl both point to the same StringBuilder 

object. Recall that a value-returning method may be invoked as a statement, if you are not inter- 
ested in the return value of the method. In this case, the return value is simply ignored. For ignore return value 
example, in the following statement 

stri ngBui 1 der . reverse () ; 

the return value is ignored. 

Tip 

If a string does not require any change, use String rather than StringBuilder. Java can per- String or StringBuilder? 

form some optimizations for String, such as sharing interned strings. 

9.4-2 The toString, capacity, length, setLength, and 
charAt Methods 

The StringBuil der class provides the additional methods for manipulating a string builder 
and obtaining its properties, as shown in Figure 9.13. 



delete 

del eteCharAt 
reverse 
replace 
setCharAt 
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java.lang.StringBuilder 



+toString(): String 




+capacity(): int 




+charAt(index: int): char 




+lengthO- int 




+setl_ength (newLength: int): 


void 


+substri ng(startlndex : int) 


Stri ng 


+substring(startlndex: int, 


endlndex: int): 


Stri ng 




+trimToSize() : void 





Returns a string object from the string builder. 

Returns the capacity of this string builder. 

Returns the character at the specified index. 

Returns the number of characters in this builder. 

Sets a new length in this builder. 

Returns a substring starting at startlndex. 

Returns a substring from startlndex to endlndex-l. 

Reduces the storage size used for the string builder. 



Figure 9. 1 3 The Stri ngBui 1 der class contains the methods for modifying string builders. 



capacity () 

lengthO 
setLength(int) 



charAt(int) 



The capaci ty O method returns the current capacity of the string builder. The capacity is 
the number of characters it is able to store without having to increase its size. 

The length () method returns the number of characters actually stored in the string 
builder. The set Length (newLength) method sets the length of the string builder. If the 
newLength argument is less than the current length of the string builder, the string builder is 
truncated to contain exactly the number of characters given by the newLength argument. If 
the newLength argument is greater than or equal to the current length, sufficient null charac- 
ters ( ' \u0000 ' ) are appended to the string builder so that 1 ength becomes the newLength 
argument. The newLength argument must be greater than or equal to 0. 

The charAt (index) method returns the character at a specific index in the string 
builder. The index is based. The first character of a string builder is at index 0, the next at 
index 1, and so on. The i ndex argument must be greater than or equal to 0, and less than the 
length of the string builder. 



length and capacity 



Note 

The length of the string is always less than or equal to the capacity of the builder. The length is 
the actual size of the string stored in the builder, and the capacity is the current size of the 
builder. The builder's capacity is automatically increased if more characters are added to exceed 
its capacity. Internally, a string builder is an array of characters, so the builder's capacity is the size 
of the array. If the builder's capacity is exceeded, the array is replaced by a new array. The new 
array size is 2 * (the previous array size + 1). 



initial capacity 



trimToSizeO 



Tip 

You can use new StringBuilder(initialCapacity) to create a StringBuilder with 
a specified initial capacity. By carefully choosing the initial capacity, you can make your program 
more efficient. If the capacity is always larger than the actual length of the builder, the JVM will 
never need to reallocate memory for the builder. On the other hand, if the capacity is too large, 
you will waste memory space. You can use the trimToSizeO method to reduce the capacity 
to the actual size. 



9.4-3 Problem: Ignoring Nonalphanumeric Characters 
When Checking Palindromes 

Listing 9.1, CheckPalindrome.java, considered all the characters in a string to check whether 
it was a palindrome. Write a new program that ignores nonalphanumeric characters in check- 
ing whether a string is a palindrome. 
Here are the steps to solve the problem: 

1. Filter the string by removing the nonalphanumeric characters. This can be done by 
creating an empty string builder, adding each alphanumeric character in the string to 
a string builder, and returning the string from the string builder. You can use the 
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isLetterOrDigit(ch) method in the Character class to check whether charac- 
ter ch is a letter or a digit. 

2. Obtain a new string that is the reversal of the filtered string. Compare the reversed string 
with the filtered string using the equal s method. 

The complete program is shown in Listing 9.4. 

Listing 9.4 Pal i ndromelgnoreNonAl phanumeri c . java 

1 import java. util .Scanner; 
2 

3 public class Pal i ndromelgnoreNonAl phanumeri c { 

4 /** Main method */ 

5 public static void main(String[] args) { 

6 // Create a Scanner 

7 Scanner input = new Scanner(System.in) ; 
8 

9 // Prompt the user to enter a string 

10 System . out . pri nt("Enter a string: ") ; 

11 String s = input. nextLineO ; 
12 

13 // Display result 

14 System. out. pri ntl n("Ignoring nonal phanumeri c characters, \nis " 

15 + s + " a palindrome? " + i sPal i ndrome(s)) ; 

16 } 
17 

18 /** Return true if a string is a palindrome */ 

19 public static boolean i sPal i ndrome(Stri ng s) { check palindrome 

20 // Create a new string by eliminating nonal phanumeri c chars 

21 String si = filter(s); 
22 

23 // Create a new string that is the reversal of si 

24 String s2 = reverse(sl); 
25 

26 // Compare if the reversal is the same as the original string 

27 return s2 . equal s(sl) ; 

28 } 
29 

30 /** Create a new string by eliminating nonal phanumeri c chars */ 

31 public static String f i 1 ter(Stri ng s) { 

32 // Create a string builder 

33 Stri ngBui 1 der stringBuilder = new Stri ngBui 1 der() ; 
34 

35 // Examine each char in the string to skip alphanumeric char 

36 for (int i = 0; i < s.lengthO; i++) { 

37 if (Character. isLetterOrDigit(s.charAt(i))) { 

38 stringBuilder. append(s. charAt(i)) ; add letter or digit 

39 } 

40 } 
41 

42 // Return a new filtered string 

43 return stringBuilder. toStringO ; 

44 } 
45 

46 /** Create a new string by reversing a specified string */ 

47 public static String reverse(Stri ng s) { 

48 StringBuilder stringBuilder = new StringBuilder(s) ; 

49 stringBuilder. reverse() ; // Invoke reverse in StringBuilder 

50 return stringBuilder. toStringO ; 

51 } 

52 } 
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Enter a string: ab<c>cb?a -^nter 
Ignoring nonal phanumeri c characters, 
is ab<c>cb?a a palindrome? true 

Enter a string: abccx?cab |H Enter 
Ignoring nonal phanumeri c characters, 
is abccx?cab a palindrome? false 



The f il ter(String s) method (lines 31-44) examines each character in string s and 
copies it to a string builder if the character is a letter or a numeric character. The filter 
method returns the string in the builder. The reverse(Stri ng s) method (lines 47-52) cre- 
ates a new string that reverses the specified string s. The f il ter and reverse methods both 
return a new string. The original string is not changed. 

The program in Listing 9. 1 checks whether a string is a palindrome by comparing pairs of 
characters from both ends of the string. Listing 9.4 uses the reverse method in the 
StringBuilder class to reverse the string, then compares whether the two strings are equal 
to determine whether the original string is a palindrome. 

9.5 Command-Line Arguments 

Perhaps you have already noticed the unusual declarations for the main method, which has 
parameter args of String [] type. It is clear that args is an array of strings. The main 
method is just like a regular method with a parameter. You can call a regular method by pass- 
ing actual parameters. Can you pass arguments to mai n? Yes, of course you can. For example, 
the mai n method in class TestMai n is invoked by a method in A, as shown below: 



public class A { public class TestMai n { 

public static void main(String[] args) { public static void mai n(Stri ng [] args) { 
String[] strings = {"New York", for (int i = 0; i < args. length; i++) 

"Boston", "Atlanta"}; System. out. println(args[i]) ; 

TestMai n .mai n(stri ngs) ; } 
} } 

} 



A main method is just a regular method. Furthermore, you can pass arguments from the com- 
mand line. 




9.5.1 Passing Strings to the main Method 

You can pass strings to a main method from the command line when you run the program. 
The following command line, for example, starts the program TestMai n with three strings: 
argO, argl, and arg2: 

java TestMai n argO argl arg2 

argO, argl, and arg2 are strings, but they don't have to appear in double quotes on the com- 
mand line. The strings are separated by a space. A string that contains a space must be 
enclosed in double quotes. Consider the following command line: 

java TestMain "First num" alpha 53 

It starts the program with three strings: "First num", alpha, and 53, a numeric string. 
Since "Fi rst num" is a string, it is enclosed in double quotes. Note that 53 is actually treated 
as a string. You can use "53" instead of 53 in the command line. 
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When the main method is invoked, the Java interpreter creates an array to hold the com- 
mand-line arguments and pass the array reference to args. For example, if you invoke a pro- 
gram with n arguments, the Java interpreter creates an array like this one: 

args = new String[n]; 

The Java interpreter then passes args to invoke the man n method. 

fH Note 

[f you run the program with no strings passed, the array is created with new String[0]. In this 
case, the array is empty with length 0. args references to this empty array. Therefore, args is 
not nul 1 , but args . 1 ength is 0. 



9.5.2 Problem: Calculator 

Suppose you are to develop a program that performs arithmetic operations on integers. The 
program receives three arguments: an integer followed by an operator and another integer. For 
example, to add two integers, use this command: 

java Calculator 2+3 

The program will display the following output: 
2 + 3 = 5 

Figure 9.14 shows sample runs of the program. 



Video Note 

Command-line argument 





tv Command Prompt 


^lB|x| 




c :Sbook>jaua Calculator 

Usage: java Calculator operandi operator 


ope ran A2 


A 

_i 


Add > 


c:Shook>jaua Calculator 63+40 
S3 » 46 - 183 






Subtract *- 


c:VhooIt>jaua Calculator £3 — 40 
63 - 40 = 23 






Multiply >- 


c:Shook>jaua Calculator 63 40 
53 * 46 = 2520 






Divide >■ 


c:Sbook>jaua Calculator 63/40 
63 / 46 = 1 




zi 




<l 1 







Figure 9.14 The program takes three arguments (operandi operator operand2) from the 
command line and displays the expression and the result of the arithmetic operation. 



The strings passed to the main program are stored in args, which is an array of strings. 
The first string is stored in args [0] , and args . 1 ength is the number of strings passed. 
Here are the steps in the program: 

■ Use args. length to determine whether three arguments have been provided in the 
command line. If not, terminate the program using System . exi t (0) . 

■ Perform a binary arithmetic operation on the operands args[0] and args [2] using 
the operator specified in args [1] . 

The program is shown in Listing 9.5. 

Listing 9.5 Cal culator. java 

1 public class Calculator { 

2 /** Main method */ 

3 public static void main(String[] args) { 
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check operator 



4 // Check number of strings passed 

5 if (args. length != 3) { 

6 System. out . pri ntl n( 

7 "Usage: java Calculator operandi operator operand2") ; 



8 


System. exit(0) ; 






9 


} 






10 








11 


// The result of the 


operation 


12 


int result = 0; 






13 








14 


// Determine the operator 




15 


switch (args[l] .charAt(O) ) { 




16 


case '+' : result = 


Integer . 


parselnt(args [0] ) + 


17 
18 


break; 


Integer . 


parselnt (args [2] ) ; 


19 


case ' - 1 : result = 


Integer . 


parselnt (args [0] ) - 


20 
21 


break; 


Integer . 


parselnt (args [2] ) ; 


22 


case ' *' : result = 


Integer . 


parselnt(args [0] ) * 


23 




Integer . 


parselnt(args [2] ) ; 


24 


break; 






25 


case '/' : result = 


Integer . 


parselnt(args [0] ) / 


26 
27 
28 


} 


Integer . 


parselnt(args [2] ) ; 


29 


// Display result 






30 


System . out . pri ntl n (args [0] + 


' ' + args[l] + ' ' 


31 


+ " = " + result) ; 






32 


} 






33 } 









+ args[2] 



Integer . parselnt (args [0]) (line 16) converts a digital string into an integer. The string 
must consist of digits. If not, the program will terminate abnormally. 



special * character 



Note 

In the sample run, "*" had to be used instead of * for the command 
java Calculator 63 "*" 40 

The "-• symbol refers to all the files in the current directory when it is used on a command line. 
Therefore, in order to specify the multiplication operator, the * must be enclosed in quote marks 
in the command line. The following program displays all the files in the current directory when 
issuing the command java Test *: 

public class Test { 

public static void main(String[] args) { 
for (int i = 0; i < args. length; i++) 
System. out. println(args[i]) ; 

} 

} 



9.6 The File Class 

Data stored in variables, arrays, and objects are temporary; they are lost when the program 
terminates. To permanently store the data created in a program, you need to save them in a file 
on a disk or a CD. The file can be transported and can be read later by other programs. Since 
why file? data are stored in files, this section introduces how to use the Fil e class to obtain file proper- 

ties and to delete and rename files. The next section introduces how to read/write data from/to 
text files. 
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Every file is placed in a directory in the file system. An absolute file name contains a file absolute file name 
name with its complete path and drive letter. For example, c:\book\Welcome.java is the 
absolute file name for the file Welcome.java on the Windows operating system. Here c:\book 
is referred to as the directory path for the file. Absolute file names are machine dependent. On directory path 
the Unix platform, the absolute file name may be /home/liang/book/Welcome.java, where 
/home/liang/book is the directory path for the file Welcome.java. 

The File class is intended to provide an abstraction that deals with most of the machine- 
dependent complexities of files and path names in a machine-independent fashion. The Fil e 
class contains the methods for obtaining file properties and for renaming and deleting files, as 
shown in Figure 9.15. However, the File class does not contain the methods for reading and 
writing file contents. 



_ 



java.io.File 



+File (pathname: String) 

+File (parent: String, child: String) 

+File(parent: File, child: String) 

+exists(): boolean 
+canRead(): boolean 
+canWrite(): boolean 
+i sDi rectoryO : boolean 
+isFile(): boolean 
+i sAbsol ute() : boolean 
+isHidden(): boolean 

+getAbsolutePath() : String 
+getCanoni cal Path() : String 



+getName(): String 

+getPath(): String 
+getParent() : String 

+lastModified() : long 
+length(): long 
+listFile(): File[] 
+delete(): boolean 
+renameTo(dest: File): boolean 



Creates a File object for the specified path name. The path name may be a 
directory or a file. 

Creates a File object for the child under the directory parent. The child may be 
a file name or a subdirectory. 

Creates a File object for the child under the directory parent. The parent is a 
Fi 1 e object. In the preceding constructor, the parent is a string. 

Returns true if the file or the directory represented by the File object exists. 

Returns true if the file represented by the File object exists and can be read. 

Returns true if the file represented by the File object exists and can be written. 

Returns true if the Fi 1 e object represents a directory. 

Returns true if the Fi 1 e object represents a file. 

Returns true if the Fi 1 e object is created using an absolute path name. 

Returns true if the file represented in the Fi 1 e object is hidden. The exact 
definition of hidden is system dependent. On Windows, you can mark a file 
hidden in the File Properties dialog box. On Unix systems, a file is hidden if 
its name begins with a period character 

Returns the complete absolute file or directory name represented by the Fi 1 e 
object. 

Returns the same as getAbsol utePath () except that it removes redundant 
names, such as "." and from the path name, resolves symbolic links (on 
Unix platforms), and converts drive letters to standard uppercase (on Win32 
platforms). 

Returns the last name of the complete directory and file name represented by 
the Fi le object. For example, new Fi 1 e("c : \\book\\test . dat") .getNameO returns 
test.dat. 

Returns the complete directory and file name represented by the Fi 1 e object. 
For example, new File("c:\\book\\test.dat") .getPathO returns c:\book\test.dat. 

Returns the complete parent directory of the current directory or the file 
represented by the File object. For example, new 
File("c:\\book\\test.dat") .getParentO returns c:\book. 

Returns the time that the file was last modified. 

Returns the size of the file, or if it does not exist or if it is a directory. 
Returns the files under the directory for a directory Fi 1 e object. 
Deletes this file. The method returns true if the deletion succeeds. 
Renames this file. The method returns true if the operation succeeds. 



Figure 9.1 5 The Fi 1 e class can be used to obtain file and directory properties and to delete and rename files. 



The file name is a string. The File class is a wrapper class for the file name and its directory path. 
For example, new File("c:\\book") creates a File object for the directory c:\book, and new 
File("c: \\bookWtest.dat") creates a File object for the file c:\\book\\test.dat, both on 
Windows. You can use the Fil e class's i sDi rectory method to check whether the object rep- 
resents a directory, and the i sFi 1 e method to check whether the object represents a file. 

|p Caution 

The directory separator for Windows is a backslash (\). The backslash is a special character in 

Java and should be written as \\ in a string literal (see Table 2.6). \ in file names 
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§ Note 

Constructing a File instance does not create a file on the machine. You can create a File 
instance for any file name regardless whether it exists or not. You can invoke the existsO 
method on a File instance to check whether the file exists. 

Do not use absolute file names in your program. If you use a file name such as 
"c:\\book\\We1come. java", it will work on Windows but not on other platforms. You 

relative file name should use a file name relative to the current directory. For example, you may create a Fi 1 e 

object using new File("We1come. java") for the file Welcome.java in the current direc- 
tory. You may create a File object using new File("image/us.gif") for the file us.gif 

Java directory separator (/) under the image directory in the current directory. The forward slash (/) is the Java directory 

separator, which is the same as on Unix. The statement new File ("image/us . gif ") works 
on Windows, Unix, and any other platform. 

Listing 9.6 demonstrates how to create a File object and use the methods in the File 
class to obtain its properties. The program creates a Fil e object for the file us.gif. This file is 
stored under the image directory in the current directory. 

Listing 9.6 Test Filed ass. java 

1 public class TestFi 1 eCl ass { 



create a Fi 1 e 


2 

3 


public static void main(String[] args) { 


java. io. File file = new java. io . Fi 1 e("image/us .gi f ") ; 


existsO 


4 


System. out. pri ntl n ("Does it exist? " + file. existsO ) ; 


lengthO 


5 


System. out. print"ln("The file has " + file.lengthO + " bytes"); 


canReadO 


6 


System. out. pri ntl n ("Can it be read? " + file.canReadO) ; 


canWriteO 


7 


System. out. println("Can it be written? " + file.canWriteO) ; 


isDi rectory () 


8 


System. out. pn'ntln("Is it a directory? " + file.isDi rectoryO) ; 


isFileO 


9 


System. out. pn'ntln("Is it a file? " + f i 1 e . i sFi 1 e()) ; 


isAbsoluteO 


10 


System. out. println("Is it absolute? " + f i 1 e . i sAbsol ute()) ; 


isHiddenO 


11 


System. out. pri ntl n("Is it hidden? " + file.isHiddenO) ; 




12 


System. out. println ("Absolute path is " + 


getAbsolutePathO 


13 


f i 1 e . getAbsol utePath () ) ; 




14 


System. out. pri ntl n("Last modified on " + 


lastModifiedQ 


15 


new java.util .Date(file.lastModified())) ; 




16 


} 




17 } 





The 1 astModi f ied() method returns the date and time when the file was last modified, 
measured in milliseconds since the beginning of Unix time (00:00:00 GMT, January 1, 1970). 
The Date class is used to display it in a readable format in lines 14-15. 



< \ Command Prompt 



Jnjji] 



C:\book>jaua TostFileClass 

Does it exist? true 

The file has 2998 bytes 

Can it be read? true 

Can it be written? true 

Is it a directory? false 

Is it a file? true 

Is it absolute? false 

Is it hidden? false 

Absolute path is C:\bcok\iitiBge\us.gif 

Last modified on Tue Nou G2 08:20:45 EST 20B4 



~3 



C:\book>_ 
J 



J 



(a) On Windows 



'M panda.arnistrong.edu - default - SSH 



Fie Edit View Window Help 
I £] Ejiiirkcnnnprr Q Hrnftes 



[ danielSpanda boot] $ jaira Teat File Class 
COM i I. nxi.tt.? I. run 
The tile has 2 'j 'j U byte s 
iJon it be read? true 
Can it ba written? ^rua 

Is xL t± liiieL-Lrjiy? f-dlsftr 
T> Ht n filr.? trUtt 
Is it absolute? talac 
le it hidden? false 

Absolute path is / home /dani el /book/ imaqe/ 
Tsn^1. :nrnl i T L rtrl mil Tmw. Nhiv 02 08 : 20 : 4f> V.^T 
[ donielHpanda boofcji | 



us . qif 

?no4 



Connected to panda.a rmstjong.edu |SSH2 - aesl38-cbc - hmac-md 

(b) On Unix 



Figure 9.1 6 The program creates a Fi 1 e object and displays file properties. 
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Figure 9.16(a) shows a sample run of the program on Windows, and Figure 9.16(b), a sam- 
ple run on Unix. As shown in the figures, the path-naming conventions on Windows are 
different from those on Unix. 

9.7 File Input and Output 

A Fi 1 e object encapsulates the properties of a file or a path but does not contain the methods 
for creating a file or for reading/writing data from/to a file. In order to perform I/O, you need 
to create objects using appropriate Java I/O classes. The objects contain the methods for read- 
ing/writing data from/to a file. This section introduces how to read/write strings and numeric 
values from/to a text file using the Scanner and PrintWriter classes. 

9.7.1 Writing Data Using PrintWriter 

The java. io. PrintWriter class can be used to create a file and write data to a text file. 
First, you have to create a Pr i ntWr i ter object for a text file as follows: 

PrintWriter output = new PrintWriter(filename) ; 

Then, you can invoke the print, printl n, and printf methods on the PrintWriter object 
to write data to a file. Figure 9.17 summarizes frequently used methods in PrintWriter. 



java.io.PrintWriter 

+PrintWriter(fiIe: File) 
+PrintWriter(filename: String) 
+print(s: String): void 
+print(c: char): void 
+print(cArray: char[]): void 
+print(i : int) : void 
+print(l: long): void 
+print(f: float): void 
+print(d: double): void 
+print(b: boolean): void 

Also contains the overloaded 
pri ntl n methods. 

Also contains the overloaded 
printf methods. 



Figure 9.1 7 The Pri ntWri ter class contains the methods for writing data to a text file. 

Listing 9.7 gives an example that creates an instance of Pr i ntWr i ter and writes two lines 
to the file "scores.txt". Each line consists of first name (a string), middle-name initial (a char- 
acter), last name (a string), and score (an integer). 

Listing 9.7 Wri teData. java 

1 public class Wri teData { 

2 public static void main(String[] args) throws Exception { 

3 java. io. File file = new java.io.FileCscores.txt"); 

4 if (file.existsO) { 

5 System. out. println("Fi!e already exists"); 

6 System. exit (0) ; 

7 } 
8 

9 // Create a file 

10 java.io.PrintWriter output = new java. io. Pri ntWri ter(f i I e) ; 



Creates a Pri ntWri ter object for the specified file object. 

Creates a Pri ntWri ter object for the specified file-name string. 

Writes a string to the file. 

Writes a character to the file. 

Writes an array of characters to the file. 

Writes an i nt value to the file. 

Writes a 1 ong value to the file. 

Writes a f 1 oat value to the file. 

Writes a doubl e value to the file. 

Writes a bool ean value to the file. 

A pri ntl n method acts like a pri nt method; additionally it 
prints a line separator. The line-separator string is defined 
by the system. It is \r\n on Windows and \n on Unix. 

The pri ntf method was introduced in §3.17, "Formatting 
Console Output." 



throws an exception 
create File object 
file exist? 



create PrintWriter 
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print data 



close file 



11 
12 
13 
14 
15 
16 
17 
18 
19 
20 

21 } 



// Write formatted output to the file 
output . pri nt("John T Smith ") ; 
output. print In (90) ; 
output. print("Eric K Jones ") ; 
output. print In (8 5) ; 

// Close the file 
output. closeQ ; 





John 


T 


Smith 96 


Eric 


K 


Jones 85 



scores . txt 



create a file 



throws Exception 



print method 
close file 



Lines 3-7 check whether the file scores.txt exists. If so, exit the program (line 6). 

Invoking the constructor of Pr i ntWri ter will create a new file if the file does not exist. If 
the file already exists, the current content in the file will be discarded. 

Invoking the constructor of Pri ntWr i ter may throw an I/O exception. Java forces you to write 
the code to deal with this type of exception. You will learn how to handle it in Chapter 13, "Excep- 
tion Handling." For now, simply declare throws Exception in the method header (line 2). 

You have used the System. out. print and System. out. println methods to write 
text to the console. System. out is a standard Java object for the console. You can create 
objects for writing text to any file using print, printl n, and printf (lines 13-16). 

The cl ose () method must be used to close the file. If this method is not invoked, the data 
may not be saved properly in the file. 



9.7.2 Reading Data Using Scanner 

The java . util . Scanner class was used to read strings and primitive values from the con- 
sole in §2.3, "Reading Input from the Console." A Scanner breaks its input into tokens 
delimited by whitespace characters. To read from the keyboard, you create a Scanner for 
System . i n, as follows: 

Scanner input = new Scanner(System.in) ; 
To read from a file, create a Scanner for a file, as follows: 

Scanner input = new Scanner(new File (filename)) ; 
Figure 9.18 summarizes frequently used methods in Scanner. 



j ava.util.Scanner 



+Scanner(source : File) 
+Scanner(source : String) 
+close() 

+hasNext(): boolean 

+next(): String 

+nextl_ine(): String 

+nextByte(): byte 

+nextShort() : short 

+nextlnt(): int 

+nextl_ong(): long 

+nextFloat() : float 

+nextDouble() : double 

+useDelimiter(pattern: String) 
Scanner 



Creates a scanner that produces values scanned from the specified file. 
Creates a scanner that produces values scanned from the specified string 
Closes this scanner. 

Returns true if this scanner has more data to be read. 

Returns next token as a string from this scanner. 

Returns a line ending with the line separator from this scanner. 

Returns next token as a byte from this scanner. 

Returns next token as a short from this scanner. 

Returns next token as an i nt from this scanner. 

Returns next token as a 1 ong from this scanner. 

Returns next token as a f 1 oat from this scanner. 

Returns next token as a doubl e from this scanner. 

Sets this scanner's delimiting pattern and returns this scanner. 



Figure 9.1 8 The Scanner class contains the methods for scanning data. 
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Listing 9.8 gives an example that creates an instance of Scanner and reads data from the 
file "scores.txt". 



Listing 9.8 ReadData . j ava 



3 
4 
5 
6 
7 
8 
9 
10 
11 
12 
13 
14 
15 
16 
17 
18 
19 
20 
21 
22 
23 
24 



1 import java.util .Scanner; 

2 

public class ReadData { 

public static void main(String[] args) throws Exception { 

// Create a File instance 

java.io.File file = new java.io.FileCscores.txt"); 



// Create a Scanner for the file 
Scanner input = new Scanner(f i 1 e) 



// Read data from a file 
while (input. hasNextO) { 

String f i rstName = input. 

String mi = i nput . next() ; 

String lastName = input.n 

int score = i nput . nextlntO ; 

System. out . pri ntl n( 

f i rstName + " " + mi + " " 



+ lastName + 



} 

// Close the file 
input. closeQ ; 



} 



scores . txt 




create a Fi 1 e 



create a Scanner 



has next? 
read items 



+ score) ; 



close file 



Note that new Scanner (String) creates a Scanner for a given string. To create a 
Scanner to read data from a file, you have to use the java.io.File class to create an Fileclass 
instance of the File using the constructor new File (filename) (line 6), and use new 
Scanner(File) to create a Scanner for the file (line 9). 

Invoking the constructor new Scanner (Fi 1 e) may throw an I/O exception. So the main 
method declares throws Exception in line 4. throws Exception 

Each iteration in the while loop reads first name, mi, last name, and score from the text 
file (lines 12-19). The file is closed in line 22. 

It is not necessary to close the input file (line 22), but it is a good practice to do so to close file 
release the resources occupied by the file. 



9.7.3 How Does Scanner Work? 

The nextByte(), nextShort(), nextlntO, nextLongO, nextFloat(), nextDouble(), 
and next() methods are known as token- reading methods, because they read tokens separated by 
delimiters. By default, the delimiters are whitespace. You can use the useDel imiter-(String 
regex) method to set a new pattern for delimiters. 

How does an input method work? A token-reading method first skips any delimiters (white- 
space by default), then reads a token ending at a delimiter. The token is then automatically con- 
verted into a value of the byte, short, int, long, float, or double type for nextByte(), 
nextShortO, nextlntO, nextLongO, nextFloat(), and nextDouble(), respec- 
tively. For the next() method, no conversion is performed. If the token does not match the 
expected type, a runtime exception java.util . InputMi smatchException will be 
thrown. 

Both methods next() and nextLineO read a string. The next() method reads a string 
delimited by delimiters, but nextLineO reads a line ending with a line separator. 



token-reading method 



change delimiter 



InputMi smatchException 



nextQ vs. nextLineO 
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<P Note 

line separator The line-separator string is defined by the system. It is \r\n on Windows and \n on Unix. To 

get the line separator on a particular platform, use 

String 1 i neSeparator = System. getProperty("l ine. separator") ; 

If you enter input from a keyboard, a line ends with the Enter key, which corresponds to the \n 
character. 

The token-reading method does not read the delimiter after the token. If the nextLineO is 
invoked after a token-reading method, the method reads characters that start from this delim- 
iter and end with the line separator. The line separator is read, but it is not part of the string 
returned by nextLineO. 

Suppose a text file named test.txt contains a line 

34 567 

After the following code is executed, 

Scanner input = new Scanner(new Fi 1 e("test . txt")) ; 
int intValue = i nput . nextlntO ; 
String line = i nput . nextLi ne() ; 

i ntVal ue contains 34 and 1 i ne contains characters ' ','5', '6', '7'. 

input from keyboard What happens if the input is entered from the keyboard! Suppose you enter 34, the Enter 

key, 567, and the Enter key for the following code: 

Scanner input = new Scanner(System.in) ; 
int intValue = i nput . nextlntO ; 
String line = i nput . nextLi ne() ; 

You will get 34 in intVal ue and an empty string in 1 ine. Why? Here is the reason. The 
token-reading method nextlnt () reads in 34 and stops at the delimiter, which in this case is 
a line separator (the Enter key). The nextLi ne() method ends after reading the line separa- 
tor and returns the string read before the line separator. Since there are no characters before 
the line separator, 1 i ne is empty. 

9.7.4 Problem: Replacing Text 

Suppose you are to write a program named Repl aceText that replaces all occurrences of a 
string in a text file with a new string. The file name and strings are passed as command-line 
arguments as follows: 

java ReplaceText sourceFile targetFile oldString newString 

For example, invoking 

java ReplaceText FormatString. java t.txt StringBuilder StringBuffer 

replaces all the occurrences of StringBuilder by StringBuffer in FormatString.java and 
saves the new file in t.txt. 

Listing 9.9 gives the solution to the problem. The program checks the number of argu- 
ments passed to the main method (lines 7-11), checks whether the source and target files 
exist (lines 14-25), creates a Scanner for the source file (line 28), creates a PrintWriter 
for the target file, and repeatedly reads a line from the source file (line 32), replaces the text 
(line 33), and writes a new line to the target file (line 34). You must close the output file (line 
38) to ensure that data are saved to the file properly. 



behavior of nextLineO 



input from file 
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Listing 9.9 Repl aceText . j ava 

1 import java.io.*; 

2 import java.util .* ; 

3 

4 public class Repl aceText { 



5 public static void main(String[] args) throws Exception { 

6 // Check command-line parameter usage 

7 if (args. length != 4) { check command usage 

8 System. out . pri ntl n( 

9 "Usage: java ReplaceText sourceFile targetFile oldStr newStr") ; 

10 System. exit(0) ; 

11 } 
12 

13 // Check if source file exists 

14 File sourceFile = new Fi 1 e(args [0] ) ; 

15 if (!sourceFile.exists() ) { source file exists? 

16 System. out. pri ntl n ("Source file " + args[0] + " does not exist"); 

17 System. exit(0) ; 

18 } 
19 

20 // Check if target file exists 

21 File targetFile = new Fi 1 e(args [1] ) ; 

22 if (targetFile.existsO ) { target file exists? 

23 System. out. pri ntl n ("Target file " + args[l] + " already exists"); 

24 System. exit(0) ; 

25 } 
26 

27 // Create a Scanner for input and a PrintWriter for output 

28 Scanner input = new Scanner(sourceFi 1 e) ; create a Scanner 

29 PrintWriter output = new Pri ntWri ter(targetFi 1 e) ; create a PrintWriter 
30 

31 while (input. hasNext() ) { has next? 

32 String si = input. nextLine() ; read a line 

33 String s2 = si. replaceAll (args[2] , args[3]); 

34 output. println(s2) ; 

35 } 
36 

37 input. close() ; close file 

38 output. close() ; 

39 } 



40 } 

9.8 (GUI) File Dialogs 

Java provides the javax. swing . JFil eChooser class for displaying a file dialog, as shown 
in Figure 9.19. From this dialog box, the user can choose a file. 

Listing 9.10 gives a program that prompts the user to choose a file and displays its contents 
on the console. 

Listing 9.10 ReadFileUsingJFileChooser. java 

1 import java.util .Scanner; 

2 import javax. swing. JFileChooser; 
3 

4 public class ReadFileUsingJFileChooser { 

5 public static void main(String[] args) throws Exception { 

6 JFileChooser fileChooser = new JFileChooserO ; 

7 if (fileChooser. showOpenDialog(null) 



create a JFileChooser 

display file chooser 
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check status 
getSel ectedFi 1 e 



8 

9 
10 
11 
12 
13 
14 
15 
16 
17 
18 
19 
20 
21 
22 
23 
24 
25 
26 

27 } 



== JFileChooser.APPR0VE_0PTI0N) { 

// Get the selected file 

java.io.Fnle file = fi 1 eChooser . getSel ectedFi 1 e() ; 

// Create a Scanner for the file 
Scanner input = new Scanner(f i 1 e) ; 

// Read text from the file 
while (input. hasNextO) { 

System . out . pri ntl n(i nput . next Li ne()) ; 

} 

// Close the file 
input. closeO ; 

} 

else { 

System. out . pri ntl n("No file selected"); 

} 
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Figure 9.19 JFileChooser can be used to display a file dialog for opening a file. 



showOpenDialog The program creates a JFil eChooser in line 6. The showOpenDialog(null ) method dis- 

plays a dialog box, as shown in Figure 9.19. The method returns an int value, either 

APPR0VE_0PTI0N APPR0VE_0PTT0N or CANCEL_0PTI0N, which indicates whether the Open button or the 

Cancel button was clicked. 

getSel ectedFile The getSel ectedFil e() method (line 10) returns the selected file from the file dialog 

box. Line 13 creates a scanner for the file. The program continuously reads the lines from the 
file and displays them to the console (lines 16-18). 

Chapter Summary 



1. Strings are objects encapsulated in the String class. A string can be constructed 
using one of the 1 1 constructors or using a string literal shorthand initializer. 

2. A String object is immutable; its contents cannot be changed. To improve efficiency 
and save memory, the JVM stores two literal strings that have the same character 
sequence in a unique object. This unique object is called an interned string object. 

3. You can get the length of a string by invoking its 1 engthO method, retrieve a char- 
acter at the specified index in the string using the charAt (index) method, and use 
the i ndexOf and 1 astlndexOf methods to find a character or a substring in a string. 
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4. You can use the concat method to concatenate two strings, or the plus (+) sign to 
concatenate two or more strings. 

5. You can use the substri ng method to obtain a substring from the string. 

6. You can use the equal s and compareTo methods to compare strings. The equal s 
method returns true if two strings are equal, and false if they are not equal. The 
compareTo method returns 0, a positive integer, or a negative integer, depending on 
whether one string is equal to, greater than, or less than the other string. 

7. The Character class is a wrapper class for a single character. The Character class 
provides useful static methods to determine whether a character is a letter 
(isLetter(char)), a digit (isDigit(char)), uppercase (isUpperCase(char)), 
or lowercase (isLowerCase(char)). 

8. The StringBuilder/StringBuf fer class can be used to replace the String class. 
The Str i ng object is immutable, but you can add, insert, or append new contents into 
a StringBuilder/StringBuf fer object. Use String if the string contents do not 
require any change, and use StringBuilder/StringBuffer if they change. 

9. You can pass strings to the mai n method from the command line. Strings passed to the 
main program are stored in args, which is an array of strings. The first string is rep- 
resented by args [0] , and args . 1 ength is the number of strings passed. 

1 0. The File class is used to obtain file properties and manipulate files. It does not con- 
tain the methods for creating a file or for reading/writing data from/to a file. 

I I . You can use Scanner to read string and primitive data values from a text file and use 
Pri ntWri ter to create a file and write data to a text file. 

1 2. The JFil eChooser class can be used to display files graphically. 



Review Questions 



Section 9.2 

9.1 Suppose that si, s2, s3, and s4 are four strings, given as follows: 

String si = "Welcome to Java"; 

String s2 = si; 

String s3 = new String ("Wei come to Java"); 

String s4 = "Welcome to Java"; 

What are the results of the following expressions? 

(1) si == s2 (9) sl.indexOf('j') 

(2) s2 == s3 (10) sl.indexOf("to") 

(3) sl.equals(s2) (11) sl.lastlndexOf ('a') 

(4) s2.equals(s3) (12) sl.lastlndexOf ("o", 15) 

(5) sl.compareTo(s2) (13) sl.lengthO 

(6) s2 . compareTo(s3) (14) si. substri ng(5) 

(7) si == s4 (15) si. substrings, 11) 

(8) sl.charAt(O) (16) si. startsWi th("Wel ") 
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(17) sl.endsWith("Java") 

(18) sl.toLowerCaseO 

(19) sl.toUpperCaseO 

(20) " Welcome ".trimQ 



(21) sl.replace('o' , 'T') 

(22) sl.replaceAll("o", "T") 

(23) sl.replaceFirst("o", "T") 

(24) sl.toCharArrayO 



To create a string "Welcome to Java", you may use a statement like this: 



String s = "Welcome to Java"; 



or 



String s = new Stri ng("Welcome to Java); 

Which one is better? Why? 

9.2 Suppose that si and s2 are two strings. Which of the following statements or 
expressions are incorrect? 

String s = new StringC'new string"); 

Stri ng s3 = si + s2 ; 

String s3 = si - s2; 

si == s2; 

si >= s2 ; 

si. compareTo(s2) ; 

int i = sl.lengthQ ; 

char c = sl(0) ; 

char c = sl.charAt(sl.lengthO) ; 

9.3 What is the printout of the following code? 

String si = "Welcome to Java"; 
String s2 = sl.replace("o", "abc") ; 
System. out. println(sl) ; 
System . out . pri ntl n(s2) ; 

9.4 Let si be " Wei come 11 and s2 be " wel come ". Write the code for the following 
statements: 

■ Check whether si is equal to s2 and assign the result to a Boolean variable 
isEqual . 

■ Check whether si is equal to s2, ignoring case, and assign the result to a 
Boolean variable i s Equal . 

■ Compare si with s2 and assign the result to an int variable x. 

■ Compare si with s2, ignoring case, and assign the result to an int variable x. 

■ Check whether si has prefix "AAA" and assign the result to a Boolean variable b. 

■ Check whether si has suffix "AAA" and assign the result to a Boolean variable b. 

■ Assign the length of si to an i nt variable x. 

■ Assign the first character of si to a char variable x. 

■ Create a new string s3 that combines si with s2. 

■ Create a substring of si starting from index 1. 

■ Create a substring of si from index 1 to index 4. 

■ Create a new string s3 that converts si to lowercase. 

■ Create a new string s3 that converts si to uppercase. 

■ Create a new string s3 that trims blank spaces on both ends of si. 

■ Replace all occurrences of character e with E in si and assign the new string to s3. 

■ Split "Wel come to Java and HTML" into an array tokens delimited by a space. 

■ Assign the index of the first occurrence of character e in si to an i nt variable x. 

■ Assign the index of the last occurrence of string abc in si to an i nt variable x. 



Review Questions 333 



9.5 Does any method in the Stri ng class change the contents of the string? 

9.6 Suppose string s is created using new Stri ng (); what is s. length ()? 

9.7 How do you convert a char, an array of characters, or a number to a string? 

9.8 Why does the following code cause a Nul 1 PointerException? 

1 public class Test { 

2 private String text; 
3 

4 public Test(String s) { 

5 String text = s; 

6 } 
7 

8 public static void mai n(Stri ng [] args) { 

9 Test test = new TestC'ABC") ; 

10 System. out. println(test. text. toLowerCaseO) ; 

11 } 

12 } 

9.9 What is wrong in the following program? 

1 public class Test { 

2 String text; 
3 

4 public void Test(String s) { 

5 this. text = s; 

6 } 
7 

8 public static void mai n (Stri ng [] args) { 

9 Test test = new TestC'ABC") ; 

10 System. out . pri nt~l n(test) ; 

11 } 

12 } 

Section 9.3 

9.10 How do you determine whether a character is in lowercase or uppercase? 

9.11 How do you determine whether a character is alphanumeric? 

Section 9.4 

9.12 What is the difference between StringBuilder and StringBuf fer? 

9.13 How do you create a string builder for a string? How do you get the string from a 
string builder? 

9.14 Write three statements to reverse a string s using the reverse method in the 
StringBuilder class. 

9.15 Write a statement to delete a substring from a string s of 20 characters, starting at 
index 4 and ending with index 10. Use the del ete method in the Stri ngBui 1 der 
class. 

9.16 What is the internal structure of a string and a string builder? 
9.1 7 Suppose that si and s2 are given as follows: 

StringBuilder si = new Stri ngBui 1 der("3ava") ; 
StringBuilder s2 = new Stri ngBui 1 derC'HTML") ; 

Show the value of s 1 after each of the following statements. Assume that the state- 
ments are independent. 
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(1) sl.appendC" is fun"); (7) si . del eteCharAt(3) ; 

(2) sl.append(s2) ; (8) si. deleted, 3); 

(3) sl.insert(2, "is fun"); (9) si. reverse() ; 

(4) sl.insertCl, s2) ; (10) si. replaced, 3, "Computer"); 

(5) sl.charAt(2) ; (11) sl.substn'ngd, 3); 

(6) sl.length() ; (12) sl.substn'ngd) ; 

9.18 Show the output of the following program: 

public class Test { 

public static void man n(Stri ng [] args) { 
String s = "Java"; 

Stri ngBui 1 der builder = new Stri ngBui lder(s) ; 
changed, builder); 

System. out . pri ntl n(s) ; 
System. out. println(builder) ; 

} 

private static void change(Stri ng s, Stri ngBui 1 der builder) { 
s = s + " and HTML"; 
builder. append(" and HTML"); 

} 

} 

Section 9.5 

9.19 This book declares the mai n method as 
public static void main(String[] args) 
Can it be replaced by one of the following lines? 
public static void main(String args[]) 
public static void main(String[] x) 
public static void main(String x[]) 
static void main(String x[]) 

9.20 Show the output of the following program when invoked using 

1 . java Test I have a dream 

2. java Test "12 3" 

3. java Test 

4. java Test "*" 

5. java Test * 

public class Test { 

public static void mai n(Stri ng [] args) { 

System. out . pri ntl n("Number of strings is " + args . 1 ength) ; 
for (int i = 0; i < args. length; i++) 
System . out . pri ntl n (args [i ] ) ; 

} 

} 

Section 9.6 

9.2 I What is wrong about creating a Fi 1 e object using the following statement? 
new File("c:\book\test.dat") ; 
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9.22 How do you check whether a file already exists? How do you delete a file? How 
do you rename a file? Can you find the file size (the number of bytes) using the 
File class? 

9.23 Can you use the Fil e class for I/O? Does creating a Fil e object create a file on 
the disk? 

Section 9.7 

9.24 How do you create a PrintWriter to write data to a file? What is the reason to 
declare throws Exception in the main method in Listing 9.7, WriteData.java? 
What would happen if the close C) method were not invoked in Listing 9.7? 

9.25 Show the contents of the file temp.txt after the following program is executed. 

public class Test { 

public static void man n(Stri ng [] args) throws Exception { 
java.io. PrintWriter output = new 

java. io . Pri ntWri ter("temp. txt") ; 
output. printf ("amount is %f %e\r\n", 32.32, 32.32); 
output. pri ntf ("amount is %5.4f %5.4e\r\n", 32.32, 32.32); 
output. pri ntf ("%6b\r\n", (1 > 2)); 
output .pri ntf ("%6s\r\n" , "Java") ; 
output . cl ose() ; 

} 

} 

9.26 How do you create a Scanner to read data from a file? What is the reason to 
define throws Exception in the main method in Listing 9.8, ReadData.java? 
What would happen if the close () method were not invoked in Listing 9.8? 

9.27 What will happen if you attempt to create a Scanner for a nonexistent file? What 
will happen if you attempt to create a Pr i ntWri ter for an existing file? 

9.28 Is the line separator the same on all platforms? What is the line separator on Win- 
dows? 

9.29 Suppose you enter 45 57.8 789, then press the Enter key. Show the contents of 
the variables after the following code is executed. 

Scanner input = new Scanner(System.in) ; 
int intValue = i nput . nextlnt() ; 
double doubleValue = i nput . nextDoubl e() ; 
String line = input. nextLine() ; 

9.30 Suppose you enter 45, the Enter key, 57.8, the Enter key, 789, the Enter key. 
Show the contents of the variables after the following code is executed. 

Scanner input = new Scanner(System . i n) ; 
int intValue = i nput . nextlnt() ; 
double doubleValue = i nput. nextDoubl e () ; 
String line = i nput . nextLi ne() ; 
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Sections 9.2-9.3 

9.1 * {Checking SSN) Write a program that prompts the user to enter a social security 
number in the format DDD-DD-DDDD, where D is a digit. The program displays 
"Val i d SSN" for a correct social security number and "Inval i d SSN" otherwise. 
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9.2** (Checking substrings) You can check whether a string is a substring of another 
string by using the i ndexOf method in the Stri ng class. Write your own method 
for this function. Write a program that prompts the user to enter two strings, and 
check whether the first string is a substring of the second. 

9.3** (Checking password) Some Websites impose certain rules for passwords. Write a 
method that checks whether a string is a valid password. Suppose the password 
rule is as follows: 

■ A password must have at least eight characters. 

■ A password consists of only letters and digits. 

■ A password must contain at least two digits. 

Write a program that prompts the user to enter a password and displays "Val id 
Password" if the rule is followed or "Inval id Password" otherwise. 

9.4 (Occurrences of a specified character) Write a method that finds the number of 
occurrences of a specified character in the string using the following header: 

public static int count(String str, char a) 

For example, count ("Wei come" , 'e') returns 2. Write a test program that 
prompts the user to enter a string followed by a character and displays the number 
of occurrences of the character in the string. 

9.5** (Occurrences of each digit in a string) Write a method that counts the occurrences 
of each digit in a string using the following header: 

public static int[] count(Stri ng s) 

The method counts how many times a digit appears in the string. The return value 
is an array of ten elements, each of which holds the count for a digit. For example, 
after executing int[] counts = count("12203AB3"), counts[0] is 1, 
counts[l] is 1, counts[2] is 2, counts[3] is 2. 

Write a test program that prompts the user to enter a string and displays the num- 
ber of occurrences of each digit in the string. 

9.6* (Counting the letters in a string) Write a method that counts the number of letters 
in a string using the following header: 

public static int countLetters (Stri ng s) 

Write a test program that prompts the user to enter a string and displays the num- 
ber of letters in the string. 

9.7* (Phone keypads) The international standard letter/number mapping found on the 
telephone is shown below: 



1 



2 



3 



ABC 



DEF 



4 



5 



6 



GHI 



JKL 



MNO 



7 



8 



9 



PQRS 



TUV 



WXYZ 







Write a method that returns a number, given an uppercase letter, as follows: 



public static int getNumber(char uppercaseLetter) 



Programming Exercises 337 



Write a test program that prompts the user to enter a phone number as a string. 
The input number may contain letters. The program translates a letter (upper- or 
lowercase) to a digit and leaves all other characters intact. Here is a sample run of 
the program: 



Enter a string: 1-800-F1 owers 
1-800-3569377 



Enter a string: 1800flowers 
18003569377 



9.8* (Binary to decimal) Write a method that parses a binary number as a string into a 
decimal integer. The method header is as follows: 

public static int bi naryToDeci mal (Stri ng bi naryStri ng) 

For example, binary string 10001 is 17 (1 X 2 4 + X 2 3 + X 2 2 + X 2 

+ 1 = 17). So, binaryToDecimal ("10001") returns 17. Note that 
Integer. parselnt(" 10001", 2) parses a binary string to a decimal value. 
Do not use this method in this exercise. 

Write a test program that prompts the user to enter a binary string and displays 
the corresponding decimal integer value. 

Section 9.4 

9.9** (Binary to hex) Write a method that parses a binary number into a hex number. 
The method header is as follows: 

public static String bi naryToHex(Stri ng binaryValue) 

Write a test program that prompts the user to enter a binary number and displays 
the corresponding hexadecimal value. 

9.1 0** (Decimal to binary) Write a method that parses a decimal number into a binary 
number as a string. The method header is as follows: 

public static String decimalToBi nary(int value) Video Note 

Number conversion 

Write a test program that prompts the user to enter a decimal integer value and 
displays the corresponding binary value. 

9.1 I ** (Sorting characters in a string) Write a method that returns a sorted string using 
the following header: 

public static String sort(String s) 

For example, sort("acb") returns abc. 

Write a test program that prompts the user to enter a string and displays the 
sorted string. 

9.12** (Anagrams) Write a method that checks whether two words are anagrams. Two 
words are anagrams if they contain the same letters in any order. For example, 
"silent" and "1 isten" are anagrams. The header of the method is as follows: 

public static boolean i sAnagram(Stri ng si, String s2) 
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Write a test program that prompts the user to enter two strings and, if they are 
anagrams, displays "anagram" , otherwise displays "not anagram". 

Section 9.5 

9.1 3* (Passing a string to check palindromes) Rewrite Listing 9.1 by passing the string 
as a command-line argument. 

9.1 4* (Summing integers) Write two programs. The first program passes an unspecified 
number of integers as separate strings to the man n method and displays their total. 
The second program passes an unspecified number of integers delimited by one 
space in a string to the main method and displays their total. Name the two pro- 
grams Exercise9_14a and Exercise9_14b, as shown in Figure 9.20. 



|'-'- Command Prompt 


-lol 




C : \exercise>jaua Exercises 14a 


12 3 4 5 




The total is 15 




I 


C :\exereise>jaua Exercise9_1 4b 


"1 2 3 4 5" 




The total is 15 






C :\exercise> 






.1 1 




:: 



Figure 9.20 The program adds all the numbers passed from the command line. 



9.15* (Finding the number of uppercase letters in a string) Write a program that passes 
a string to the main method and displays the number of uppercase letters in a 
string. 

Sections 9.7-9.8 

9.16** (Reformatting Java source code) Write a program that converts the Java source 
code from the next-line brace style to the end-of-line brace style. For example, the 
Java source in (a) below uses the next-line brace style. Your program converts it 
to the end-of-line brace style in (b). 



public class Test 
{ 

public static void mai n(Stri ng [] args) 
{ 

// Some statements 

} 

} 



public class Test { 

public static void main(Stn'ng[] args) { 

// Some statements 

} 

} 



(a) Next-line brace style 



(b) End-of-line brace style 



Your program can be invoked from the command line with the Java source-code 
file as the argument. It converts the Java source code to a new format. For exam- 
ple, the following command converts the Java source-code file Test.java to the 
end-of-line brace style. 

java Exercise9_16 Test.java 

9.17* (Counting characters, words, and lines in a file) Write a program that will count the 
number of characters (excluding control characters '\r' and '\n'), words, and 
lines, in a file. Words are separated by spaces, tabs, carriage return, or line-feed 
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characters. The file name should be passed as a command-line argument, as shown 
in Figure 9.21. 



Command Prompt 


In 


x| 


C : \exerciee>jaua Exerciee9_1 7 Loan.jaua 




±1 


File Loan.jaua has 






1777 characters 






21 words 






71 lines 






C : \exercise>_ 






<l I 







Figure 9.2 1 The program displays the number of characters, words, and lines in the given 
file. 



9.18* (Processing scores in a text file) Suppose that a text file Exercise9_18.txt con- 
tains an unspecified number of scores. Write a program that reads the scores from 
the file and displays their total and average. Scores are separated by blanks. 

9.19* (Writing/Reading data) Write a program to create a file named Exercise9_19.txt 
if it does not exist. Write 100 integers created randomly into the file using text 
I/O. Integers are separated by spaces in the file. Read the data back from the file 
and display the sorted data. 

9.20** (Replacing text) Listing 9.9, ReplaceText.java, gives a program that replaces text 
in a source file and saves the change into a new file. Revise the program to save 
the change into the original file. For example, invoking 

java Exercise9_20 file oldString newString 

replaces oldString in the source file with newString. 

9.2 I ** (Removing text) Write a program that removes all the occurrences of a specified 
string from a text file. For example, invoking 

java Exercise9_21 Dohn filename 
removes string John from the specified file. 
Comprehensive 

9.22** (Guessing the capitals) Write a program that repeatedly prompts the user to enter 
a capital for a state, as shown in Figure 9.22(a). Upon receiving the user input, the 
program reports whether the answer is correct, as shown in Figure 9.22(b). 
Assume that 50 states and their capitals are stored in a two-dimensional array, as 
shown in Figure 9.23. The program prompts the user to answer all ten states' cap- 
itals and displays the total correct count. 



2<J 



O What is the capital or AFahamar 

[ l/l o mt r jome ry 



(a) 





CD 


Your answer is correct 

[ohJ 





(b) 



Figure 9.22 The program prompts the user to enter the capital in (a) and reports the cor- 
rectness of the answer. 
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Al abama 


Montgomery 


Alaska 


Juneau 


Arizona 


Phoenix 



Figure 9.23 A two-dimensional array stores states and their capitals. 



9. 23** (Implementing the String class) The String class is provided in the Java 
library. Provide your own implementation for the following methods (name the 
new class MyStringl): 



public MyStri ngl(char [] chars); 
public char charAt(int index); 
public int lengthO; 

public MyStringl substri ng(int begin, int end); 
public MyStringl toLowerCaseO ; 
public boolean equals(MyStringl s) ; 
public static MyStringl valueOf(int i); 

9.24** (Implementing the String class) The String class is provided in the Java 
library. Provide your own implementation for the following methods (name the 
new class MyStri ng2): 



public MyStri ng2(Stri ng s) ; 
public int compare(Stri ng s) ; 
public MyStri ng2 substri ng(int begin); 
public MyStri ng2 toUpperCaseO ; 
public char[] toChars(); 

public static MyStri ng2 val ueOf (bool ean b) ; 

9.25 (Implementing the Character class) The Character class is provided in the 
Java library. Provide your own implementation for this class. Name the new class 
MyCharacter. 

9.26** (Implementing the StringBuilder class) The StringBuilder class is pro- 
vided in the Java library. Provide your own implementation for the following 
methods (name the new class MyStri ngBuil derl): 

public MyStri ngBui 1 derl(Stri ng s) ; 

public MyStri ngBui 1 derl append(MyStringBuilderl s) ; 

public MyStri ngBui 1 derl append(int i); 

public int lengthO; 

public char charAt(int index); 

public MyStri ngBui 1 derl toLowerCaseO ; 

public MyStri ngBui 1 derl substring(int begin, int end); 

public String toStringO; 

9.27** (Implementing the StringBuilder class) The StringBuilder class is pro- 
vided in the Java library. Provide your own implementation for the following 
methods (name the new class MyStri ngBui lder2): 

public MyStri ngBui 1 der2 () ; 

public MyStri ngBui 1 der2 (char [] chars); 

public MyStri ngBui 1 der2 (Stri ng s) ; 

public MyStri ngBui 1 der2 insert(int offset, MyStri ngBui lder2 s) ; 
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public MyStri ngBui 1 der2 reverse(); 

public MyStri ngBui 1 der2 substring(int begin); 

public MyStri ngBui 1 der2 toUpperCase() ; 

9.28* (Common prefix) Write a method that returns the common prefix of two strings. 

For example, the common prefix of "distance" and "disinfection" is 
"dis". The header of the method is as follows: 

public static String pref i x(Stri ng si, String s2) 

If the two strings have no common prefix, the method returns an empty 
string. 

Write a mai n method that prompts the user to enter two strings and display 
their common prefix. 

9.29** (New string spl it method) The spl i t method in the Stri ng class returns an 
array of strings consisting of the substrings split by the delimiters. However, the 
delimiters are not returned. Implement the following new method that returns an 
array of strings consisting of the substrings split by the matches, including the 
matches. 

public static String[] spl i t(Stri ng s, String regex) 

For example, spl it("ab#12#453" , "#") returns ab, #, 12, #, 453 in an array 
of String, and spl it("a?b?gf#e" , "[?#]") returns a, b, ?, b, gf, #, and e 
in an array of String. 

9.30** (Financial: credit card number validation) Rewrite Exercise 5.31 using a 
string input for credit card number. Redesign the program using the following 
method: 

/** Return true if the card number is valid */ 
public static boolean i sVal i d(Stri ng cardNumber) 

/** Get the result from Step 2 */ 

public static int sumOfDoubl eEvenPl ace(Stri ng cardNumber) 

/** Return this number if it is a single digit; otherwise, 

* return the sum of the two digits */ 
public static int getDigit(int number) 

/** Return sum of odd place digits in number */ 
public static int sumOfOddPl ace(Stri ng cardNumber) 

9.3 I *** (Game: hangman) Write a hangman game that randomly generates a word and 
prompts the user to guess one letter at a time, as shown in the sample run. Each 
letter in the word is displayed as an asterisk. When the user makes a correct 
guess, the actual letter is then displayed. When the user finishes a word, display 
the number of misses and ask the user whether to continue for another word. 
Declare an array to store words, as follows: 

// Use any words you wish 

String[] words = {"write", "that", ...}; 
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(Guess) 


Enter a letter in word ******* 


> 


P 


(Guess) 


Enter a letter in word p****** 


> 


r 


(Guess) 


Enter a letter in word pr**r** 


> 


P 


P 


is already in the word 






(Guess) 


Enter a letter in word pr**r** 


> 





(Guess) 


Enter a letter in word pro*r** 


> 


g 


(Guess) 


Enter a letter in word progr** 


> 


n 


n 


is not in the word 






(Guess) 


Enter a letter in word progr** 


> 


m 


(Guess) 


Enter a letter in word progr*m 


> 


a 


The wore 


is program. You missed 1 time 






Do you want to guess for another word? 


Enter y or n> 



9.32** (Checking ISBN) Use string operations to simplify Exercise 3.9. Enter the first 9 
digits of an ISBN number as a string. 

9.33*** (Game: hangman) Rewrite Exercise 9.31. The program reads the words stored 
in a text file named Exercise9_33.txt. Words are delimited by spaces. 

9.34** (Replacing text) Revise Exercise9_20 to replace a string in a file with a new 
string for all files in the specified directory using the following command: 

java Exercise9_34 dir oldString newString 

9.35* (Bioinformatics: finding genes) Biologists use a sequence of letters A, C, T, and 
G to model a genome. A gene is a substring of a genome that starts after a triplet 
ATG and ends before a triplet TAG, TAA, or TGA. Furthermore, the length of a 
gene string is a multiple of 3 and the gene does not contain any of the triplets 
ATG, TAG, TAA, and TGA. Write a program that prompts the user to enter a 
genome and displays all genes in the genome. If no gene is found in the input 
sequence, displays no gene. Here are the sample runs: 



Enter a genome string: TTATGTTTTAACGATGGCGCCTTAGTT H-H 

TTT 

GGCCGT 



Enter a genome string: 
no gene is found 



TCTGTGTATAT 



Chapter 



Thinking in Objects 

Objectives 

■ To create immutable objects from immutable classes to protect the contents of objects 
(§10.2). 

■ To determine the scope of variables in the context of a class (§ 10.3). 

■ To use the keyword thi s to refer to the calling object itself (§ 10.4). 

■ To apply class abstraction to develop software (§10.5). 

■ To explore the differences between the procedural paradigm 
and object-oriented paradigm (§10.6). 

■ To develop classes for modeling composition 
relationships (§10.7). 

■ To design programs using the object-oriented paradigm 
(§§10.8-10.10). 

■ To design classes that follow the class-design 
guidelines (§10.11). 
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1 0.1 Introduction 

The preceding two chapters introduced objects and classes. You learned how to define 
classes, create objects, and use objects from several classes in the Java API (e.g., Date, 
Random, String, StringBuilder, File, Scanner, PrintWriter). This book's 
approach is to teach problem solving and fundamental programming techniques before 
object-oriented programming. This chapter will show how procedural and object-oriented 
programming differ. You will see the benefits of object-oriented programming and learn to 
use it effectively. 

Our focus here is on class design. We will use several examples to illustrate the advantages 
of the object-oriented approach. The examples involve designing new classes and using them 
in applications. We first introduce some language features supporting these examples. 

10.2 Immutable Objects and Classes 

Normally, you create an object and allow its contents to be changed later. Occasionally it is desir- 
able to create an object whose contents cannot be changed, once the object is created. We call 
immutable object such an object an immutable object and its class an immutable class. The Stri ng class, for exam- 

immutable class pie, is immutable. If you deleted the set method in the Circle class in Listing 8.9, the class 

would be immutable, because radius is private and cannot be changed without a set method. 

If a class is immutable, then all its data fields must be private and it cannot contain public 
set methods for any data fields. A class with all private data fields and no mutators is not nec- 
essarily immutable. For example, the following Student class has all private data fields and 
no set methods, but it is not an immutable class. 

Student class 1 public class Student { 

2 private int id; 

3 private String name; 

4 private java.util .Date dateCreated; 
5 

6 public Student(int ssn, String newName) { 

7 i d = ssn ; 

8 name = newName; 

9 dateCreated = new java.util .Date () ; 
10 } 

11 

12 public int getldfj { 

13 return id; 

14 } 
15 

16 public String getNameO { 

17 return name; 

18 } 
19 

20 public java. uti 1 . Date getDateCreatedO { 

21 return dateCreated; 

22 } 

23 } 

As shown in the code below, the data field dateCreated is returned using the getDate- 
CreatedO method. This is a reference to a Date object. Through this reference, the content 
for dateCreated can be changed. 

public class Test { 

public static void main(String[] args) { 

Student student = new Student(111223333 , "John") ; 
java.util .Date dateCreated = student. getDateCreated () ; 
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dateCreated . setTi me(200000) ; // Now dateCreated field is changed! 

} 

} 

For a class to be immutable, it must meet the following requirements: 

■ all data fields private; 

■ no mutator methods; 

■ no accessor method that returns a reference to a data field that is mutable. 

10.3 The Scope of Variables 

Chapter 5, "Methods," discussed local variables and their scope rules. Local variables are 
declared and used inside a method locally. This section discusses the scope rules of all the 
variables in the context of a class. 

Instance and static variables in a class are referred to as the class 's variables or data fields. 
A variable defined inside a method is referred to as a local variable. The scope of a class's 
variables is the entire class, regardless of where the variables are declared. A class's variables 
and methods can appear in any order in the class, as shown in Figure 10.1(a). The exception is 
when a data field is initialized based on a reference to another data field. In such cases, the 
other data field must be declared first, as shown in Figure 10.1(b). For consistency, this book 
declares data fields at the beginning of the class. 



public class Circle { 

public double findArea() { 

return radius * radius * Math. PI; 

} 

private double radius = 1; 



(a) variable radi us and method f i ndAreaO can be 
declared in any order 



public class Foo { 
private int i ; 
private int j = i + 1; 

} 



(b) i has to be declared before j because j 's initial 
value is dependent on i . 



Figure 10.1 Members of a class can be declared in any order, with one exception. 



You can declare a class's variable only once, but you can declare the same variable name in 
a method many times in different nonnesting blocks. 

If a local variable has the same name as a class's variable, the local variable takes prece- 
dence and the class's variable with the same name is hidden. For example, in the following 
program, x is defined as an instance variable and as a local variable in the method. 

public class Foo { 

private int x = 0; // Instance variable 
private int y = 0; 

public Foo() { 
} 

public void p() { 

int x = 1; // Local variable 
System . out . pri ntl n("x = " + x) ; 
System . out . pri ntl n("y = " + y) ; 

} 

} 



What is the printout for f . p () , where f is an instance of Foo? The printout for f . p () is 1 for 
x and for y. Here is why: 
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■ x is declared as a data field with the initial value of in the class, but is also declared 
in the method p() with an initial value of 1. The latter x is referenced in the 
System. out. println statement. 

■ y is declared outside the method p(), but is accessible inside it. 
# Tip 

To avoid confusion and mistakes, do not use the names of instance or static variables as local 
variable names, except for method parameters. 

10.4 The this Reference 

The this keyword is the name of a reference that refers to a calling object itself. One of its 
hidden data fields common uses is to reference a class's hidden data fields. For example, a data-field name is 

often used as the parameter name in a set method for the data field. In this case, the data field 
is hidden in the set method. You need to reference the hidden data-field name in the method 
in order to set a new value to it. A hidden static variable can be accessed simply by using the 
ClassName.StaticVariable reference. A hidden instance variable can be accessed by 
using the keyword this, as shown in Figure 10.2(a). 



public class Foo { 
int i = 5; 

static double k = 0; 

void setl(int i) { 
this.i = i ; 

} 



} 



static void setK(double k) { 
Foo . k = k ; 

} 



Suppose that fl and f2 are two objects of Foo. 

Invoking fl.setl(lO) is to execute 
this.i = 10, where this refers fl 

Invoking f2.setl(45) is to execute 
this.i = 45, where this refers f2 



(a) (b) 

Figure 10.2 The keyword this refers to the calling object that invokes the method. 



The thi s keyword gives us a way to refer to the object that invokes an instance method within 
the code of the instance method. The line thi s . i = i means "assign the value of parameter i to the 
data field i of the calling object." The keyword thi s refers to the object that invokes the instance 
method setl, as shown in Figure 10.2(b). The line Foo . k = k means that the value in parameter k 
is assigned to the static data field k of the class, which is shared by all the objects of the class, 
call another constructor Another common use of the this keyword is to enable a constructor to invoke another 

constructor of the same class. For example, you can rewrite the Ci rcl e class as follows: 



public class Circle { 
private double radius; 

public Ci rcle(double radius) { 
this. radius = radius; 

} ■ — *" thi s must be explicitly used to reference the data 

field radius of the object being constructed 

pub! ic Ci rcle() { 
thisCl.0); 

} C *~ this is used to invoke another constructor 

public double getArea() { 

return this. radius * this. radius * Math. PI; 
} | I 

' Every instance variable belongs to an instance represented by thi s, 

which is normally omitted 
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The line thi s (1 . 0) in the second constructor invokes the first constructor with a doubl e 
value argument. 

^ Tip 

[f a class has multiple constructors, it is better to implement them using this(arg-l ist) as 
much as possible. In general, a constructor with no or fewer arguments can invoke the construc- 
tor with more arguments using this(arg-1 ist). This often simplifies coding and makes the 
class easier to read and to maintain. 

§ Note 

Java requires that the this(arg-1 ist) statement appear first in the constructor before any 
other statements. 

10.5 Class Abstraction and Encapsulation 

In Chapter 5, "Methods," you learned about method abstraction and used it in program devel- 
opment. Java provides many levels of abstraction. Class abstraction is the separation of class class abstraction 
implementation from the use of a class. The creator of a class describes it and lets the user 
know how it can be used. The collection of methods and fields that are accessible from outside 
the class, together with the description of how these members are expected to behave, serves as 
the class's contract. As shown in Figure 10.3, the user of the class does not need to know how 
the class is implemented. The details of implementation are encapsulated and hidden from the 
user. This is known as class encapsulation. For example, you can create a Ci rcle object and class encapsulation 
find the area of the circle without knowing how the area is computed. 



Class implementation 
is like a black box 
hidden from the clients 



Class 


Class Contract 
(signatures of 
public methods and 
public constants) 




Clients use the 
class through the 
contract of the class 





Figure 10.3 Class abstraction separates class implementation from the use of the class. 

Class abstraction and encapsulation are two sides of the same coin. Many real-life exam- 
ples illustrate the concept of class abstraction. Consider, for instance, building a computer 
system. Your personal computer has many components — a CPU, memory, disk, motherboard, 
fan, and so on. Each component can be viewed as an object that has properties and methods. 
To get the components to work together, you need know only how each component is used 
and how it interacts with the others. You don't need to know how the components work inter- 
nally. The internal implementation is encapsulated and hidden from you. You can build a 
computer without knowing how a component is implemented. 

The computer-system analogy precisely mirrors the object-oriented approach. Each com- 
ponent can be viewed as an object of the class for the component. For example, you might 
have a class that models all kinds of fans for use in a computer, with properties such as fan 
size and speed and methods such as start and stop. A specific fan is an instance of this class 
with specific property values. 

As another example, consider getting a loan. A specific loan can be viewed as an object of 
a Loan class. Interest rate, loan amount, and loan period are its data properties, and comput- 
ing monthly payment and total payment are its methods. When you buy a car, a loan object is 
created by instantiating the class with your loan interest rate, loan amount, and loan period. 
You can then use the methods to find the monthly payment and total payment of your loan. As 
a user of the Loan class, you don't need to know how these methods are implemented. 

Listing 2.8, ComputeLoan.java, presented a program for computing loan payments. The 
program cannot be reused in other programs. One way to fix this problem is to define static 
methods for computing monthly payment and total payment. However, this solution has limi- 
tations. Suppose you wish to associate a date with the loan. The ideal way is to create an 




Video Note 
The Loan class 
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Loan 

-annual InterestRate : double 
-numberOfYears : int 
-loanAmount: double 
-loanDate: java.util .Date 

+Loan() 

+Loan (annual Inte restRate : doubl e , 
numberOfYears: int, loanAmount: 
doubl e) 

+getAnnual InterestRate() : double 

+getNumberOfYears() : int 

+getLoanAmount() : double 

+getl_oanDate() : java.util .Date 

+setAnnual InterestRate( 

annual InterestRate : double): void 

+setNumberOf Years ( 

numberOfYears: int): void 

+set LoanAmount ( 

loanAmount: double): void 

+getMonthlyPayment() : double 

+getTotal PaymentQ : double 



Figure 10.4 The Loan class models the properties and behaviors of loans. 



object that ties the properties for loan information and date together. Figure 10.4 shows the 
UML class diagram for the Loan class. 

The UML diagram in Figure 10.4 serves as the contract for the Loan class. Throughout 
this book, you will play the roles of both class user and class developer. The user can use the 
class without knowing how the class is implemented. Assume that the Loan class is available. 
We begin by writing a test program that uses the Loan class (Listing 10.1). 

Listing 10. 1 Test LoanCl ass. java 

1 import java.util .Scanner; 

2 

3 public class TestLoanCl ass { 

4 /** Main method */ 

5 public static void main(String[] args) { 

6 // Create a Scanner 

7 Scanner input = new Scanner(System.in) ; 
8 

9 // Enter yearly interest rate 

10 System. out. print( 

11 "Enter yearly interest rate, for example, 8.25: ") ; 

12 double annual InterestRate = i nput . nextDoubl e() ; 
13 

14 // Enter number of years 

15 System . out . pri nt("Enter number of years as an integer: ") ; 

16 int numberOfYears = i nput . nextlntO ; 
17 

18 // Enter loan amount 

19 System . out . pri nt("Enter loan amount, for example, 120000.95: ") ; 



The annual interest rate of the loan (default: 2.5). 
The number of years for the loan (default: 1). 
The loan amount (default: 1000). 
The date this loan was created. 

Constructs a default Loan object. 

Constructs a loan with specified interest rate, years, 
and loan amount. 

Returns the annual interest rate of this loan. 
Returns the number of the years of this loan. 
Returns the amount of this loan. 
Returns the date of the creation of this loan. 
Sets a new annual interest rate to this loan. 

Sets a new number of years to this loan. 

Sets a new amount for this loan. 

Returns the monthly payment of this loan. 
Returns the total payment of this loan. 
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20 
21 
22 
23 
24 
25 
26 
27 
28 
29 
30 
31 

32 } 



double "loanAmount = input. nextDoubleO ; 

// Create a Loan object 
Loan loan = 

new Loan(annualInterestRate, numberOfYears , loanAmount); 

// Display loan date, monthly payment, and total payment 
System . out . pri ntf ("The loan was created on %s\n" + 

"The monthly payment is %.2f\nThe total payment is %.2f\n", 
1 oan . getLoanDateO . toStri ng() , loan . getMonthly Payment () , 
1 oan . getTotal Payment () ) ; 



create Loan object 



invoke instance method 
invoke instance method 



Enter yearly interest rate, for example, 8.25: 2.5 j^ 1 

Enter number of years as an integer: 5 h Enter 

Enter loan amount, for example, 120000.95: 1000 jEfc 
The loan was created on Sat Dun 10 21:12:50 EDT 2006 
The monthly payment is 17.74 
The total payment is 1064.84 



The main method reads interest rate, payment period (in years), and loan amount; creates a 
Loan object; and then obtains the monthly payment (line 29) and total payment (line 30) 
using the instance methods in the Loan class. 

The Loan class can be implemented as in Listing 10.2. 

Listing 10.2 Loan.java 

1 public class Loan { 

2 private double annual InterestRate ; 

3 private int numberOfYears; 

4 private double loanAmount; 

5 private java.util .Date loanDate; 
6 

7 /** Default constructor */ 

8 public Loan() { no-arg constructor 

9 this(2.5, 1, 1000); 
10 } 

11 

12 /** Construct a loan with specified annual interest rate, 

13 number of years, and loan amount 

14 */ 

15 public Loan(double annual InterestRate , int numberOfYears, constructor 

16 double loanAmount) { 

17 this . annual InterestRate = annual InterestRate ; 

18 this . numberOfYears = numberOfYears; 

19 this . 1 oanAmount = loanAmount; 

20 loanDate = new java.util .Date() ; 

21 } 
22 

23 /** Return annual InterestRate */ 

24 public double getAnnual InterestRateO { 

25 return annual InterestRate ; 

26 } 
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27 

28 /** Set a new annual InterestRate */ 

29 public void setAnnual InterestRate (double annual InterestRate) { 

30 this . annual InterestRate = annual InterestRate ; 

31 } 
32 

33 /** Return numberOfYears */ 

34 public int getNumberOfYears () { 

35 return numberOfYears; 

36 } 
37 

38 /** Set a new numberOfYears */ 

39 public void setNumberOfYears(int numberOfYears) { 

40 this . numberOfYears = numberOfYears; 

41 } 
42 

43 /** Return loanAmount */ 

44 public double getLoanAmountO { 

45 return loanAmount; 

46 } 
47 

48 /** Set a newloanAmount */ 

49 public void setLoanAmount(double loanAmount) { 

50 this . 1 oanAmount = loanAmount; 

51 } 
52 

53 /** Find monthly payment */ 

54 public double getMonthlyPaymentO { 

55 double monthl ylnterestRate = annual InterestRate / 1200; 

56 double monthl yPayment = loanAmount * monthlylnterestRate / (1 - 

57 (Math.pow(l / (1 + monthlylnterestRate), numberOfYears * 12))); 

58 return monthl yPayment ; 

59 } 
60 

61 /** Find total payment */ 

62 public double getTotal PaymentO { 

63 double total Payment = getMonthlyPaymentO * numberOfYears * 12; 

64 return total Payment ; 

65 } 
66 

67 /** Return loan date */ 

68 public java. uti 1 . Date getLoanDateO { 

69 return loanDate; 

70 } 

71 } 

From a class developer's perspective, a class is designed for use by many different customers. 
In order to be useful in a wide range of applications, a class should provide a variety of ways 
for customization through constructors, properties, and methods. 

The Loan class contains two constructors, four get methods, three set methods, and the 
methods for finding monthly payment and total payment. You can construct a Loan object by 
using the no-arg constructor or the one with three parameters: annual interest rate, number of 
years, and loan amount. When a loan object is created, its date is stored in the 1 oanDate field. 
The getLoanDate method returns the date. The three get methods, getAnnual Interest, 
getNumberOfYears, and getLoanAmount, return annual interest rate, payment years, and 
loan amount, respectively. All the data properties and methods in this class are tied to a specific 
instance of the Loan class. Therefore, they are instance variables or methods. 
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^jj§t Important Pedagogical Tip 

The UML diagram for the Loan class is shown in Figure 10.4- Students should begin by writing a 
test program that uses the Loan class even though they don't know how the Loan class is imple- 
mented. This has three benefits: 

■ It demonstrates that developing a class and using a class are two separate tasks. 

■ It enables you to skip the complex implementation of certain classes without interrupting 
the sequence of the book. 

■ It is easier to learn how to implement a class if you are familiar with the class through using it. 

For all the examples from now on, you may first create an object from the class and try to use its 
methods and then turn your attention to its implementation. 

10.6 Object-Oriented Thinking 

Chapters 1-7 introduced fundamental programming techniques for problem solving using 
loops, methods, and arrays. The study of these techniques lays a solid foundation for object- 
oriented programming. Classes provide more flexibility and modularity for building reusable 
software. This section improves the solution for a problem introduced in Chapter 3 using the 
object-oriented approach. From the improvements, you will gain insight on the differences 
between procedural and object-oriented programming and see the benefits of developing 
reusable code using objects and classes. 

Listing 3.5, ComputeBMI.java, presented a program for computing body mass index. The 
code cannot be reused in other programs. To make it reusable, define a static method to com- 
pute body mass index as follows: 

public static double getBMI (double weight, double height) 

This method is useful for computing body mass index for a specified weight and height. How- 
ever, it has limitations. Suppose you need to associate the weight and height with a person's 
name and birth date. You may declare separate variables to store these values. But these val- 
ues are not tightly coupled. The ideal way to couple them is to create an object that contains 
them. Since these values are tied to individual objects, they should be stored in instance data 
fields. You can define a class named BMI, as shown in Figure 10.5. 

The get methods for these data fields 
are provided in the class, but omitted in the j 
UML diagram for brevity. 



The name of the person. 

The age of the person. 

The weight of the person in pounds. 

The height of the person in inches. 

Creates a BMI object with the specified 
name, age, weight, and height. 

Creates a BMI object with the specified 
name, weight, height, and a default age 20. 

Returns the BMI 

Returns the BMI status (e.g., normal, 
overweight, etc.) 




Video Note 

The BMI class 




-weight: double 
-height: double 

+BMI(name: String, age: int, weight: 
double, height: double) 

+BMI(name: String, weight: double, 
height: double) 

+getBMI(): double 
+getStatus() : String 



Figure 10.5 The BMI class encapsulates BMI information. 
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Assume that the BMI class is available. Listing 10.3 gives a test program that uses this 
class. 

Listing 10.3 UseBMIClass. java 

1 public class UseBMIClass { 

2 public static void main(String[] args) { 
create an object 3 BMI bmi 1 = new BMI ("John Doe", 18, 145, 70); 

invoke instance method 4 System . out . pri ntl n ("The BMI for " + bmil.getName() + " is " 

5 + bmil.getBMIO + " " + bmil. getStatusO ) ; 

6 

create an object 7 BMI bmi 2 = new BMI("Peter King", 215, 70); 

invoke instance method 8 System . out . pri ntl n ("The BMI for " + bmi 2 . getName() + " is " 

9 + bmi2.getBMI() + *' " + bmi 2 . getStatus() ) ; 

10 } 

11 } 




The BMI for John Doe is 20.81 normal weight 

The BMI for Peter King is 30.85 seriously overweight 



constructor 



constructor 



getBMI 



getStatus 



Line 3 creates an object bmi 1 for John Doe and line 7 creates an object bmi 2 for Peter King. 
You can use the instance methods getNameO, getBMI (), and getStatusO to return the 
BMI information in a BMI object. 

The BMI class can be implemented as in Listing 10.4. 

Listing 10.4 BMI. java 



1 

2 
3 
4 
5 
6 
7 
8 
9 
10 
11 
12 
13 
14 
15 
16 
17 
18 
19 
20 
21 
22 
23 
24 
25 
26 
27 
28 
29 
30 



public class BMI { 
private String name; 
private int age; 

private double weight; // in pounds 
private double height; // in inches 

public static final double KILOGRAMS PER POUND = 0.45359237; 
public static final double METERS_PER INCH = 0.0254; 



int age, double weight, double height) { 



public BMI(String name, 
this. name = name; 
this. age = age; 
this. weight = weight; 
this. height = height; 

} 



public BMI (String name, double weight, double height) { 
this(name, 20, weight, height); 

} 

public double getBMI () { 

double bmi = weight * KIL0GRAMS_PER_P0UND / 

((height * METERS_PER_INCH) * (height * METERS_PER_INCH)) ; 
return Math . round (bmi * 100) / 100.0; 

} 

public String getStatusO { 
double bmi = getBMI (); 
if (bmi < 16) 

return "seriously underweight"; 
else if (bmi < 18) 
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31 return "underweight"; 

32 else if (bmi < 24) 

33 return "normal weight"; 

34 else if (bmi < 29) 

35 return "overweight"; 

36 else if (bmi < 35) 

37 return "seriously overweight"; 

38 else 

39 return "gravely overweight"; 

40 } 
41 

42 public String getName() { 

43 return name; 

44 } 
45 

46 public int getAge() { 

47 return age; 

48 } 
49 

50 public double getWeight() { 

51 return weight; 

52 } 
53 

54 public double getHeight() { 

55 return height; 

56 } 



57 } 

The mathematic formula for computing the BMI using weight and height is given in §3.10. 
The instance method getBMIO returns the BMI. Since the weight and height are instance 
data fields in the object, the getBMIO method can use these properties to compute the BMI 
for the object. 

The instance method getStatusO returns a string that interprets the BMI. The interpre- 
tation is also given in §3.10. 

This example demonstrates the advantages of the object-oriented paradigm over the 
procedural paradigm. The procedural paradigm focuses on designing methods. The object- Procedural vs. Object- 
oriented paradigm couples data and methods together into objects. Software design using the Oriented Paradigms 
object-oriented paradigm focuses on objects and operations on objects. The object-oriented 
approach combines the power of the procedural paradigm with an added dimension that inte- 
grates data with operations into objects. 

In procedural programming, data and operations on the data are separate, and this method- 
ology requires sending data to methods. Object-oriented programming places data and the 
operations that pertain to them in an object. This approach solves many of the problems inher- 
ent in procedural programming. The object-oriented programming approach organizes pro- 
grams in a way that mirrors the real world, in which all objects are associated with both 
attributes and activities. Using objects improves software reusability and makes programs 
easier to develop and easier to maintain. Programming in Java involves thinking in terms of 
objects; a Java program can be viewed as a collection of cooperating objects. 

10.7 Object Composition 

An object can contain another object. The relationship between the two is called composition. 
In Listing 10.4, you defined the BMI class to contain a String data field. The relationship 
between BMI and String is composition. 

Composition is actually a special case of the aggregation relationship. Aggregation models 
has-a relationships and represents an ownership relationship between two objects. The owner 
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object is called an aggregating object and its class an aggregating class. The subject object is 
called an aggregated object and its class an aggregated class. 

An object may be owned by several other aggregating objects. If an object is exclusively 
composition owned by an aggregating object, the relationship between them is referred to as composition. 

For example, "a student has a name" is a composition relationship between the Student class 
and the Name class, whereas "a student has an address" is an aggregation relationship between 
the Student class and the Address class, since an address may be shared by several stu- 
dents. In UML, a filled diamond is attached to an aggregating class (e.g., Student) to denote 
the composition relationship with an aggregated class (e.g., Name), and an empty diamond is 
attached to an aggregating class (e.g., Student) to denote the aggregation relationship with 
an aggregated class (e.g., Address), as shown in Figure 10.6. 

Composition Aggregation 



Name 



. 1 l\ /l 1..3 . 
J m Student fj Address | 



Figure 10.6 A student has a name and an address. 



multiplicity Each class involved in a relationship may specify a multiplicity. A multiplicity could be a 

number or an interval that specifies how many objects of the class are involved in the rela- 
tionship. The character * means an unlimited number of objects, and the interval m . . n means 
that the number of objects should be between m and n, inclusive. In Figure 10.6, each student 
has only one address, and each address may be shared by up to 3 students. Each student has 
one name, and a name is unique for each student. 

An aggregation relationship is usually represented as a data field in the aggregating class. 
For example, the relationship in Figure 10.6 can be represented as follows: 



public class Name { 
} 



Aggregated class 



public class Student { 
private Name name; 
private Address address; 



Aggregating class 



public class Address { 



} 



Aggregated class 



Aggregation may exist between objects of the same class. For example, a person may have 
a supervisor. This is illustrated in Figure 10.7. 



Person 



Supervisor 



Figure 10.7 A person may have a supervisor. 



In the relationship "a person has a supervisor," as shown in Figure 10.7, a supervisor can 
be represented as a data field in the Person class, as follows: 



public class Person { 

// The type for the data is the class itself 
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private Person supervisor; 



} 

If a person may have several supervisors, as shown in Figure 10.8(a), you may use an array to 
store supervisors, as shown in Figure 10.8(b). 



public class Person { 

private Person [] supervisors; 

} 

(a) (b) 
Figure 10.8 A person may have several supervisors. 

HH Note 

Since aggregation and composition relationships are represented using classes in similar ways, aggregation or composition 

many texts don't differentiate them and call both compositions. 



Person 


^ 1 




m 





Supervisor 



10.8 Designing the Course Class 

This book's philosophy is teaching by example and learning by doing. The book provides a 
wide variety of examples to demonstrate object-oriented programming. The next three sec- 
tions offer additional examples on designing classes. 

Suppose you need to process course information. Each course has a name and has students 
enrolled. You should be able to add/drop a student to/from the course. You can use a class to 
model the courses, as shown in Figure 10.9. 



Course 

-courseName: String 
-students: String[] 
-numberOf Students : int 



+Course(courseName : String) 
+getCourseName() : String 
+addStudent(student : String): void 
+dropStudent(student : String): void 
+getStudents() : String[] 
+getNumber0f Students O : int 



The name of the course. 

An array to store the students for the course. 

The number of students (default: 0). 

Creates a course with the specified name. 

Returns the course name. 

Adds a new student to the course. 

Drops a student from the course. 

Returns the students for the course. 

Returns the number of students for the course. 



Figure 10.9 The Course class models the courses. 



A Course object can be created using the constructor Course(String name) by pass- 
ing a course name. You can add students to the course using the addStudent (String stu- 
dent) method, drop a student from the course using the dropStudent(String student) 
method, and return all the students for the course using the getStudentsO method. Sup- 
pose the class is available; Listing 10.5 gives a test class that creates two courses and adds stu- 
dents to them. 
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Listing 10.5 TestCourse. java 



create a course 



add a student 



number of students 
return students 



1 
2 
3 
4 
5 
6 
7 
8 
9 
10 
11 
12 
13 
14 
15 
16 
17 
18 
19 
20 
21 
22 
23 



public class TestCourse { 

public static void main(String[] args) { 

Course coursel = new Course("Data Structures"); 
Course course2 = new Course ("Database Systems"); 

coursel. addStudent("Peter Jones") ; 
coursel. addStudent("Brian Smith") ; 
coursel. addStudent("Anne Kennedy") ; 

course2 . addStudent("Peter Jones") ; 
course2 . addStudent("Steve Smith") ; 

System. out. println("Number of students in coursel: 

+ coursel. getNumberOf Students () ) ; 
String[] students = coursel. getStudents() ; 
for (int i = 0; i < coursel. getNumberOf StudentsO ; 

System. out . pri nt(students [i ] + ", ") ; 

System . out . pri ntl n () ; 

System . out . pri nt("Number of students in course2: " 
+ course2 .getNumberOfStudentsQ) ; 



i++) 



Number of students in coursel: 3 

Peter Dones, Brian Smith, Anne Kennedy, 

Number of students in course2: 2 



The Course class is implemented in Listing 10.6. It uses an array to store the students for the 
course. For simplicity, assume that the maximum course enrollment is 100. The array is cre- 
ated using new Stri ng [100] in line 3. The addStudent method (line 10) adds a student to 
the array. Whenever a new student is added to the course, numberOfStudents is increased 
(line 12). The getStudents method returns the array. The dropStudent method (line 27) 
is left as an exercise. 



Listing 10.6 Course. java 



create students 



add a course 



return students 



1 
2 
3 
4 
5 
6 
7 
8 
9 
10 
11 
12 
13 
14 
15 
16 
17 
18 



public class Course { 

private String courseName; 

private String[] students = new String[100] ; 
private int numberOfStudents; 

public Course(Stri ng courseName) { 
this . courseName = courseName; 

} 

public void addStudent(Stri ng student) { 
students [numberOfStudents] = student; 
numberOf Student s++; 

} 

public String[] getStudents () { 
return students; 

} 
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19 public int getNumberOfStudentsO { number of students 

20 return numbe rOf Students ; 

21 } 
22 

23 public String getCourseNameO { 

24 return courseName ; 

25 } 
26 

27 public void dropStudent(Stri ng student) { 

28 // Left as an exercise in Exercise 10.9 

29 } 

30 } 

The array size is fixed to be 100 (line 3) in Listing 10.6. You can improve it to automatically 
increase the array size in Exercise 10.9. 

When you create a Course object, an array object is created. A Course object contains a 
reference to the array. For simplicity, you can say that the Course object contains the array. 

The user can create a Course and manipulate it through the public methods addStudent, 
dropStudent, getNumberOfStudents, and getStudents. However, the user doesn't 
need to know how these methods are implemented. The Course class encapsulates the inter- 
nal implementation. This example uses an array to store students. You may use a different 
data structure to store students. The program that uses Course does not need to change as 
long as the contract of the public methods remains unchanged. 

10.9 Designing a Class for Stacks 

Recall that a stack is a data structure that holds data in a last-in, first-out fashion, as shown in 
Figure 10.10. 
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Figure 10.10 A stack holds data in a last-in, first-out fashion. 



Stacks have many applications. For example, the compiler uses a stack to process method stack 
invocations. When a method is invoked, its parameters and local variables are pushed into a 
stack. When a method calls another method, the new method's parameters and local variables 
are pushed into the stack. When a method finishes its work and returns to its caller, its associ- 
ated space is released from the stack. 

You can define a class to model stacks. For simplicity, assume the stack holds the i nt val- 
ues. So, name the stack class StackOflntegers. The UML diagram for the class is shown 
in Figure 10.11. 

Suppose that the class is available. Let us write a test program in Listing 10.7 that uses the 

class to create a stack (line 3), stores ten integers 0, 1, 2, . . . , and 9 (line 6), and displays them Video Note 

. ,,■ n x The StackOflnteqer class 

m reverse order (line 9). 3 
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StackOflntegers 



-elements: int[] 
-size: int 



+StackOf Integers () 
+StackOfIntegers(capacity : int) 
+empty() : bool ean 
+peek(): int 

+push (value: int): void 
+pop() : i nt 
+getSize(): int 



An array to store integers in the stack. 
The number of integers in the stack. 

Constructs an empty stack with a default capacity of 16. 
Constructs an empty stack with a specified capacity. 
Returns true if the stack is empty. 
Returns the integer at the top of the stack without 

removing it from the stack. 
Stores an integer into the top of the stack. 

Removes the integer at the top of the stack and returns it. 
Returns the number of elements in the stack. 



Figure 10.1 1 The StackOflntegers class encapsulates the stack storage and provides the 
operations for manipulating the stack. 



create a stack 
push to stack 
pop from stack 



Listing 10.7 TestStackOf Integers . java 



1 

2 
3 
4 
5 
6 
7 
8 
9 
10 

11 } 



public class TestStackOf Integers { 

public static void main(String[] args) { 

StackOflntegers stack = new StackOflntegersO ; 

for (int i = 0; i < 10; i++) 
stack. push(i ) ; 



while (! stack. empty ()) 

System. out . pri nt (stack. pop () 



"); 




9876543210 



How do you implement the StackOflntegers class? The elements in the stack are stored in 
an array named el ements. When you create a stack, the array is also created. The no-arg 
constructor creates an array with the default capacity of 16. The variable size counts the 
number of elements in the stack, and size - 1 is the index of the element at the top of the 
stack, as shown in Figure 10.12. For an empty stack, size is 0. 

The StackOflntegers class is implemented in Listing 10.8. The methods empty (), 
peek(), pop(), and getSizeO are easy to implement. To implement push(int value), 
assign value to el ements [size] if size < capacity (line 24). If the stack is full (i.e., 



elements[capacity - 1] 



elements[size - 1] 



elements[l] 
elements[0] 



top 



capacity 



bottom 



Figure 10.12 The StackOflntegers class encapsulates the stack storage and provides 
the operations for manipulating the stack. 
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size >= capacity), create a new array of twice the current capacity (line 19), copy the con- 
tents of the current array to the new array (line 20), and assign the reference of the new array to 
the current array in the stack (line 21). Now you can add the new value to the array (line 24). 

Listing 10.8 StackOf Integers . java 

1 public class StackOf Integers { 

2 private int[] elements; 

3 private int size; 

4 public static final int DEFAULT_CAPACITY = 16; max capacity 16 

5 

6 /** Construct a stack with the default capacity 16 */ 

7 public StackOflntegersO { 

8 this(DEFAULT_CAPACITY) ; 

9 } 
10 

11 /** Construct a stack with the specified maximum capacity */ 

12 public Stack0flntegers(int capacity) { 

13 elements = new int [capaci ty] ; 

14 } 
15 

16 /** Push a new integer into the top of the stack */ 

17 public void push(int value) { 

18 if (size >= el ements . 1 ength) { 

19 int[] temp = new int [el ements . 1 ength * 2]; double the capacity 

20 System. arraycopy (el ements , 0, temp, 0, el ements . 1 ength) ; 

21 elements = temp; 

22 } 
23 

24 el ements [si ze++] = value; add to stack 

25 } 
26 

27 /** Return and remove the top element from the stack */ 

28 public int pop() { 

29 return el ements [--si ze] ; 

30 } 
31 

32 /** Return the top element from the stack */ 

33 public int peek() { 

34 return el ements [si ze - 1]; 

35 } 
36 

37 /** Test whether the stack is empty */ 

38 public boolean empty () { 

39 return size == 0; 

40 } 
41 

42 /** Return the number of elements in the stack */ 

43 public int getSize() { 

44 return size; 

45 } 

46 } 

10.10 Designing the GuessDate Class 

Listing 3.3, GuessBirthday.java, and Listing 7.6, GuessBirthdayUsingArray.java, presented 
two programs for guessing birthdays. Both programs use the same data developed with the 
procedural paradigm. The majority of code in these two programs is to define the five sets of 
data. You cannot reuse the code in these two programs. To make the code reusable, design a 
class to encapsulate the data, as defined in Figure 10.13. 
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GuessDate 



-dates: int[][][] 



+getVa1ue(setNo: int, row: int, 
col umn : 1 nt~) : i nt 



The static array to hold dates. 

Returns a date at the specified row and column 
in a given set. 



Figure 10.13 The GuessDate class defines data for guessing birthdays. 

Note that getVal ue is defined as a static method because it is not dependent on a specific 
object of the GuessDate class. The GuessDate class encapsulates dates as a private mem- 
ber. The user of this class need not know how dates is implemented or even that the dates 
field exists in the class. All the user needs to know is how to use this method to access dates. 
Suppose this class is available. As shown in §3.5, there are five sets of dates. Invoking 
getVal ue(setNo, row, column) returns the date at the specified row and column in the 
given set. For example, getVal ue(l , , 0) returns 2. 

Assume that the GuessDate class is available. Listing 10.9 is a test program that uses this 
class. 



invoke static method 



invoke static method 



Listing 10.9 UseGuessDateClass. java 

1 import java. util .Scanner; 

2 

3 public class UseGuessDateClass { 

4 public static void main(String[] args) { 
int date = 0; // Date to be determined 
int answer; 



5 

6 

7 

8 

9 
10 
11 
12 
13 
14 
15 
16 
17 
18 
19 
20 
21 
22 
23 
24 
25 
26 
27 

28 } 



// Create a Scanner 

Scanner input = new Scanner(System.in) ; 

for (int i = 0; i < 5; i++) { 

System. out . pri ntl n("Is your birthday in Set" + (i + 1) + "?") ; 
for (int j = 0; j < 4; j++) { 
for (int k = 0; k < 4; k++) 

System. out. print (GuessDate. getVal ue (i , j, k) + " ") ; 
System. out. pri ntln() ; 

} 



System. out. pri nt("\nEnter for No and 1 for Yes: 
answer = i nput . nextlntO ; 

if (answer == 1) 

date += GuessDate . getVal ue(i , 0, 0); 



System. out. pri ntl n("Your birthday is " + date); 



); 



Is your birthday in Setl? 
13 5 7 
9 11 13 15 
17 19 21 23 
25 27 29 31 

Enter for No and 1 for Yes: 
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Is your 


birthday in Set2? 




2 3 6 


7 




10 11 


14 15 




18 19 


22 23 




26 27 


30 31 




Enter 


for No and 1 for Yes: 


1 1^ Enter 


Is your 


birthday in Set3? 




4 5 6 


7 




12 13 


14 15 




20 21 


22 23 




28 29 


30 31 




Enter 


for No and 1 for Yes: 


Enter 


Is your 


birthday in Set4? 




8 9 10 11 




12 13 


14 15 




24 25 


26 27 




28 29 


30 31 




Enter 


for No and 1 for Yes: 


■ 

1 |^ Enter 


Is your 


birthday in Set5? 




16 17 


18 19 




20 21 


22 23 




24 25 


26 27 




28 29 


30 31 




Enter 


for No and 1 for Yes: 


1 |^ Enter 


Your birthday is 26 





Since getVal ue is a static method, you don't need to create an object in order to invoke it. 
GuessDate . getVal ue(i , j , k) (line 15) returns the date at row i and column k in Set i . 
The GuessDate class can be implemented in Listing 10.10. 

Listing 10. 10 GuessDate. java 

1 public class GuessDate { 

2 private final static int[][][] dates = { staticfield 



3 


{{ 1, 


3, 


5, 


7}, 


4 


{ 9, 


11, 


13, 


15}, 


5 


{17, 


19, 


21, 


23}, 


6 


{25, 


27, 


29, 


31}}, 


7 


{{ 2, 


3, 


6, 


7}, 


8 


{10, 


11, 


14, 


15}, 


9 


{18, 


19, 


22, 


23}, 


10 


{26, 


27, 


30, 


31}}, 


11 


{{ 4, 


5, 


. 


7}, 


12 


{12, 


13, 


14, 


15}, 


13 


{20, 


21, 


22, 


23}, 


14 


{28, 


29, 


30, 


31}}, 


15 


{{ 8, 


9, 


10, 


11}, 


16 


{12, 


13, 


14, 


15}, 


17 


{24, 


25, 


26, 


27}, 


18 


{28, 


29, 


30, 


31}}, 


19 


{{16, 


17, 


18, 


19}, 


20 


{20, 


21, 


22, 


23}, 


21 


{24, 


25, 


26, 


27}, 


22 


{28, 


29, 


30, 


31}}}; 
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23 

24 /** Prevent the user from creating objects from GuessDate */ 

25 private GuessDateO { 

26 } 
27 

28 /** Return a date at the specified row and column in a given set */ 

29 public static int getVal ue(int setNo, int k, int j) { 

30 return dates [setNo] [k] [j] ; 

31 } 

32 } 

This class uses a three-dimensional array to store dates (lines 2-22). You may use a differ- 
ent data structure (i.e., five two-dimensional arrays for representing five sets of numbers). The 
implementation of the getVal ue method will change, but the program that uses GuessDate 
does not need to change as long as the contract of the public method getVal ue remains 
unchanged. This shows the benefit of data encapsulation. 

The class defines a private no-arg constructor (line 25) to prevent the user from creating 
objects for this class. Since all methods are static in this class, there is no need to create 
objects from this class. 

10.11 Class Design Guidelines 

You have learned how to design classes from the preceding two examples and from many 
other examples in the preceding chapters. Here are some guidelines. 

1 0.1 I.I Cohesion 

A class should describe a single entity, and all the class operations should logically fit 
together to support a coherent purpose. You can use a class for students, for example, but you 
should not combine students and staff in the same class, because students and staff are differ- 
ent entities. 

A single entity with too many responsibilities can be broken into several classes to separate 
responsibilities. The classes String, StringBuilder, and StringBuffer all deal with 
strings, for example, but have different responsibilities. The String class deals with 
immutable strings, the StringBuilder class is for creating mutable strings, and the 
StringBuffer class is similar to StringBuilder except that StringBuffer contains 
synchronized methods for updating strings. 

1 0.1 1.2 Consistency 

Follow standard Java programming style and naming conventions. Choose informative names 
for classes, data fields, and methods. A popular style is to place the data declaration before the 
constructor and place constructors before methods. 

Choose names consistently. It is not a good practice to choose different names for similar 
operations. For example, the length () method returns the size of a String, a 
StringBuilder, and a StringBuffer. It would be inconsistent if different names were 
used for this method in these classes. 

In general, you should consistently provide a public no-arg constructor for constructing a 
default instance. If a class does not support a no-arg constructor, document the reason. If no 
constructors are defined explicitly, a public default no-arg constructor with an empty body is 
assumed. 

If you want to prevent users from creating an object for a class, you may declare a private 
constructor in the class, as is the case for the Math class and the GuessDate class. 
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1 0.1 1.3 Encapsulation 

A class should use the private modifier to hide its data from direct access by clients. This encapsulating data fields 
makes the class easy to maintain. 

Provide a get method only if you want the field to be readable, and provide a set method 
only if you want the field to be updateable. For example, the Course class provides a get 
method for courseName, but no set method, because the user is not allowed to change the 
course name, once it is created. 



1 0.1 1.4 Clarity 

Cohesion, consistency, and encapsulation are good guidelines for achieving design clarity. 
Additionally, a class should have a clear contract that is easy to explain and easy to understand. 

Users can incorporate classes in many different combinations, orders, and environments. 
Therefore, you should design a class that imposes no restrictions on what or when the user can 
do with it, design the properties in a way that lets the user set them in any order and with any 
combination of values, and design methods that function independently of their order of occur- 
rence. For example, the Loan class contains the properties loanAmount, numberOfYears, 
and annual InterestRate. The values of these properties can be set in any order. 

Methods should be defined intuitively without generating confusion. For example, the 
substring(int beginlndex, int endlndex) method in the String class is somehow 
confusing. The method returns a substring from beginlndex to endlndex - 1, rather than 
endlndex. 

You should not declare a data field that can be derived from other data fields. For example, 
the following Person class has two data fields: birthDate and age. Since age can be 
derived from bi rthDate, age should not be declared as a data field. 

public class Person { 

private java.util .Date birthDate; 
private int age; 



easy to explain 



independent methods 



intuitive meaning 



independent properties 



} 



1 0.1 1.5 Completeness 

Classes are designed for use by many different customers. In order to be useful in a wide 
range of applications, a class should provide a variety of ways for customization through 
properties and methods. For example, the String class contains more than 40 methods that 
are useful for a variety of applications. 



1 0. 1 1.6 Instance vs. Static 

A variable or method that is dependent on a specific instance of the class should be an 
instance variable or method. A variable that is shared by all the instances of a class should be 
declared static. For example, the variable numberOfObjects in Circle3 in Listing 8.9, is 
shared by all the objects of the SimpleCirclel class and therefore is declared static. A 
method that is not dependent on a specific instance should be declared as a static method. For 
instance, the getNumberOf Objects method in Ci rcl e3 is not tied to any specific instance 
and therefore is declared as a static method. 

Always reference static variables and methods from a class name (rather than a reference 
variable) to improve readability and avoid errors. 

Do not pass a parameter from a constructor to initialize a static data field. It is better to use 
a set method to change the static data field. The class in (a) below is better replaced by (b). 
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public class SomeThing { 
private int tl; 
private static int t2 ; 

public SomeThi ng(int tl) { 

} 

public static void setT2(int t2) { 
SomeThi ng.t2 = t2 ; 

} 

} 

(a) (b) 

Instance and static are integral parts of object-oriented programming. A data field or 
method is either instance or static. Do not mistakenly overlook static data fields or methods. It 
common design error is a common design error to define an instance method that should have been static. For exam- 

ple, the factorial (int n) method for computing the factorial of n should be defined 
static, because it is independent of any specific instance. 

A constructor is always instance, because it is used to create a specific instance. A static 
variable or method can be invoked from an instance method, but an instance variable or 
method cannot be invoked from a static method. 

Key Terms 



class abstraction 347 
class encapsulation 347 
class's contract 347 
class's variable 345 

Chapter Summary 

1 . Once it is created, an immutable object cannot be modified. To prevent users from 
modifying an object, you may define immutable classes. 

2. The scope of instance and static variables is the entire class, regardless of where the 
variables are declared. Instance and static variables can be declared anywhere in the 
class. For consistency, they are declared at the beginning of the class. 

3. The keyword this can be used to refer to the calling object. It can also be used inside 
a constructor to invoke another constructor of the same class. 

4. The procedural paradigm focuses on designing methods. The object-oriented para- 
digm couples data and methods together into objects. Software design using the 
object-oriented paradigm focuses on objects and operations on objects. The object- 
oriented approach combines the power of the procedural paradigm with an added 
dimension that integrates data with operations into objects. 

Review Questions 

Section 10.2 

1 0. 1 If a class contains only private data fields and no set methods, is the class immutable? 

1 0.2 If all the data fields in a class are private and primitive type, and the class contains 
no set methods, is the class immutable? 



public class SomeThing { 
private int tl; 
private static int t2 ; 

public SomeThing (int tl, int t2) { 

} 

} 



immutable class 344 
immutable object 344 
stack 357 
this keyword 346 
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10.3 Is the following class immutable? 

public class A { 

private int[] values; 

public int[] getValuesO { 
return values; 

} 

} 

10.4 If you redefine the Loan class in Listing 10.2 without set methods, is the class 
immutable? 



Section 10.3 

10.5 What is the output of the following program? 

public class Foo { 

private static int i = 0; 
private static int j = 0; 

public static void man n(Stri ng [] args) { 
int i = 2; 
int k = 3; 

{ 

int j = 3; 

System. out. pn'ntln("i + j is " + i + j); 

} 

k = i + j ; 

System. out . pri ntl n("k is " + k) ; 
System. out . pri ntl n("j is " + j); 

} 

} 



Section 10.4 

10.6 Describe the role of the this keyword. What is wrong in the following code? 



1 public class C { 

2 private int p; 

3 

4 public C() { 

5 System. out . pri ntl n("C s no-arg constructor invoked"); 

6 this(0); 

7 } 
8 

9 public C(int p) { 

10 p = p; 

11 } 

12 

13 public void setP(int p) { 

14 p = p; 

15 } 

16 } 
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Programming Exercises 



1 0. 1 * (The Time class) Design a class named Ti me. The class contains: 

■ Data fields hour, minute, and second that represent a time. 

■ A no-arg constructor that creates a Ti me object for the current time. (The values 
of the data fields will represent the current time.) 

■ A constructor that constructs a Ti me object with a specified elapsed time since 
midnight, Jan 1, 1970, in milliseconds. (The values of the data fields will repre- 
sent this time.) 

■ A constructor that constructs a Time object with the specified hour, minute, and 
second. 

■ Three get methods for the data fields hour, minute, and second, respec- 
tively. 

■ A method named setTime(long elapseTime) that sets a new time for the 
object using the elapsed time. 

Draw the UML diagram for the class. Implement the class. Write a test program 
that creates two Time objects (using new Time() and new Time(555 550000)) 
and display their hour, minute, and second. 

(Hint: The first two constructors will extract hour, minute, and second from the 
elapsed time. For example, if the elapsed time is 555550 seconds, the hour is 10, 
the minute is 19, and the second is 9. For the no-arg constructor, the current time 
can be obtained using System . currentTimeMil 1 s(), as shown in Listing 2.6, 
ShowCurrentTime.java.) 

1 0.2 (The BMI class) Add the following new constructor in the BMI class: 

/** Construct a BMI with the specified name, age, weight, 
* feet and inches 

V 

public BMI(String name, int age, double weight, double feet, 
double inches) 

1 0.3 (The Mylnteger class) Design a class named Mylnteger. The class contains: 

■ An int data field named value that stores the int value represented by this 
object. 

■ A constructor that creates a Mylnteger object for the specified i nt value. 

■ A get method that returns the i nt value. 

■ Methods isEvenO, isOddO, and isPrimeO that return true if the value is 
even, odd, or prime, respectively. 

■ Static methods isEven(int), isOdd(int), and isPrime(int) that return 
true if the specified value is even, odd, or prime, respectively. 

■ Static methods isEven(Mylnteger), isOdd (Mylnteger), and 
isPrime(Mylnteger) that return true if the specified value is even, odd, or 
prime, respectively. 

■ Methods equal s(int) and equal s (Mylnteger) that return true if the 
value in the object is equal to the specified value. 

■ A static method parselnt (char [] ) that converts an array of numeric charac- 
ters to an int value. 

■ A static method parselnt(String) that converts a string into an int value. 

Draw the UML diagram for the class. Implement the class. Write a client program 
that tests all methods in the class. 
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1 0.4 (The MyPoint class) Design a class named MyPoi nt to represent a point with x- 
and y-coordinates. The class contains: 

■ Two data fields x and y that represent the coordinates with get methods. 

■ A no-arg constructor that creates a point (0, 0). 

■ A constructor that constructs a point with specified coordinates. 

■ Two get methods for data fields x and y, respectively. 

■ A method named di stance that returns the distance from this point to another 
point of the MyPoint type. 

■ A method named di stance that returns the distance from this point to another 
point with specified x- and y-coordinates. 

Draw the UML diagram for the class. Implement the class. Write a test program 
that creates two points (0, 0) and (10, 30. 5) and displays the distance between 
them. 

10.5* (Displaying the prime factors) Write a program that prompts the user to enter a 
positive integer and displays all its smallest factors in decreasing order. For exam- 
ple, if the integer is 120, the smallest factors are displayed as 5, 3, 2, 2, 2. Use the 
StackOflntegers class to store the factors (e.g., 2, 2, 2, 3, 5) and retrieve and 
display them in reverse order. 

1 0.6* (Displaying the prime numbers) Write a program that displays all the prime num- 
bers less than 120 in decreasing order. Use the StackOflntegers class to store 
the prime numbers (e.g., 2, 3, 5, . . . ) and retrieve and display them in reverse 
order. 

10.7** (Game: ATM machine) Use the Account class created in Exercise 8.7 to simulate 
an ATM machine. Create ten accounts in an array with id 0, 1, . . . , 9, and initial 
balance $100. The system prompts the user to enter an id. If the id is entered 
incorrectly, ask the user to enter a correct id. Once an id is accepted, the main 
menu is displayed as shown in the sample run. You can enter a choice 1 for view- 
ing the current balance, 2 for withdrawing money, 3 for depositing money, and 4 
for exiting the main menu. Once you exit, the system will prompt for an id again. 
So, once the system starts, it will not stop. 
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1 0.8** (Financial: the Tax class) Exercise 7.12 writes a program for computing taxes 
using arrays. Design a class named Tax to contain the following instance data 
fields: 

■ int fil ingStatus: One of the four tax-filing statuses: — single filer, 1 — 
married filing jointly, 2 — married filing separately, and 3 — head of household. 
Use the public static constants SINGLE_FILER (0), MARRIED_JOINTLY (1), 
MARRI ED_SEPARATE LY (2), HEAD_0F_H0USEH0LD (3) to represent the 
status. 

■ i nt [] [] brackets: Stores the tax brackets for each filing status. 

■ doubl e [] rates: Stores the tax rates for each bracket. 

■ doubl e taxabl elncome: Stores the taxable income. 

Provide the get and set methods for each data field and the getTaxO method 
that returns the tax. Also provide a no-arg constructor and the constructor 
Tax(fil ingStatus , brackets, rates, taxabl elncome). 

Draw the UML diagram for the class. Implement the class. Write a test program 
that uses the Tax class to print the 2001 and 2009 tax tables for taxable income 
from $50,000 to $60,000 with intervals of $1,000 for all four statuses. The tax 
rates for the year 2009 were given in Table 3.2. The tax rates for 2001 are shown 
in Table 10.1. 
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Table 10.1 2001 United States Federal Personal Tax Rates 



Tax Married filing jointly Married filing 

rate Single filers or qualifying widow(er) separately Head of household 

15% Up to $27,050 Up to $45,200 UP to $22,600 UP to $36,250 

27.5% $27,05 1-$65,550 $45,201-$109,250 $22,601-$54,625 $36,25 1-$93,650 

30.5% $65,551-$136,750 $109,251-$166,500 $54,626-$83,250 $93,651-$151,650 

35.5% $136,751-$297,350 $166,501-$297,350 $83,251-148,675 $151,651-$297,350 

39.1% $297,351 or more $297,351 or more $148,676 or more $297,351 or more 

1 0.9** {The Course class) Revise the Course class as follows: 

■ The array size is fixed in Listing 10.6. Improve it to automatically increase the 
array size by creating a new larger array and copying the contents of the cur- 
rent array to it. 

■ Implement the dropStudent method. 

■ Add a new method named cl ear () that removes all students from the course. 

Write a test program that creates a course, adds three students, removes one, and 
displays the students in the course. 

10.10* {Game: The CuessDate class) Modify the GuessDate class in Listing 10.10. 
Instead of representing dates in a three-dimensional array, use five two-dimen- 
sional arrays to represent the five sets of numbers. So you need to declare: 

}; 
}; 
}; 
}; 

. }; 

1 0. 1 I * {Geometry: The Circle2D class) Define the Ci rcl e2D class that contains: 

■ Two doubl e data fields named x and y that specify the center of the circle 
with get methods. 

■ A data field radius with a get method. 

■ A no-arg constructor that creates a default circle with (0, 0) for (x, y) and 1 for 
radius. 

■ A constructor that creates a circle with the specified x, y, and radius. 

■ A method getAreaO that returns the area of the circle. 

■ A method getPeri meter () that returns the perimeter of the circle. 

■ A method contains (double x, double y) that returns t rue if the spec- 
ified point (x, y) is inside this circle. See Figure 10.14(a). 

■ A method contains (Ci rcl e2D ci rcl e) that returns true if the specified 
circle is inside this circle. See Figure 10.14(b). 

■ A method overlaps (Ci rcl e2D ci rcl e) that returns true if the specified 
circle overlaps with this circle. See Figure 10.14(c). 

Draw the UML diagram for the class. Implement the class. Write a test program 
that creates a Ci rcl e2D object cl (new Ci rcl e2D(2 , 2 , 5.5)), displays its area 
and perimeter, and displays the result of cl. contains (3, 3), 
cl.contains(new Circle2D(4, 5, 10. 5)), and cl. overlaps (new Cir- 
cle2D(3, 5, 2.3)). 



private 


static 


int[][] 


setl = 


{{1, 


3, 5, 


7}, ... 


private 


static 


int[][] 


set2 = 


{{2, 


3, 6, 


7}, ... 


private 


static 


int[][] 


set3 = 


{{4, 


5, 6, 


7}, ... 


private 


static 


int[][] 


set4 = 


{{8, 


9, 10, 


11}, ... 


private 


static 


int[][] 


set5 = 


{{16, 


17, 18, 


19}, .. 
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(a) (b) (c) 

Figure 10.14 (a) A point is inside the circle, (b) A circle is inside another circle, (c) A circle 
overlaps another circle. 

10.12* (Geometry: The MyRectangle2D class) Define the MyRectangle2D class 
that contains: 

■ Two doubl e data fields named x and y that specify the center of the rec- 
tangle with get and set methods. (Assume that the rectangle sides are par- 
allel to x- or y- axes.) 

■ The data fields width and height with get and set methods. 

■ A no-arg constructor that creates a default rectangle with (0, 0) for (x, y) 
and 1 for both width and height. 

■ A constructor that creates a rectangle with the specified x, y, width, and 
height. 

■ A method getAreaO that returns the area of the rectangle. 

■ A method getPeri meter O that returns the perimeter of the rectangle. 

■ A method contains (double x, double y) that returns true if the 
specified point (x, y) is inside this rectangle. See Figure 10.15(a). 

■ A method contains (MyRectangle2D r) that returns true if the speci- 
fied rectangle is inside this rectangle. See Figure 10.15(b). 

■ A method overl aps(MyRectangl e2D r) that returns true if the speci- 
fied rectangle overlaps with this rectangle. See Figure 10.15(c). 

Draw the UML diagram for the class. Implement the class. Write a test program 
that creates a MyRectangle2D object rl (new MyRectangle2D(2 , 2, 5.5, 
4.9)), displays its area and perimeter, and displays the result of 
rl.contains(3, 3), rl. contains (new MyRectangle2D(4, 5, 10.5, 
3 .2)), and rl. overlaps (new MyRectangle2D(3 , 5, 2.3, 5.4)). 



(a) 



(b) 



(e) 



Figure 10.15 (a) A point is inside the rectangle, (b) A rectangle is inside another rectangle, 
(c) A rectangle overlaps another rectangle. 



10.13*** (Geometry: The Triangle2D class) Define the Tr iang 7 e2D class that con- 
tains: 

■ Three points named pi, p2, and p3 with the type MyPoint with get and 
set methods. MyPoint is defined in Exercise 10.4. 

■ A no-arg constructor that creates a default triangle with points (0, 0), (1, 1), 
and (2, 5). 

■ A constructor that creates a triangle with the specified points. 

■ A method getAreaO that returns the area of the triangle. 

■ A method getPerimeter () that returns the perimeter of the triangle. 
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■ A method contai ns (MyPoi nt p) that returns true if the specified point p 
is inside this triangle. See Figure 10.16(a). 

■ A method contai ns(Triangl e2D t) that returns true if the specified tri- 
angle is inside this triangle. See Figure 10.16(b). 

■ A method overlaps(Triangle2D t) that returns true if the specified tri- 
angle overlaps with this triangle. See Figure 10.16(c). 




(a) (b) (c) 

Figure 10.16 (a) A point is inside the triangle, (b) A triangle is inside another triangle, (c) 
A triangle overlaps another triangle. 

Draw the UML diagram for the class. Implement the class. Write a test program 
that creates a Triangle2D objects tl (new Triangle2D(new MyPoint(2 . 5 , 
2), new MyPoi nt (4 . 2 , 3), MyPoint(5, 3 . 5))), displays its area and perime- 
ter, and displays the result of tl .contains(3 , 3), rl. contains (new Trian- 
gle2D(newMyPoint(2.9, 2), new MyPoint(4, 1), MyPoint(l, 3.4))), 
and tl.overlaps(new Triangle2D(new MyPoint(2, 5.5), new 
MyPoint(4, -3), MyPoint(2, 6.5))). 

(Hint: For the formula to compute the area of a triangle, see Exercise 5.19. Use 
the java . awt . geo . Li ne2D class in the Java API to implement the contai ns 
and overlaps methods. The Line2D class contains the methods for checking 
whether two line segments intersect and whether a line contains a point, etc. 
Please see the Java API for more information on Line2D. To detect whether a 
point is inside a triangle, draw three dashed lines, as shown in Figure 10.17. If the 
point is inside a triangle, each dashed line should intersect a side only once. If a 
dashed line intersects a side twice, then the point must be outside the triangle.) 




(a) (b) 
Figure 10.1 7 (a) A point is inside the triangle, (b) A point is outside the triangle. 

1 0.14* (The MyDate class) Design a class named MyDate. The class contains: 

■ Data fields year, month, and day that represent a date. 

■ A no-arg constructor that creates a MyDate object for the current date. 

■ A constructor that constructs a MyDate object with a specified elapsed time 
since midnight, Jan 1, 1970, in milliseconds. 

■ A constructor that constructs a MyDate object with the specified year, month, 
and day. 

■ Three get methods for the data fields year, month, and day, respectively. 

■ A method named setDate (long el apsedTi me) that sets a new date for the 
object using the elapsed time. 
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Draw the UML diagram for the class. Implement the class. Write a test program that 
creates two Date objects (using new Date() and new Date(34355555133101L)) 
and display their hour, minute, and second. 

(Hint: The first two constructors will extract year, month, and day from the elapsed 
time. For example, if the elapsed time is 561555550000 milliseconds, the year is 
1987, the month is 10, and the day is 17. For the no-arg constructor, the current 
time can be obtained using System. currentTimeMi 11 s(), as shown in Listing 
2.6, ShowCurrentTime.java.) 



Chapter 11 



Inheritance and Polymorphism 

Objectives 

■ To develop a subclass from a superclass through inheritance (§11.2). 

■ To invoke the superclass's constructors and methods using the super keyword (§11.3). 

■ To override instance methods in the subclass (§1 1.4). 

■ To distinguish differences between overriding and overloading (§1 1.5). 

■ To explore the toStringO method in the Object class (§11.6). 

■ To discover polymorphism and dynamic 
binding (§§11.7-11.8). 

■ To describe casting and explain why explicit downcasting 
is necessary (§1 1.9). 

■ To explore the equal s method in the Ob j ect class (§11.10). 

■ To store, retrieve, and manipulate objects in 
an ArrayList (§11.11). 

■ To implement a Stack class using ArrayList (§11.12). 

■ To enable data and methods in a superclass accessible 
in subclasses using the protected visibility modifier (§11.13) 

■ To prevent class extending and method overriding 
using the f i nal modifier (§11.14). 
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I I.I Introduction 

Object-oriented programming allows you to derive new classes from existing classes. This is 
why inheritance? called inheritance. Inheritance is an important and powerful feature in Java for reusing soft- 

ware. Suppose you are to define classes to model circles, rectangles, and triangles. These 
classes have many common features. What is the best way to design these classes so to avoid 
redundancy and make the system easy to comprehend and easy to maintain? The answer is to 
use inheritance. 



.2 Superclasses and Subclasses 



You use a class to model objects of the same type. Different classes may have some common 
properties and behaviors, which can be generalized in a class that can be shared by other 
SScSass hierarchy "las-, Inheritance enables you to define a general class and later extend it to more special- 

ized classes. The specialized classes inherit the properties and methods from the general class. 

Consider geometric objects. Suppose you want to design the classes to model geometric 
objects such as circles and rectangles. Geometric objects have many common properties and 
behaviors. They can be drawn in a certain color, filled or unfilled. Thus a general class 



GeometricObject 


-color: String 




-filled: boolean 




-dateCreated : java.util. 


Date 


+Geometri cObjectO 




+Ceomet ri cOb j ect (col o r : 


Stri ng , 


filled: boolean) 




+getColor(): String 




+setColor(color: String) 


: voi d 


-i-i s Filled () : boolean 




+setFi lied (filled: boolean): void 


+getDateCreated() : java. 


util .Date 


+toString(): String 





-radius: double 



+Ci rcle() 

+Ci rcle(radius: double) 

+Ci rcle(radius: double, color: String, 
filled: boolean) 

+getRadius() : double 

+setRadius(radius: double): void 
+getArea(): double 
+getPerimeter() : double 
+getDiameter() : double 
+printCi rcle() : void 



The color of the object (default: whi te). 

Indicates whether the object is filled with a color (default: f al se). 
The date when the object was created. 

Creates a Ceometri cObject. 

Creates a Ceometri cObject with the specified color and filled 
values. 
Returns the color. 
Sets a new color. 
Returns the f i lied property. 
Sets a new f i 1 1 ed property. 
Returns the dateCreated. 
Returns a string representation of this object. 



Rectangle 



-width: double 
-height: double 



+Rectangle() 

+Rectangle(width: double, height: double) 

+Rectangle(width: double, height: double 
color: String, filled: boolean) 

+getWi dth () : doubl e 

+setWidth (width: double): void 

+getHeight() : double 

+setHeight(height: double): void 

+getArea() : double 

+getPerimeter() : double 



Figure I I.I The GeometricObject class is the superclass for Ci rcle and Rectangle. 
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GeometricObject can be used to model all geometric objects. This class contains the proper- 
ties col or and f il 1 ed and their appropriate get and set methods. Assume that this class also 
contains the dateCreated property and the getDateCreatedO and toStringO methods. 
The toStri ng() method returns a string representation for the object. Since a circle is a special 
type of geometric object, it shares common properties and methods with other geometric objects. 
Thus it makes sense to define the Ci rcl e class that extends the GeometricObject class. Like- 
wise, Rectangle can also be declared as a subclass of GeometricObject. Figure 11.1 shows 
the relationship among these classes. An arrow pointing to the superclass is used to denote the 
inheritance relationship between the two classes involved. 

In Java terminology, a class CI extended from another class C2 is called a subclass, and C2 
is called a superclass. A superclass is also referred to as a parent class, or a base class, and a 
subclass as a child class, an extended class, or a derived class. A subclass inherits accessible 
data fields and methods from its superclass and may also add new data fields and methods. 

The Circle class inherits all accessible data fields and methods from the Geometric- 
Object class. In addition, it has a new data field, radius, and its associated get and set 
methods. It also contains the getAreaO, getPerimeter (), and getDiameter () methods 
for returning the area, perimeter, and diameter of the circle. 

The Rectangle class inherits all accessible data fields and methods from the 
GeometricObject class. In addition, it has the data fields width and height and the asso- 
ciated get and set methods. It also contains the getAreaO and getPerimeter () meth- 
ods for returning the area and perimeter of the rectangle. 

The GeometricObject, Circle, and Rectangle classes are shown in Listings 11.1, 
11.2, and 11.3. 



subclass 
superclass 



Note 

To avoid naming conflict with the improved GeometricObject, Circle, and Rectangle 
classes introduced in the next chapter, name these classes GeometricObjectl, Circle4, 
and Rectanglel in this chapter. For convenience, we will still refer to them in the text as 
GeometricObject, Circle, and Rectangle classes. The best way to avoid naming conflict 
would be to place these classes in a different package. However, for simplicity and consistency, all 
classes in this book are placed in the default package. 



avoid naming conflict 



Listing 1 1 . 1 Geomet ri cOb j ectl . j ava 



i 

2 
3 
4 
5 
6 
7 
8 
9 
10 
11 
12 
13 
14 
15 
16 
17 
18 
19 
20 
21 
22 



public class GeometricObjectl { 
private String color = "white"; 
private boolean filled; 
private java.util .Date dateCreated; 

/** Construct a default geometric object */ 
public Geometri c0bjectl() { 

dateCreated = new java.util .DateO ; 

} 

/** Construct a geometric object with the specified color 

* and filled value */ 
public Geometri cObjectl(Stri ng Color, boolean filled) { 

dateCreated = new java.util .DateO ; 



this, 
this, 



color = 
filled 



col or ; 
= filled; 



} 



/** Return color */ 
public String getColorO 
return color; 

} 



data fields 



constructor 
date constructed 
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23 

24 /** Set a new color */ 

25 public void setColor(String color) { 

26 this. color = color; 

27 } 
28 

29 /** Return filled. Since filled is boolean, 

30 its get method is named isFilled */ 

31 public boolean isFilledO { 

32 return filled; 

33 } 
34 

35 /** Set a new filled */ 

36 public void setFi lied (boolean filled) { 

37 this. filled = filled; 

38 } 
39 

40 /** Get dateCreated */ 

41 public java. uti 1 . Date getDateCreatedO { 

42 return dateCreated; 

43 } 
44 

45 /** Return a string representation of this object */ 

46 public String toStringO { 

47 return "created on " + dateCreated + "\ncolor: " + color + 

48 " and filled: " + filled; 

49 } 

50 } 



Listing II. 2 Ci rcle4. java 



data fields 



constructor 



methods 



1 
2 
3 
4 
5 
6 
7 
8 
9 
10 
11 
12 
13 
14 
15 
16 
17 
18 
19 
20 
21 
22 
23 
24 
25 
26 
27 
28 
29 
30 



public class Circle4 extends Ceometri cObjectl { 
private double radius; 

public Ci rcle4() { 
} 

public Ci rcle4(double radius) { 
this. radius = radius; 

} 

public Ci rcle4(double radius, String color, boolean filled) { 
this. radius = radius; 
setColor(color) ; 
setFi lied (filled) ; 

} 

/** Return radius */ 
public double getRadius() { 
return radius; 

} 

/** Set a new radius */ 
public void setRadi us (double radius) { 
this. radius = radius; 

} 

/** Return area */ 
public double getArea() { 

return radius * radius * Math. PI; 

} 
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31 

32 /** Return diameter */ 

33 public double getDi ameterO { 

34 return 2 * radius; 

35 } 
36 

37 /** Return perimeter */ 

38 public double getPerimeterO { 

39 return 2 * radius * Math. PI; 

40 } 
41 

42 /* Print the circle info */ 

43 public void pri ntCi rcl e() { 

44 System. out. print1n("The circle is created " + getDateCreated() + 

45 " and the radius is " + radius); 

46 } 

47 } 

The Circle class extends the GeometricObject class (Listing 11.2) using the following 
syntax: 

Subclass Superclass 




public class Circle extends GeometricObject 

The keyword extends (line 1) tells the compiler that the Circle class extends the 
GeometricObject class, thus inheriting the methods getColor, setColor, isFilled, 
setFilled, and toString. 

The overloaded constructor Ci rcl e(doubl e radius, string color, boolean 
filled) is implemented by invoking the setColor and setFilled methods to set the 
color and filled properties (lines 11-15). These two public methods are defined in the 
base class GeometricObject and are inherited in Circle. So, they can be used in the 
derived class. 

You might attempt to use the data fields col or and f i 1 1 ed directly in the constructor as private member in base class 
follows: 

public Ci rcl e4 (double radius, String color, boolean filled) { 
this. radius = radius; 
this. color = color; // Illegal 
this. filled = filled; // Illegal 

} 

This is wrong, because the private data fields color and filled in the Geometric- 
Object class cannot be accessed in any class other than in the GeometricObject class 
itself. The only way to read and modify color and filled is through their get and set 
methods. 

The Rectangle class (Listing 11.3) extends the GeometricObject class (Listing 11.2) 
using the following syntax: 

Subclass Superclass 




public class Rectangle extends GeometricObject 
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data fields 



constructor 



methods 



The keyword extends (line 1) tells the compiler that the Rectangle class extends the 
GeometricObject class, thus inheriting the methods getColor, setColor, isFilled, 
setFilled, and toString. 

Listing 1 1.3 Rectanglel. java 



i 

2 
3 
4 
5 
6 
7 
8 
9 
10 
11 
12 
13 
14 
15 
16 
17 
18 
19 
20 
21 
22 
23 
24 
25 
26 
27 
28 
29 
30 
31 
32 
33 
34 
35 
36 
37 
38 
39 
40 
41 
42 
43 
44 
45 
46 
47 
48 
49 
50 



public class Rectanglel extends Ceometri cObjectl { 
private double width; 
private double height; 

public Rectangl el() { 
} 

public Rectanglel(double width, double height) { 
this. width = width; 
this. height = height; 

} 



public Rectanglel(double width, 
boolean filled) { 
this. width = width; 
this. height = height; 
setColor(color) ; 
setFilled (filled) ; 

} 

/** Return width */ 
public double getWidth() { 
return width; 

} 



/** Set a new width */ 
public void setWidth (double width) { 
this. width = width; 

} 

/** Return height */ 
public double getHeight() { 
return height; 

} 

/** Set a new height */ 
public void setHeight(double height) { 
this. height = height; 

} 

/** Return area */ 
public double getArea() { 
return width * height; 

} 

/** Return perimeter */ 
public double getPerimeter() { 
return 2 * (width + height); 

} 



double height, String color, 



} 



The code in Listing 1 1.4 creates objects of Ci rcl e and Rectangl e and invokes the methods 
on these objects. The toStringO method is inherited from the GeometricObject class 
and is invoked from a Ci rcl e object (line 4) and a Rectangl e object (line 10). 
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Listing 1 1 .4 TestCi rcl eRectangl e . j ava 



i 

2 
3 
4 
5 
6 
7 
8 
9 
10 
11 
12 
13 
14 
15 



public class TestCi rcl eRectangl e { 

public static void main(String[] args) { 
Circle4 circle = new Circle4(l); 

System. out. println("A circle " + ci rcle.toStringO ) ; 
System. out. println("The radius is " + ci rcl e . getRadi usO) ; 
System. out. println("The area is " + ci rcle.getAreaO) ; 
System. out. println("The diameter is " + ci rcl e . getDi ameterO ) ; 

Rectanglel rectangle = new Rectangl el(2 , 4); 



System . out . pri ntl n ("\nA rectangl e 
System. out. print! n ("The area is " 
System . out . pri ntl n ("The perimeter 
rectangle. getPerimeter() ) ; 



" + rectangl e . toStri ng() ) ; 
+ rectangl e . getAreaO ) ; 

is " + 



Ci rcl e object 
invoke toString 



Rectangl e object 
invoke toString 



A circle created on Thu Sep 24 20:31:02 EDT 2009 

color: white and filled: false 

The radius is 1.0 

The area is 3.141592653589793 

The diameter is 2.0 



A rectangle created on Thu Sep 24 20:31:02 EDT 2009 

color: white and filled: false 

The area is 8.0 

The perimeter is 12.0 



The following points regarding inheritance are worthwhile to note: 

■ Contrary to the conventional interpretation, a subclass is not a subset of its super- 
class. In fact, a subclass usually contains more information and methods than its more in subclass 
superclass. 

■ Private data fields in a superclass are not accessible outside the class. Therefore, they private data fields 
cannot be used directly in a subclass. They can, however, be accessed/mutated 

through public accessor/mutator if defined in the superclass. 

■ Not all is-a relationships should be modeled using inheritance. For example, a nonextensible is-a 
square is a rectangle, but you should not define a Square class to extend a 

Rectangl e class, because there is nothing to extend (or supplement) from a rec- 
tangle to a square. Rather you should define a Square class to extend the 
GeometricObject class. For class A to extend class B, A should contain more 
detailed information than B. 

■ Inheritance is used to model the is-a relationship. Do not blindly extend a class just no blind extension 
for the sake of reusing methods. For example, it makes no sense for a Tree class to 

extend a Person class, even though they share common properties such as height 
and weight. A subclass and its superclass must have the is-a relationship. 

■ Some programming languages allow you to derive a subclass from several classes. 
This capability is known as multiple inheritance. Java, however, does not allow mul- 
tiple inheritance. A Java class may inherit directly from only one superclass. This 
restriction is known as single inheritance. If you use the extends keyword to define 
a subclass, it allows only one parent class. Nevertheless, multiple inheritance can be 
achieved through interfaces, which will be introduced in §14.4, "Interfaces." 



multiple inheritance 
single inheritance 
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1 1.3 Using the super Keyword 

A subclass inherits accessible data fields and methods from its superclass. Does it inherit con- 
structors? Can superclass constructors be invoked from subclasses? This section addresses 
these questions and their ramification. 

§10.4, "The this Reference," introduced the use of the keyword this to reference the 
calling object. The keyword super refers to the superclass of the class in which super 
appears. It can be used in two ways: 

■ To call a superclass constructor. 

■ To call a superclass method. 

1 1.3.1 Calling Superclass Constructors 

The syntax to call a superclass constructor is: 
super(), or super (parameters) ; 

The statement super C) invokes the no-arg constructor of its superclass, and the statement 
super (arguments) invokes the superclass constructor that matches the arguments. The 
statement super () or super(arguments) must appear in the first line of the subclass con- 
structor; this is the only way to explicitly invoke a superclass constructor. For example, the 
constructor in lines 1 1-15 in Listing 11.2 can be replaced by the following code: 

public Ci rcle4 (double radius, String color, boolean filled) { 
super (col or, filled); 
this. radius = radius; 

} 

lit Caution 

You must use the keyword super to call the superclass constructor, and the call must be the first 
statement in the constructor. Invoking a superclass constructor's name in a subclass causes a 
syntax error. 

Note 

A constructor is used to construct an instance of a class. Unlike properties and methods, the con- 
structors of a superclass are not inherited in the subclass. They can only be invoked from the con- 
structors of the subclasses, using the keyword super. 

11.3.2 Constructor Chaining 

A constructor may invoke an overloaded constructor or its superclass constructor. If neither is 
invoked explicitly, the compiler automatically puts super () as the first statement in the con- 
structor. For example, 



public ClassNameO { 

// some statements 



public ClassName(double d) { 

// some statements 



Equivalent 



Equivalent 



public ClassNameO { 
super () ; 

// some statements 

} 



public ClassName(double d) { 
super () ; 

// some statements 

} 
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In any case, constructing an instance of a class invokes the constructors of all the superclasses 
along the inheritance chain. When constructing an object of a subclass, the subclass construc- 
tor first invokes its superclass constructor before performing its own tasks. If the superclass is 
derived from another class, the superclass constructor invokes its parent-class constructor 
before performing its own tasks. This process continues until the last constructor along the 
inheritance hierarchy is called. This is constructor chaining. constructor chaining 

Consider the following code: 

1 public class Faculty extends Employee { 

2 public static void main(String[] args) { 

3 new Facul ty() ; 

4 } 
5 

6 public Facul ty() { 

7 System. out. println("(4) Performs Faculty's tasks"); 

8 } 

9 } 
10 

11 class Employee extends Person { 

12 public EmployeeO { 

13 this("(2) Invoke Employee's overloaded constructor"); invoke overloaded 

14 System. out. pri ntl n("(3) Performs Employee's tasks ") ; constructor 

15 } 
16 

17 public Employee(Stri ng s) { 

18 System. out. println(s) ; 

19 } 

20 } 
21 

22 class Person { 

23 public PersonO { 

24 System. out. println("(l) Performs Person's tasks"); 

25 } 

26 } 



(1) Performs Person's tasks 

(2) Invoke Employee's overloaded constructor 

(3) Performs Employee's tasks 

(4) Performs Faculty's tasks 



The program produces the preceding output. Why? Let us discuss the reason. In line 3, new 
Facul ty() invokes Faculty's no-arg constructor. Since Faculty is a subclass of 
Employee, Employee's no-arg constructor is invoked before any statements in Faculty's 
constructor are executed. Employee's no-arg constructor invokes Employee's second con- 
structor (line 12). Since Employee is a subclass of Person, Person's no-arg constructor is 
invoked before any statements in Empl oyee's second constructor are executed. This process 
is pictured in the figure below. 
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|p Caution 

no-arg constructor If a class is designed to be extended, it is better to provide a no-arg constructor to avoid pro- 

gramming errors. Consider the following code: 

1 public class Apple extends Fruit { 

2 } 
3 

4 class Fruit { 

5 public Fruit(String name) { 

6 System. out. pri ntl n("Fruit ' s constructor is invoked"); 

7 } 

8 } 

Since no constructor is explicitly defined in Apple, Apple's default no-arg constructor is 
defined implicitly. Since Apple is a subclass of Fruit, Apple's default constructor automati- 
cally invokes Fruit's no-arg constructor. However, Fruit does not have a no-arg constructor, 
because Fruit has an explicit constructor defined. Therefore, the program cannot be compiled. 

$0 Design Guide 

no-arg constructor It is better to provide a no-arg constructor (if desirable) for every class to make the class easy to 

extend and to avoid errors. 



1 1.3.3 Calling Superclass Methods 

The keyword super can also be used to reference a method other than the constructor in the 
superclass. The syntax is like this: 

super .method(parameters) ; 

You could rewrite the pri ntCi rcl e() method in the Ci rcl e class as follows: 

public void pri ntCi rcl e() { 

System. out. pri ntl n ("The circle is created " + 

super. getDateCreated() + " and the radius is " + radius); 

} 

It is not necessary to put super before getDateCreatedO in this case, however, because 
getDateCreated is a method in the GeometricObject class and is inherited by the 
Ci rcl e class. Nevertheless, in some cases, as shown in the next section, the keyword super 
is needed. 



1 1.4 Overriding Methods 



A subclass inherits methods from a superclass. Sometimes it is necessary for the subclass to 
modify the implementation of a method defined in the superclass. This is referred to as 
method overriding method overriding. 

The toString method in the GeometricObject class returns the string representation 
for a geometric object. This method can be overridden to return the string representation for a 
circle. To override it, add the following new method in Listing 1 1.2, Circle4.java: 

1 public class Circle4 extends Ceometri cObjectl { 

2 // Other methods are omitted 
3 

4 /** Override the toString method defined in GeometricObject */ 

5 public String toStringO { 

toString in superclass 6 return super . toStri ng () + "\nradius is " + radius; 

7 } 

8 } 
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The toSt r i ng () method is defined in the Geomet r i cOb j ect class and modified in the Ci rcl e 
class. Both methods can be used in the Ci rcl e class. To invoke the toStri ng method defined in 
the Geomet ricObj ect class from the Circle class, use super . toStringO (line 6). 

Can a subclass of Ci rcle access the toString method defined in the GeometricObject 
class using a syntax such as super . super . toStringO? No. This is a syntax error. no super.super. 

Several points are worth noting: methodName() 

■ An instance method can be overridden only if it is accessible. Thus a private method override accessible instance 
cannot be overridden, because it is not accessible outside its own class. If a method method 

defined in a subclass is private in its superclass, the two methods are completely 
unrelated. 

■ Like an instance method, a static method can be inherited. However, a static method cannot override static method 
cannot be overridden. If a static method defined in the superclass is redefined in a 

subclass, the method defined in the superclass is hidden. The hidden static methods 
can be invoked using the syntax SuperCl assName . staticMethodName. 



11.5 Overriding vs. Overloading 

You have learned about overloading methods in §5.8. Overloading means to define multiple 
methods with the same name but different signatures. Overriding means to provide a new 
implementation for a method in the subclass. The method is already defined in the 
superclass. 

To override a method, the method must be defined in the subclass using the same signature 
and the same return type. 

Let us use an example to show the differences between overriding and overloading. In (a) 
below, the method p (double i) in class A overrides the same method defined in class B. In 
(b), however, the class B has two overloaded methods p (double i) and p(int i). The 
method p(doubl e i ) is inherited from B. 



public class Test { 

public static void main(String[] args) { 
A a = new A() ; 
a.p(10); 
a.p(lO.O); 

} 

} 

class B { 

public void p (double i) { 
System. out. println(i * 2); 

} 

} 

class A extends B { 

// This method overrides the method in B 
public void p (double i) { 
System . out . pri ntl n (i ) ; 

} 

} 



(a) 



public class Test { 

public static void main(Stn'ng[] args) { 
A a = new A() ; 
a.p(10); 
a.p(lO.O); 

} 

} 

class B { 

public void p (double i) { 

System. out. println(i * 2); 

} 

} 

class A extends B { 

// This method overloads the method in B 
public void p(int i) { 
System, out. pri ntl n(i) ; 

} 

} 



(b) 



When you run the Test class in (a), both a. p( 10) and a. p(10.0) invoke the p (double i) 
method defined in class A to display 10.0. When you run the Test class in (b), a.p(10) 
invokes the p(int i) method defined in class B to display 20, and a.p(10.0) invokes the 
p(doubl e i ) method defined in class A to display 10 . 0. 
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1 1.6 The Object Class and Its toStringO Method 

Every class in Java is descended from the java.lang. Object class. If no inheritance is 
specified when a class is defined, the superclass of the class is Object by default. For exam- 
ple, the following two class definitions are the same: 



public class ClassName { 
} 



Equivalent 



public class ClassName extends Object { 
} 



Classes such as String, StringBuilder, Loan, and GeometricObject are implicitly sub- 
classes of Object (as are all the main classes you have seen in this book so far). It is important 
to be familiar with the methods provided by the Ob j ect class so that you can use them in your 
classes. We will introduce the toString method in the Object class in this section. 
toStringO The signature of the toStringO method is 

public String toStringO 

string representation Invoking toStringO on an object returns a string that describes the object. By default, it 

returns a string consisting of a class name of which the object is an instance, an at sign (@), 
and the object's memory address in hexadecimal. For example, consider the following code 
for the Loan class defined in Listing 10.2: 

Loan loan = new LoanO; 

System . out . pri ntl n (1 oan . toSt ri ng () ) ; 

The code displays something like Loan@15037e5. This message is not very helpful or infor- 
mative. Usually you should override the toString method so that it returns a descriptive 
string representation of the object. For example, the toString method in the Object class 
was overridden in the GeometricObject class in lines 46-49 in Listing 11.1 as follows: 

public String toStringO { 

return "created on " + dateCreated + "\ncolor: " + color + 
" and filled: " + filled; 

} 



Note 

You can also pass an object to invoke System, out. pri ntl n(object) or System, out. 
print object pri nt (object) . This is equivalent to invoking System . out . pri ntl n (obj ect . toSt ri ng() ) 

or System . out . pri nt (object . toStri ng()) . So you could replace System . out . pri ntl n- 
(1 oan. toStringO) with System, out. pri ntl n (loan). 



1 1.7 Polymorphism 

The three pillars of object-oriented programming are encapsulation, inheritance, and 
polymorphism. You have already learned the first two. This section introduces 
polymorphism. 

First let us define two useful terms: subtype and supertype. A class defines a type. A type 
subtype defined by a subclass is called a subtype and a type defined by its superclass is called a supertype. 

supertype So, you can say that Circle is a subtype of GeometricObject and GeometricObject is a 

supertype for Ci rcl e. 
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The inheritance relationship enables a subclass to inherit features from its superclass with 
additional new features. A subclass is a specialization of its superclass; every instance of a 
subclass is also an instance of its superclass, but not vice versa. For example, every circle is a 
geometric object, but not every geometric object is a circle. Therefore, you can always pass an 
instance of a subclass to a parameter of its superclass type. Consider the code in Listing 11.5. 

Listing 11.5 Polymorph! smDemo . java 

1 public class Pol ymorphi smDemo { 

2 /** Main method */ 

3 public static void main(String[] args) { 

4 // Display circle and rectangle properties 

5 displayObject(new Ci rcle4(l, "red", false)); 

6 di spl ayObject(new Rectangl el(l , 1, "black", true)); 

7 } 
8 

9 /** Display geometric object properties */ 

10 public static void displayObject(GeometricObjectl object) { 

11 System. out. pri ntl n("Created on " + object . getDateCreatedO + 

12 ". Color is " + object. getColorO) ; 

13 } 

14 } 



Created on Mon Mar 09 19:25:20 EDT 2009. Color is white 
Created on Mon Mar 09 19:25:20 EDT 2009. Color is black 



Method displayObject (line 10) takes a parameter of the GeometricObject type. You 
can invoke displayObject by passing any instance of GeometricObject (e.g., new Cir- 
cle4(l, "red", false) andnew Rectanglel(l, 1, "black", f al se) in lines 5-6). An 
object of a subclass can be used wherever its superclass object is used. This is commonly known 

as polymorphism (from a Greek word meaning "many forms"). In simple terms, polymorphism what is polymorphism? 
means that a variable of a supertype can refer to a subtype object. 

1 1.8 Dynamic Binding 

A method may be defined in a superclass and overridden in its subclass. For example, the 
toStringO method is defined in the Object class and overridden in GeometricObjectl. 
Consider the following code: 

Object o = new Geometri cObjectO ; 
System . out . pri ntl n (o . toSt ri ng () ) ; 

Which toStringO method is invoked by o? To answer this question, we first introduce two 
terms: declared type and actual type. A variable must be declared a type. The type of a vari- 
able is called its declared type. Here o's declared type is Object. A variable of a reference 
type can hold a nul 1 value or a reference to an instance of the declared type. The instance 
may be created using the constructor of the declared type or its subtype. The actual type of the 
variable is the actual class for the object referenced by the variable. Here o's actual type is 
GeometricObject, since o references to an object created using new GeometricOb- 
ject(). Which toStringO method is invoked by o is determined by o's actual type. This 
is known as dynamic binding. 

Dynamic binding works as follows: Suppose an object o is an instance of classes Ci, C2, 
. . . , C n . b and C n , where Cj is a subclass of C 2 , C 2 is a subclass of C 3 , . . . , and C n _! is a subclass 
of C n , as shown in Figure 1 1.2. That is, C n is the most general class, and C! is the most specific 



polymorphic call 
polymorphic call 




declared type 
actual type 

dynamic binding 
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If o is an instance of Ci, o is also an 
instance of C2, C3, . . . , C n _i, and C n 

Figure 1 1 .2 The method to be invoked is dynamically bound at runtime. 

class. In Java, C n is the Object class. If o invokes a method p, the JVM searches the imple- 
mentation for the method p in Q, C2, • • • , C n _i, and C n , in this order, until it is found. Once an 
implementation is found, the search stops and the first-found implementation is invoked. 




Listing 1 1.6 gives an example to demonstrate dynamic binding. 



videoNote Listing 1 1.6 Dynami cBi ndi ngDemo . j ava 

polymorphism and dynamic 

binding demo 1 public class Dynami cBi ndi ngDemo { 

2 public static void main(String[] args) { 
polymorphic call 3 m(new GraduateStudentO) ; 

4 m(new StudentO); 

5 m(new PersonO) ; 

6 m(new ObjectO); 

7 } 
8 

9 public static void m(Object x) { 
dynamic binding 10 System . out . pri ntl n (x . toStri ng ()) ; 

11 } 

12 } 
13 

14 class GraduateStudent extends Student { 

15 } 
16 

17 class Student extends Person { 
override toStringO 18 public String toStringO { 

19 return "Student"; 

20 } 

21 } 
22 

23 class Person extends Object { 
override toStringO 24 public String toStringO { 

2 5 return "Person"; 

26 } 

27 } 



Student 
Student 
Person 

java.Iang.Object@130cl9b 



Method m (line 9) takes a parameter of the Object type. You can invoke m with any object 
(e.g., new GraduateStudent (), new StudentO, new PersonO, and new ObjectO) in 

lines 3-6). 

When the method m(0bject x) is executed, the argument x's toString method is 
invoked, x may be an instance of GraduateStudent, Student, Person, or Object. Classes 
GraduateStudent, Student, Person, and Object have their own implementations of the 
toString method. Which implementation is used will be determined by x's actual type at 
runtime. Invoking m(new GraduateStudent O) (line 3) causes the toString method 
defined in the Student class to be invoked. 



j ava. lang. Object 
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Invoking m(new StudentO) (line 4) causes the toString method defined in the 
Student class to be invoked. 

Invoking m(new Person ()) (line 5) causes the toString method defined in the Person 
class to be invoked. Invoking m(new ObjectO) (line 6) causes the toString method 
defined in the Object class to be invoked. 

Matching a method signature and binding a method implementation are two separate matching vs. binding 
issues. The declared type of the reference variable decides which method to match at compile 
time. The compiler finds a matching method according to parameter type, number of parame- 
ters, and order of the parameters at compile time. A method may be implemented in several 
subclasses. The JVM dynamically binds the implementation of the method at runtime, 
decided by the actual type of the variable. 



1 1.9 Casting Objects and the instanceof Operator 

You have already used the casting operator to convert variables of one primitive type to 
another. Casting can also be used to convert an object of one class type to another within an 
inheritance hierarchy. In the preceding section, the statement 

m(new StudentO) ; 

assigns the object new StudentO to a parameter of the Object type. This statement is 
equivalent to 

Object o = new StudentO; // Implicit casting 
m(o) ; 

The statement Object o = new StudentO, known as implicit casting, is legal because an 
instance of Student is automatically an instance of Object. 

Suppose you want to assign the object reference o to a variable of the Student type using 
the following statement: 

Student b = o; 

In this case a compile error would occur. Why does the statement Object o = new Stu- 
dentO work but Student b = o doesn't? The reason is that a Student object is always an 
instance of Object, but an Object is not necessarily an instance of Student. Even though 
you can see that o is really a Student object, the compiler is not clever enough to know it. To 
tell the compiler that o is a Student object, use an explicit casting. The syntax is similar to 
the one used for casting among primitive data types. Enclose the target object type in paren- 
theses and place it before the object to be cast, as follows: 

Student b = (Student)o; // Explicit casting 

It is always possible to cast an instance of a subclass to a variable of a superclass (known as 
upcasting), because an instance of a subclass is always an instance of its superclass. When 
casting an instance of a superclass to a variable of its subclass (known as downcasting), 
explicit casting must be used to confirm your intention to the compiler with the 
(Subcl assName) cast notation. For the casting to be successful, you must make sure that the 
object to be cast is an instance of the subclass. If the superclass object is not an instance of the 
subclass, a runtime CTassCastException occurs. For example, if an object is not an 
instance of Student, it cannot be cast into a variable of Student. It is a good practice, there- 
fore, to ensure that the object is an instance of another object before attempting a casting. This 
can be accomplished by using the instanceof operator. Consider the following code: 



implicit casting 



explicit casting 



upcasting 
downcasting 



ClassCastException 



instanceof 



Object myObject = new CircleO; 

... // Some lines of code 
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/** Perform casting if myObject is an instance of Circle */ 
if (myObject instanceof Circle) { 

System. out. println ("The circle diameter is " + 
((Ci rcle)myObject) . getDi ameterO) ; 

} 

You may be wondering why casting is necessary. Variable myObject is declared Object. 
The declared type decides which method to match at compile time. Using 
myObject . getDi ameterO would cause a compile error, because the Object class does 
not have the getDi ameter method. The compiler cannot find a match for 
myObject .getDi ameterC). It is necessary to cast myObject into the Ci rcle type to tell 
the compiler that myObject is also an instance of Ci rcle. 

Why not define myObject as a Ci rcl e type in the first place? To enable generic programming, 
it is a good practice to define a variable with a supertype, which can accept a value of any subtype. 

||| Note 

lowercase keywords instanceof is a Java keyword. Every letter in a Java keyword is in lowercase. 

H| Tip 

casting analogy To help understand casting, you may also consider the analogy of fruit, apple, and orange with 

the Frui t class as the superclass for Appl e and Orange. An apple is a fruit, so you can always 
safely assign an instance of Apple to a variable for Fruit. However, a fruit is not necessarily an 
apple, so you have to use explicit casting to assign an instance of Fruit to a variable of Apple. 

Listing 11.7 demonstrates polymorphism and casting. The program creates two objects 
(lines 5-6), a circle and a rectangle, and invokes the di spl ayOb j ect method to display them 
(lines 9-10). The displayObject method displays the area and diameter if the object is a 
circle (line 15), and the area if the object is a rectangle (line 21). 

Listing 1 1.7 Casti ngDemo. java 

1 public class Casti ngDemo { 

2 /** Main method */ 

3 public static void main(String[] args) { 

4 // Create and initialize two objects 

5 Object objectl = new Circle4(l); 

6 Object object2 = new Rectangl el(l , 1); 
7 

8 // Display circle and rectangle 

9 displayObject(objectl) ; 

10 di spl ay0bject(object2) ; 

11 } 
12 

13 /** A method for displaying an object */ 

14 public static void di spl ay0bject(0bject object) { 

15 if (object instanceof Circle4) { 

16 System. out . pri ntl n("The circle area is " + 

17 ((Ci rcle4)object) .getAreaO) ; 

18 System. out . pri ntl n("The circle diameter is " + 

19 ( (Ci rcl e4) obj ect) . getDi amete r () ) ; 

20 } 

21 else if (object instanceof Rectanglel) { 

22 System. out. println("The rectangle area is " + 

23 ((Rectangl el)object) .getAreaO) ; 

24 } 

25 } 

26 } 



polymorphic call 



polymorphic call 
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The circle area is 3.141592653589793 
The circle diameter is 2.0 
The rectangle area is 1.0 



The displayObject (Object object) method is an example of generic programming. It 
can be invoked by passing any instance of Object. 

The program uses implicit casting to assign a Circle object to objectl and a 
Rectangl e object to object 2 (lines 5-6), then invokes the displ ayObject method to dis- 
play the information on these objects (lines 9-10). 

In the di spl ayObject method (lines 14-25), explicit casting is used to cast the object to 
Ci rcl e if the object is an instance of Ci rcl e, and the methods get Area and getDiameter 
are used to display the area and diameter of the circle. 

Casting can be done only when the source object is an instance of the target class. The pro- 
gram uses the instanceof operator to ensure that the source object is an instance of the tar- 
get class before performing a casting (line 15). 

Explicit casting to Ci rcl e (lines 17, 19) and to Rectangl e (line 23) is necessary because 
the getArea and getDiameter methods are not available in the Object class. 

tilt Caution 

The object member access operator ( . ) precedes the casting operator. Use parentheses to ensure . precedes casting 

that casting is done before the . operator, as in 

((Ci rcl e) object) . getArea ()) ; 

11.10 The Object's equals Method 

Another method defined in the Object class that is often used is the equals method. Its equals (Object) 

signature is 

public boolean equal s (Object o) 
This method tests whether two objects are equal. The syntax for invoking it is: 

objectl. equal s(object2) ; 

The default implementation of the equal s method in the Object class is: 

public boolean equal s (Object obj) { 
return (this == obj); 

} 

This implementation checks whether two reference variables point to the same object using 
the == operator. You should override this method in your custom class to test whether two dis- 
tinct objects have the same content. 

You have already used the equal s method to compare two strings in §9.2, "The String 
Class." The equal s method in the String class is inherited from the Object class and is 
overridden in the String class to test whether two strings are identical in content. You can 
override the equal s method in the Ci rcl e class to compare whether two circles are equal 
based on their radius as follows: 

public boolean equal s (Object o) { 
if (o instanceof Circle) { 

return radius == ((Ci rcle)o) . radius; 

} 
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el se 

return false; 



Note 

== vs. equals The == comparison operator is used for comparing two primitive data type values or for deter- 

mining whether two objects have the same references. The equals method is intended to test 
whether two objects have the same contents, provided that the method is overridden in the 
defining class of the objects. The == operator is stronger than the equals method, in that the 
== operator checks whether the two reference variables refer to the same object. 



Caution 

Using the signature equal s(SomeClassName obj) (e.g., equals (Circle c)) to over- 
equals(Object) ride the equal s method in a subclass is a common mistake. You should use equal s (Object 

obj). See Review Question 1 1.15. 



11.11 The ArrayLi st Class 



Now we are ready to introduce a very useful class for storing objects. You can create an array 
to store objects. But, once the array is created, its size is fixed. Java provides the ArrayLi st 
the ArrayLi st class class that can be used to store an unlimited number of objects. Figure 11.3 shows some meth- 

ods in ArrayLi st. 



■ 



j a va.util. Array List 



+Arrayl_i st() 
+add(o: Object): void 
+add(index: int, o: Object): void 
+clear(): void 

+contains(o: Object): boolean 
+get(index: int): Object 
+index0f (o: Object): int 
+isEmpty(): boolean 
+lastlndex0f (o: Object): int 
+remove(o: Object): boolean 
+size(): int 

+ remove (index: int): boolean 
+set(index: int, o: Object): Object 



Creates an empty list. 

Appends a new element o at the end of this list. 

Adds a new element o at the specified index in this list. 

Removes all the elements from this list. 

Returns true if this list contains the element o. 

Returns the element from this list at the specified index. 

Returns the index of the first matching element in this list. 

Returns true if this list contains no elements. 

Returns the index of the last matching element in this list. 

Removes the element o from this list. 

Returns the number of elements in this list. 

Removes the element at the specified index. 

Sets the element at the specified index. 



Figure 1 1.3 An ArrayLi st stores an unlimited number of objects. 



Listing 11.8 gives an example of using ArrayLi st to store objects. 



create ArrayLi st 



add element 



Listing 1 1.8 TestArrayList. java 



public class TestArrayList { 

public static void main(String[] args) { 

// Create a list to store cities 

java.util .ArrayList cityList = new java.util .ArrayListO ; 

// Add some cities in the list 
cityList.add("London") ; 
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8 
9 
10 
11 
12 
13 
14 
15 
16 
17 
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19 
20 
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27 
28 
29 
30 
31 
32 
33 
34 
35 
36 
37 
38 
39 
40 
41 
42 
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44 
45 
46 
47 
48 
49 
50 
51 
52 
53 
54 
55 
56 
57 
58 
59 



// cityList now contains [London] 
cityLn st. add ("Denver") ; 

// cityList now contains [London, Denver] 
cityList. add("Paris") ; 

// cityList now contains [London, Denver, Paris] 
cityList. add("Miami") ; 

// cityList now contains [London, Denver, Paris, Miami] 
cityList.add("Seoul") ; 

// contains [London, Denver, Paris, Miami, Seoul] 
cityList. add ("Tokyo") ; 

// contains [London, Denver, Paris, Miami, Seoul, Tokyo] 

System. out. println("List size? " + cityList. size() ) ; 
System. out. println("Is Miami in the list? " + 

cityList. contains("Miami") ); 
System. out. println("The location of Denver in the list? " 

+ ci tyLi st . i ndexOf ("Denver") ) ; 
System. out. println("Is the list empty? " + 

ci tyLi st . i sEmptyO ) ; // Print false 

// Insert a new city at index 2 
cityList.add(2, "Xian") ; 

// contains [London, Denver, Xian, Paris, Miami, Seoul, Tokyo] 

// Remove a city from the list 
cityList. remove("Miami") ; 

// contains [London, Denver, Xian, Paris, Seoul, Tokyo] 

// Remove a city at index 1 
cityList. remove(l) ; 

// contains [London, Xian, Paris, Seoul, Tokyo] 

// Display the contents in the list 
System . out . pri ntl n (ci tyLi st . toSt ri ng () ) ; 

// Display the contents in the list in reverse order 

for (int i = ci tyLi st . si ze() - 1; i >= 0; i— ) 

System. out. print(cityList.get(i) + " ") ; 
System . out . pri ntl n () ; 

// Create a list to store two circles 

java.util .ArrayList list = new java. uti 1 .ArrayLi st() ; 

// Add two ci rcl es 
list.add(new Circle4(2)); 
list.add(new Circle4(3)); 

// Display the area of the first circle in the list 
System. out. println("The area of the circle? " + 
((Ci rcle4)list.get(0)) .getAreaO) ; 



list size 

contains element? 
element index 
is empty? 



remove element 



remove element 



toStringO 



get element 



create ArrayList 



} 



List size? 6 

Is Miami in the list? true 

The location of Denver in the list? 1 

Is the list empty? false 

[London, Xian, Paris, Seoul, Tokyo] 

Tokyo Seoul Paris Xian London 

The area of the circle? 12.566370614359172 



392 Chapter I I Inheritance and Polymorphism 



add (Object) 



sizeQ 



add(index, Object) 



remove (Object) 



remove (index) 



toStringQ 



getlndexQ 



The program creates an ArrayList using its no-arg constructor (line 4). The add method 
adds any instance of Object into the list. Since String is a subclass of Object, strings can 
be added to the list. The add method (lines 7-17) adds an object to the end of list. So, after 
cityList.add("London") (line 7), the list contains 

[London] 

After cityList . add("Denver") (line 9), the list contains 
[London, Denver] 

After adding Paris, Miami, Seoul, and Tokyo (lines 11-17), the list would contain 
[London, Denver, Paris, Miami, Seoul, Tokyo] 

Invoking size() (line 20) returns the size of the list, which is currently 6. Invoking 
contains ("Mi ami ") (line 22) checks whether the object is in the list. In this case, it returns 
true, since Miami is in the list. Invoking i ndexOf ("Denver") (line 24) returns the index 
of the object in the list, which is 1. If the object is not in the list, it returns - 1. The i sEmpty () 
method (line 26) checks whether the list is empty. It returns f al se, since the list is not empty. 

The statement cityList. add(2, "Xian") (line 29) inserts an object to the list at the 
specified index. After this statement, the list becomes 

[London, Denver, Xian, Paris, Miami, Seoul, Tokyo] 

The statement cityList. remove("Miami") (line 33) removes the object from the list. 
After this statement, the list becomes 

[London, Denver, Xian, Paris, Seoul, Tokyo] 

The statement cityList. remove(l) (line 37) removes the object at the specified index 
from the list. After this statement, the list becomes 

[London, Xian, Paris, Seoul, Tokyo] 

The statement in line 41 is same as 

System. out. println(cityList) ; 

The toStringO method returns a string representation for the list in the form of 

[eO.toStringO , el.toStringO ek. toStringO], where eO, el, ...,andek 

are the elements in the list. 

The get (index) method (line 45) returns the object at the specified index. 



compiler warning 



array vs. ArrayList 



Note 

You will get the following warning when compiling this program from the command prompt: 

Note: TestArrayLi st . java uses unchecked or unsafe operations. 
Note: Recompile with -XI i nt : unchecked for details. 

This warning can be eliminated using generic types discussed in Chapter 2 1 , "Generics". For now, 
ignore it. Despite the warning, the program will be compiled just fine to produce a .class file. 

ArrayList objects can be used like arrays, but there are many differences. Table 11.1 lists 
their similarities and differences. 

Once an array is created, its size is fixed. You can access an array element using the 
square-bracket notation (e.g., a [index]). When an ArrayList is created, its size is 0. You 
cannot use the get and set methods if the element is not in the list. It is easy to add, insert, 
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Table 1 1.1 Differences and Similarities between Arrays and ArrayList 



Operation 



Array 



ArrayList 



Creating an array/ ArrayList 
Accessing an element 
Updating an element 
Returning size 
Adding a new element 
Inserting a new element 
Removing an element 
Removing an element 
Removing all elements 



Object [] a = new Object [10] ArrayList list = new ArrayListQ; 



a[index] 
a [index] 
a. length 



'London"; 



1 ist .get(index) ; 

"list, set (index, "London"); 

1 ist .size() ; 

list.add("London"); 

1 ist .add (index, "London"); 

1 ist . remove(index) ; 

1 ist . remove (Object) ; 

1 ist .clearQ ; 



and remove elements in a list, but it is rather complex to add, insert, and remove elements in 
an array. You have to write code to manipulate the array in order to perform these operations. 



Note 

java. uti 1 .Vector is also a class for storing objects, which is very similar to the ArrayList 
class. All the methods in ArrayList are also available in Vector. The Vector class was 
introduced in JDK I.I. The ArrayList class introduced in JDK 1.2 was intended to replace the 
Vector class. 



Vector class 



11.12 A Custom Stack Class 



"Designing a Class for Stacks" in §10.8 presented a stack class for storing int values. This 
section introduces a stack class to store objects. You can use an ArrayList to implement Video Note 



Stack, as shown in Listing 11.9. The UML diagram for the class is shown in Figure 11.4. 



the MyStack class 



MyStack 



-list: ArrayList 



+isEmpty(): boolean 
+getSize() : int 
+peek() : Object 
+pop(): Object 
+push(o: Object): void 
+search(o: Object): int 



A list to store elements. 

Returns true if this stack is empty. 

Returns the number of elements in this stack. 

Returns the top element in this stack. 

Returns and removes the top element in this stack. 

Adds a new element to the top of this stack. 

Returns the position of the first element in the stack from 
the top that matches the specified element. 



Figure 1 1.4 The MyStack class encapsulates the stack storage and provides the operations 
for manipulating the stack. 



Listing 1 1.9 MyStack. java 

1 public class MyStack { 

2 private java. uti 1 .ArrayLi st list 

3 

4 public boolean isEmptyO { 

5 return 1 i st . i sEmptyO ; 

6 } 



new java. uti 1 .ArrayLi st() ; 



array list 
stack empty? 
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7 

8 public int getSizeO { 

9 return "Hst.sizeO ; 
10 } 
11 

12 public Object peekO { 

13 return list.get(getSize() - 1); 

14 } 
15 

16 public Object pop() { 

17 Object o = list.get(getSize() - 1); 

18 list. remove(getSize() - 1); 

19 return o; 

20 } 
21 

22 public void push(Object o) { 

23 list.add(o) ; 

24 } 
25 

26 public int search(Object o) { 

27 return 1 i st . 1 astlndexOf (o) ; 

28 } 
29 

30 /** Override the toString in the Object class */ 

31 public String toStringO { 

32 return "stack: " + list.toStringO ; 

33 } 

34 } 

An array list is created to store the elements in the stack (line 2). The isEmptyO method 
(lines 4-6) returns 1 ist . isEmptyO. The getSizeO method (lines 8-10) returns 
1 i st . si ze() . The peek() method (lines 12-14) retrieves the element at the top of the stack 
without removing it. The end of the list is the top of the stack. The pop() method (lines 
16-20) removes the top element from the stack and returns it. The push (Object el ement) 
method (lines 22-24) adds the specified element to the stack. The search (Object ele- 
ment) method checks whether the specified element is in the stack, and it returns the index of 
first-matching element in the stack from the top by invoking 1 i st.l astlndexOf (o). The 
toStringO method (lines 31-33) defined in the Object class is overridden to display the 
contents of the stack by invoking list.toStringO. The toStringO method imple- 
mented in ArrayLi st returns a string representation of all the elements in an array list. 

Design Guide 

In Listing 1 1.9, MyStack contains ArrayList. The relationship between MyStack and 
ArrayLi st is composition. While inheritance models an is-a relationship, composition models a 
has-a relationship. You may also implement MyStack as a subclass of ArrayList (see Exercise 
1 1.4). Using composition is better, however, because it enables you to define a completely new 
stack class without inheriting the unnecessary and inappropriate methods from ArrayList. 

11.13 The protected Data and Methods 

So far you have used the private and publ ic keywords to specify whether data fields and 
methods can be accessed from the outside of the class. Private members can be accessed only 
from the inside of the class, and public members can be accessed from any other classes. 

Often it is desirable to allow subclasses to access data fields or methods defined in the 
superclass, but not allow nonsubclasses to access these data fields and methods. To do so, you 
why protected? can use the protected keyword. A protected data field or method in a superclass can be 

accessed in its subclasses. 



get stack size 



peek stack 



remove 



push 



search 



composition 

has-a 

is-a 
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The modifiers private, protected, and publ ic are known as visibility or accessibility 
modifiers because they specify how class and class members are accessed. The visibility of 
these modifiers increases in this order: 

Visibility increases 
private, none (if no modifier is used), protected, public 

Table 1 1.2 summarizes the accessibility of the members in a class. Figure 11.5 illustrates how 
a public, protected, default, and private datum or method in class CI can be accessed from a 
class C2 in the same package, from a subclass C3 in the same package, from a subclass C4 in 
a different package, and from a class C5 in a different package. 



Table 1 1.2 Data and Methods Visibility 



Modifier 
on members 
in a class 

public 
protected 
(default) 
private 



Accessed 
from the 
same class 

/ 
/ 
/ 
/ 



Accessed 
from the 
same package 

/ 

/ 

/ 



Accessed 
from a 
subclass 

/ 
/ 



Accessed 
from a different 
package 

/ 



package pi; 



public class CI { 
public int x; 
protected int y; 
int z; 

private int u; 

protected void m() { 

} 



public class C2 { 

CI o = new Cl() ; 
can access o.x; 
can access o.y; 
can access o.z; 
cannot access o.u; 

can invoke o.mQ ; 



public class C3 

extends CI { 

can access x; 
can access y; 
can access z; 
cannot access u; 

can i nvoke m() ; 



package p2 ; 



public class C4 

extends CI { 

can access x; 
can access y; 
cannot access z; 
cannot access u; 

can i nvoke m() ; 



public class C5 { 




CI o = new Cl() ; 


can access o.x; 




cannot access o. 


y; 


cannot access o. 


z ; 


cannot access o. 


u ; 


cannot invoke o. 


mO; 


} 





Figure 1 1.5 Visibility modifiers are used to control how data and methods are accessed. 



Use the private modifier to hide the members of the class completely so that they cannot 
be accessed directly from outside the class. Use no modifiers in order to allow the members of 
the class to be accessed directly from any class within the same package but not from other 
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packages. Use the protected modifier to enable the members of the class to be accessed by 
the subclasses in any package or classes in the same package. Use the publ ic modifier to 
enable the members of the class to be accessed by any class. 

Your class can be used in two ways: for creating instances of the class, and for defining 
subclasses by extending the class. Make the members private if they are not intended for 
use from outside the class. Make the members publ ic if they are intended for the users of the 
class. Make the fields or methods protected if they are intended for the extenders of the 
class but not the users of the class. 

The private and protected modifiers can be used only for members of the class. The 
publ ic modifier and the default modifier (i.e., no modifier) can be used on members of the 
class as well on the class. A class with no modifier (i.e., not a public class) is not accessible by 
classes from other packages. 

Note 

change visibility A subclass may override a protected method in its superclass and change its visibility to public. 

However, a subclass cannot weaken the accessibility of a method defined in the superclass. For 
example, if a method is defined as public in the superclass, it must be defined as public in the 
subclass. 

11.14 Preventing Extending and Overriding 

You may occasionally want to prevent classes from being extended. In such cases, use the 
final modifier to indicate that a class is final and cannot be a parent class. The Math class is 
a final class. The String, StringBuilder, and StringBuffer classes are also final 
classes. For example, the following class is final and cannot be extended: 

public final class C { 

// Data fields, constructors, and methods omitted 

} 

You also can define a method to be final; a final method cannot be overridden by its sub- 
classes. 

For example, the following method is final and cannot be overridden: 

public class Test { 

// Data fields, constructors, and methods omitted 

public final void m() { 

// Do something 

} 

} 



||| Note 

The modifiers are used on classes and class members (data and methods), except that the final 
modifier can also be used on local variables in a method. A final local variable is a constant inside 
a method. 
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Chapter Summary 



1 . You can derive a new class from an existing class. This is known as class inheritance. 
The new class is called a subclass, child class or extended class. The existing class is 
called a superclass, parent class, or base class. 

2. A constructor is used to construct an instance of a class. Unlike properties and 
methods, the constructors of a superclass are not inherited in the subclass. They 
can be invoked only from the constructors of the subclasses, using the keyword 
super. 

3. A constructor may invoke an overloaded constructor or its superclass's constructor. 
The call must be the first statement in the constructor. If none of them is invoked 
explicitly, the compiler puts super () as the first statement in the constructor, which 
invokes the superclass's no-arg constructor. 

4. To override a method, the method must be defined in the subclass using the same sig- 
nature as in its superclass. 

5. An instance method can be overridden only if it is accessible. Thus a private method 
cannot be overridden, because it is not accessible outside its own class. If a method 
defined in a subclass is private in its superclass, the two methods are completely 
unrelated. 

6. Like an instance method, a static method can be inherited. However, a static method 
cannot be overridden. If a static method defined in the superclass is redefined in a 
subclass, the method defined in the superclass is hidden. 

7. Every class in Java is descended from the java.lang. Object class. If no inheri- 
tance is specified when a class is defined, its superclass is Object. 

8. If a method's parameter type is a superclass (e.g., Object), you may pass an object 
to this method of any of the parameter's subclasses (e.g., Ci rcl e or Stri ng). When 
an object (e.g., a Ci rcl e object or a Stri ng object) is used in the method, the par- 
ticular implementation of the method of the object that is invoked (e.g., toString) 
is determined dynamically. 

9. It is always possible to cast an instance of a subclass to a variable of a superclass, 
because an instance of a subclass is always an instance of its superclass. When 
casting an instance of a superclass to a variable of its subclass, explicit casting 
must be used to confirm your intention to the compiler with the (Subcl assName) 
cast notation. 

10. A class defines a type. A type defined by a subclass is called a subtype and a type 
defined by its superclass is called a supertype. 

I I . When invoking an instance method from a reference variable, the actual type of the 
variable decides which implementation of the method is used at runtime. When 
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accessing a field or a static method, the declared type of the reference variable 
decides which method is used at compile time. 

1 2. You can use ob j i nstanceof AC1 ass to test whether an object is an instance of a 
class. 

1 3. You can use the protected modifier to prevent the data and methods from being 
accessed by nonsubclasses from a different package. 

14- You can use the f i nal modifier to indicate that a class is final and cannot be a par- 
ent class and to indicate that a method is final and cannot be overridden. 

Review Questions 

Sections 1 1.2-1 1.5 

I I . I What is the printout of running the class C in (a)? What problem arises in compil- 
ing the program in (b)? 



class A { 
public A() { 

System, out. pn'ntln( 

"A's no-arg constructor is invoked"): 

} 

} 

class B extends A { 

} 

public class C { 

public static void main(String[] args) { 
B b = new B() ; 

} 

} 



class A { 

public A(int x) { 

} 

} 

class B extends A { 
public B() { 

} 

} 

public class C { 

public static void main(String[] args) { 
B b = new BO ; 

} 

} 



(a) 



(b) 



I 1 .2 True or false? 

1. A subclass is a subset of a superclass. 

2. When invoking a constructor from a subclass, its superclass's no-arg construc- 
tor is always invoked. 

3. You can override a private method defined in a superclass. 

4. You can override a static method defined in a superclass. 

I 1 .3 Identify the problems in the following classes: 

1 public class Circle { 

2 private double radius; 
3 

4 public Ci rcle(double radius) { 

5 radius = radius; 

6 } 
7 

8 public double getRadiusO { 

9 return radius; 
10 } 

11 

12 public double getAreaO { 

13 return radius * radius * Math. PI; 

14 } 
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15 } 
16 

17 class B extends Circle { 

18 private double length; 
19 

20 B(double radius, double length) { 

21 Ci rcl e(radi us) ; 

22 length = length; 

23 } 
24 

25 /** Override getAreaO */ 

26 public double getAreaO { 

27 return getAreaO * length; 

28 } 

29 } 

I 1 .4 How do you explicitly invoke a superclass's constructor from a subclass? 
I 1 .5 How do you invoke an overridden superclass method from a subclass? 

11.6 Explain the difference between method overloading and method overriding. 

11.7 If a method in a subclass has the same signature as a method in its superclass with 
the same return type, is the method overridden or overloaded? 

11.8 If a method in a subclass has the same signature as a method in its superclass with 
a different return type, will this be a problem? 

11.9 If a method in a subclass has the same name as a method in its superclass with dif- 
ferent parameter types, is the method overridden or overloaded? 

Sections 1 1.6-1 1.9 

I 1. 10 Does every class have a toString method and an equals method? Where do 
they come from? How are they used? Is it appropriate to override these methods? 

11.11 Show the output of following program: 

1 public class Test { 

2 public static void mai n(Stri ng [] args) { 

3 A a = new A(3) ; 

4 } 

5 } 
6 

7 class A extends B { 

8 public A(int t) { 

9 System. out . pri ntl n("A' s constructor is invoked"); 

10 } 

11 } 
12 

13 class B { 

14 public BO { 

15 System. out. println("B's constructor is invoked"); 

16 } 

17 } 

Is the no-arg constructor of Object invoked when new A(3) is invoked? 

11.12 For the GeometricObject and Ci rcl e classes in Listings 11.1 and 11.2, answer 
the following questions: 

(a) Are the following Boolean expressions true or false? 
Circle circle = new Circle(l); 

GeometricObject objectl = new Geometri cObjectO ; 
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(circle instanceof Geometri cObject) 
(objectl instanceof Geometri cObject) 
(circle instanceof Circle) 
(objectl instanceof Circle) 

(b) Can the following statements be compiled? 

Circle circle = new Circle(5); 
Geometri cObject object = circle; 

(c) Can the following statements be compiled? 

Geometri cObject object = new Geometri c0bject() ; 
Circle circle = (Ci rcl e)object ; 

I 1.13 Suppose that Fruit, Apple, Orange, Gol denDel icious, and Macintosh are 

declared, as shown in Figure 1 1 .6. 



Fruit 



3L 



Apple Orange 



5 



Gol denDel icious Macintosh 



Figure 1 1.6 Gol denDel icious and Macintosh are subclasses of Apple; Apple and 
Orange are subclasses of Fruit . 



Assume that the following declaration is given: 

Fruit fruit = new Gol denDel i ci ous () ; 
Orange orange = new OrangeO; 

Answer the following questions: 

(1) Is fruit instanceof Fruit? 

(2) Is fruit instanceof Orange? 

(3) Is fruit instanceof Apple? 

(4) Is fruit instanceof Col denDel icious? 

(5) Is fruit instanceof Macintosh? 

(6) Is orange instanceof Orange? 

(7) Is orange instanceof Fruit? 

(8) Is orange instanceof Apple? 

(9) Suppose the method makeApple Cider is defined in the Apple class. Can 
fruit invoke this method? Can orange invoke this method? 

(10) Suppose the method makeOrangeJuice is defined in the Orange class. Can 
orange invoke this method? Can f rui t invoke this method? 

(1 1) Is the statement Orange p = new Appl e() legal? 

(12) Is the statement Macintosh p = new AppleO legal? 

(13) Is the statement Apple p = new Macintosh () legal? 
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11.14 What is wrong in the following code? 

1 public class Test { 

2 public static void man n(Stri ng [] args) { 

3 Object fruit = new FruitO; 

4 Object apple = (Apple) fruit; 

5 } 

6 } 
7 

8 class Apple extends Fruit { 

9 } 
10 

11 class Fruit { 

12 } 



Section 11.10 

11.15 When overriding the equal s method, a common mistake is mistyping its signa- 
ture in the subclass. For example, the equal s method is incorrectly written as 
equal s(Ci rcl e ci rcl e), as shown in (a) in the code below; instead, it should 
be equal s (Object ci rcl e), as shown in (b). Show the output of running class 
Test with the Ci rcl e class in (a) and in (b), respectively. 



public class Test { 

public static void mai n(Stri ng [] args) { 
Object circlel = new CircleO; 
Object circle2 = new CircleO; 
System. out .println(ci rcl el. equal s(ci rcle2)) ; 

} 

} 



class Ci rcle { 
double radius; 

public boolean equal s(Ci rcl e circle) { 
return this. radius == ci rcle. radius; 

} 



class Circle { 
double radius; 

public boolean equals(0bject circle) { 
return this. radius == 
((Ci rcle)ci rcl e) . radi us ; 

} 



(a) 



(b) 



Sections 1 1.1 1-1 1.12 

11.16 How do you create an Ar rayLi st? How do you append an object to a list? How 
do you insert an object at the beginning of a list? How do you find the number of 
objects in a list? How do you remove a given object from a list? How do you 
remove the last object from the list? How do you check whether a given object is 
in a list? How do you retrieve an object at a specified index from a list? 

11.17 There are three errors in the code below. Identify them. 

ArrayList list = new ArrayListO; 

list.add("Denver") ; 

list.add("Austin") ; 

list, add (new java . uti 1 . DateO) ; 

String city = list.get(O); 

list.set(3, "Dallas"); 

System . out . pri ntl n (1 i st . get (3) ) ; 
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Sections 1 1.13-1 1.14 

11.18 What modifier should you use on a class so that a class in the same package can 
access it, but a class in a different package cannot access it? 

11.19 What modifier should you use so that a class in a different package cannot access 
the class, but its subclasses in any package can access it? 

I 1 .20 In the code below, classes A and B are in the same package. If the question marks 
are replaced by blanks, can class B be compiled? If the question marks are 
replaced by private, can class B be compiled? If the question marks are replaced 
by protected, can class B be compiled? 



package pi; 

public class A { 
? int i ; 

? void m() { 



(a) 



package pi; 

public class B extends A { 

public void ml(String[] args) { 
System. out. println(i) ; 
m(); 

} 



} 



(b) 



I 1 .2 1 In the code below, classes A and B are in different packages. If the question marks 
are replaced by blanks, can class B be compiled? If the question marks are 
replaced by private, can class B be compiled? If the question marks are replaced 
by protected, can class B be compiled? 



package pi; 

public class A { 
? int i ; 

? void m() { 



package p2 ; 

public class B extends A { 

public void ml(String[] args) { 
System. out. pn'ntln(i) ; 

m(); 

} 

} 



(a) 



(b) 



I 1 .22 How do you prevent a class from being extended? How do you prevent a method 
from being overridden? 

Comprehensive 

I 1 .23 Define the following terms: inheritance, superclass, subclass, the keywords super 
and this, casting objects, the modifiers protected and final. 

I 1 .24 Indicate true or false for the following statements: 

■ A protected datum or method can be accessed by any class in the same package. 

■ A protected datum or method can be accessed by any class in different 
packages. 

■ A protected datum or method can be accessed by its subclasses in any package. 

■ A final class can have instances. 

■ A final class can be extended. 

■ A final method can be overridden. 

■ You can always successfully cast an instance of a subclass to a superclass. 

■ You can always successfully cast an instance of a superclass to a subclass. 
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I 1 .25 Describe the difference between method matching and method binding. 
I 1 .26 What is polymorphism? What is dynamic binding? 

Programming Exercises 



Sections 1 1.2-1 1.4 

I I.I (The Triangle class) Design a class named Triangle that extends 
GeometricObject. The class contains: 

■ Three doubl e data fields named sidel, side2, and side3 with default values 
1 . to denote three sides of the triangle. 

■ A no-arg constructor that creates a default triangle. 

■ A constructor that creates a triangle with the specified sidel, side2, and 
side3. 

■ The accessor methods for all three data fields. 

■ A method named getAreaO that returns the area of this triangle. 

■ A method named getPerimeterO that returns the perimeter of this triangle. 

■ A method named toStringO that returns a string description for the triangle. 

For the formula to compute the area of a triangle, see Exercise 2.21. The toStringO 
method is implemented as follows: 

return "Triangle: sidel = " + sidel + " side2 = " + side2 + 
" side3 = " + side3; 

Draw the UML diagram for the classes Triangle and GeometricObject. 
Implement the class. Write a test program that creates a Triangle object with 
sides 1, 1.5, 1, color yellow and filled true, and displays the area, 
perimeter, color, and whether filled or not. 

Sections 1 1.5-1 1.1 1 

I 1.2 (The Person, Student, Employee, Faculty, and Staff classes) Design a 
class named Person and its two subclasses named Student and Employee. 
Make Faculty and Staff subclasses of Employee. A person has a name, 
address, phone number, and email address. A student has a class status (freshman, 
sophomore, junior, or senior). Define the status as a constant. An employee has an 
office, salary, and date hired. Define a class named MyDate that contains the fields 
year, month, and day. A faculty member has office hours and a rank. A staff 
member has a title. Override the toString method in each class to display the 
class name and the person's name. 

Draw the UML diagram for the classes. Implement the classes. Write a test pro- 
gram that creates a Person, Student, Employee, Faculty, and Staff, and 
invokes their toStringO methods. 

11.3 (Subclasses of Account) In Exercise 8.7, the Account class was defined to model 
a bank account. An account has the properties account number, balance, annual 
interest rate, and date created, and methods to deposit and withdraw funds. Create 
two subclasses for checking and saving accounts. A checking account has an over- 
draft limit, but a savings account cannot be overdrawn. 

Draw the UML diagram for the classes. Implement the classes. Write a test pro- 
gram that creates objects of Account, Savi ngsAccount, and Checki ngAccount 
and invokes their toStringO methods. 
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I 1.4 (Implementing MyStack using inheritance) In Listing 11.9, MyStack is imple- 
mented using composition. Create a new stack class that extends ArrayList. 



Draw the UML diagram for the classes. Implement MyStack. Write a test pro- 
gram that prompts the user to enter five strings and displays them in reverse order. 



I 1.5 (The Course class) Rewrite the Course class in Listing 10.6. Use an 
ArrayList to replace an array to store students. You should not change the 
original contract of the Course class (i.e., the definition of the constructors and 
methods should not be changed). 

I 1.6 (Using ArrayList) Write a program that creates an ArrayList and adds a 
Loan object, a Date object, a string, a JFrame object, and a Ci rcl e object to 
the list, and use a loop to display all the elements in the list by invoking the 
object's toStringO method. 

I 1. 7*** (Implementing ArrayList) ArrayList is implemented in the Java API. 

Implement ArrayList and the methods defined in Figure 11.3. (Hint: Use an 
array to store the elements in Ar rayLi st. If the size of the ArrayLi st exceeds 
the capacity of the current array, create a new array that doubles the size of the 
current array and copy the contents of the current to the new array.) 

I 1 .8** (New Account class) An Account class was specified in Exercise 8.7. Design 
a new Account class as follows: 



■ Add a new data field name of the Stri ng type to store the name of the customer. 

■ Add a new constructor that constructs an account with the specified name, 
id, and balance. 

■ Add a new data field named transactions whose type is ArrayList that 
stores the transaction for the accounts. Each transaction is an instance of the 
Transaction class. The Transaction class is defined as shown in Figure 1 1.7. 

■ Modify the withdraw and deposit methods to add a transaction to the 
transactions array list. 

■ All other properties and methods are same as in Exercise 8.7. 

Write a test program that creates an Account with annual interest rate 1. 5%, 
balance 1000, id 1122, and name George. Deposit $30, $40, $50 to the account 
and withdraw $5, $4, $2 from the account. Print an account summary that shows 
account holder name, interest rate, balance, and all transactions. 



■ 



Transaction 




The get and set methods for these data fields are 
provided in the class but omitted in the UML diagram 
for brevity. 




-date: java.util .Date 
-type: char ^ 



The date of this transaction. 



The type of the transaction, such as 'W for withdrawal, 'D' 
for deposit. 

The amount of the transaction. 



-amount: double 



-balance: double 



The new balance after this transaction. 



description: String 



The description of this transaction. 



+Transaction(type: char, 
amount: double, balance: 
double, description: String) 



Construct a Transaction with the specified date, type, 
balance, and description. 



Figure 1 1 .7 The Transaction class describes a transaction for a bank account. 



Chapter 



GUI Basics 

Objectives 

■ To distinguish between Swing and AWT (§12.2). 

■ To describe the Java GUI API hierarchy (§12.3). 

■ To create user interfaces using frames, panels, and simple GUI components (§12.4). 

■ To understand the role of layout managers (§ 12.5). 

■ To use the Fl owLayout, GridLayout, and BorderLayout managers 
to lay out components in a container (§12.5). 

■ To use JPanel to make panels as subcontainers (§12.6). 

■ To specify colors and fonts using the Col or and Font 

classes (§§12.7-12.8). 

■ To apply common features such as borders, tool tips, 
fonts, and colors on Swing components (§12.9). 

■ To use borders to visually group user-interface 
components (§12.9). 

■ To create image icons using the Imagelcon class (§12.10). 
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12.1 Introduction 

The design of the API for Java GUI programming is an excellent example of how the object- 
oriented principle is applied. This chapter serves two purposes. First, it introduces the basics 
of Java GUI programming. Second, it uses GUI to demonstrate OOP. Specifically, this chap- 
ter will introduce the framework of Java GUI API and discuss GUI components and their rela- 
tionships, containers and layout managers, colors, fonts, borders, image icons, and tool tips. 

12.2 Swing vs. AWT 

We used simple GUI examples to demonstrate OOP in §8.6.3, "Displaying GUI Components." 
We used the GUI components such as JButton, J Label , JTextField, JRadioButton, and 
JComboBox. Why do the GUI component classes have the prefix 7? Instead of J But ton, why 
not name it simply Button? In fact, there is a class already named Button in the java.awt 

package. 

When Java was introduced, the GUI classes were bundled in a library known as the Abstract 
Windows Toolkit (AWT). AWT is fine for developing simple graphical user interfaces, but not for 
developing comprehensive GUI projects. Besides, AWT is prone to platform- specific bugs. The 
AWT user-interface components were replaced by a more robust, versatile, and flexible library 

Swing components known as Swing components. Swing components are painted directly on canvases using Java 

code, except for components that are subclasses of java.awt .Window or j ava . awt . Panel , 
which must be drawn using native GUI on a specific platform. Swing components depend less on 
the target platform and use less of the native GUI resource. For this reason, Swing components 

lightweight that don't rely on native GUI are referred to as lightweight components, and AWT components 

heavyweight are referred to as heavyweight components. 

To distinguish new Swing component classes from their AWT counterparts, the Swing 

why prefix J? GUI component classes are named with a prefixed J. Although AWT components are still 

supported in Java, it is better to learn to how program using Swing components, because the 
AWT user-interface components will eventually fade away. This book uses Swing GUI com- 
ponents exclusively. 

12.3 The Java GUI API 

The GUI API contains classes that can be classified into three groups: component classes, con- 
tainer classes, and helper classes. Their hierarchical relationships are shown in Figure 12.1. 

The component classes, such as JButton, J Label , and JTextFiel d, are for creating the 
user interface. The container classes, such as JFrame, JPanel, and JApplet, are used to 
contain other components. The helper classes, such as Graphics, Color, Font, 
FontMetrics, and Dimension, are used to support GUI components. 

# Note 

The JFrame, JApplet, JDialog, and ^Component classes and their subclasses are grouped 
in the javax. swing package. All the other classes in Figure 12.1 are grouped in the java.awt 
package. 

12.3.1 Component Classes 

An instance of Component can be displayed on the screen. Component is the root class of all 
the user-interface classes including container classes, and ^Component is the root class of all 
the lightweight Swing components. Both Component and ^Component are abstract classes. 
Abstract classes will be introduced in Chapter 14, "Abstract Classes and Interfaces." For now, 
all you need to know is that abstract classes are same as classes except that you cannot create 
instances using the new operator. For example, you cannot use new ^Component () to create an 
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- Dimension | LayoutManager | 

- Font | 



- FontMetri cs 



Color 
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Classes in the j ava . awt 

package 
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■ JAppl et 



J Frame 



■ JDialog 



Lightweight 

Figure 12.1 Java GUI programming utilizes the classes shown in this hierarchical diagram. 



JButton, JLabel, „ . 

JTextField, JPanel, Sw t mg Com P onen ! s 
in the ] avax . swi ng 

package 



instance of JComponent. However, you can use the constructors of concrete subclasses of 
JComponent to create JComponent instances. It is important to become familiar with the 
class inheritance hierarchy. For example, the following statements all display true: 

JButton jbtOK = new JButton("0K") ; 
System. out. pri ntl n(jbtOK instanceof JButton); 
System. out. pn'ntln(jbtOK instanceof JComponent); 
System. out. pri ntl n(jbtOK instanceof Container); 
System. out. pri ntl n(jbtOK instanceof Component); 
System. out. pri ntl n(jbtOK instanceof Object); 



12.3.2 Container Classes 

An instance of Contai ner can hold instances of Component. Container classes are GUI com- 
ponents that are used to contain other GUI components. Wi ndow, Panel , Appl et, Frame, and 
Dialog are the container classes for AWT components. To work with Swing components, use 
Container, JFrame, JDialog, JAppl et, and JPanel , as described in Table 12.1. 



Table 12.1 GUI Container Classes 



Container Class 



Description 



java . awt . Contai ner 
j avax . swi ng . J Frame 

j avax . swi ng . J Panel 

j avax . swi ng . JAppl et 
j avax. swing. JDial og 



is used to group components. Frames, panels, and applets are its subclasses. 

is a window not contained inside another window. It is used to hold other Swing 
user-interface components in Java GUI applications. 

is an invisible container that holds user-interface components. Panels can be nested. You can place panels 
inside a container that includes a panel. JPanel is also often used as a canvas to draw graphics. 

is a subclass of Appl et. You must extend JAppl et to create a Swing-based Java applet. 

is a popup window or message box generally used as a temporary window to receive additional informa- 
tion from the user or to provide notification that an event has occurred. 
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12.3.3 GUI Helper Classes 

The helper classes, such as Graphics, Color, Font, FontMetrics, Dimension, and 
LayoutManager, are not subclasses of Component. They are used to describe the properties 
of GUI components, such as graphics context, colors, fonts, and dimension, as described in 
Table 12.2. 

Table 12.2 GUI Helper Classes 



Helper Class 



Description 



j ava . awt . Graph i cs 
j ava. awt. Col or 

j ava. awt. Font 

j ava. awt . FontMetrics 
j ava . awt .Dimension 



is an abstract class that provides the methods for drawing strings, 
lines, and simple shapes. 

deals with the colors of GUI components. For example, you can spec- 
ify background or foreground colors in components like J Frame and 
JPanel , or you can specify colors of lines, shapes, and strings in 
drawings. 

specifies fonts for the text and drawings on GUI components. 
For example, you can specify the font type (e.g., SansSerif), style 
(e.g., bold), and size (e.g., 24 points) for the text on a button. 

is an abstract class used to get the properties of the fonts. 

encapsulates the width and height of a component (in integer 
precision) in a single object. 



j ava . awt . LayoutManager specifies how components are arranged in a container. 



Note 

The helper classes are in the java.awt package. The Swing components do not replace all the 
classes in AWT, only the AWT GUI component classes (e.g., Button, TextFiel d, TextArea). 
The AWT helper classes are still useful in GUI programming. 



2.4 Frames 



To create a user interface, you need to create either a frame or an applet to hold the user-inter- 
face components. Creating Java applets will be introduced in Chapter 18, "Applets and Multi- 
media." This section introduces frames. 



import package 



create frame 
set size 
center frame 
close upon exit 
display the frame 



12.4-1 Creating a Frame 

To create a frame, use the JFrame class, as shown in Figure 12.2. 
The program in Listing 12.1 creates a frame: 

Listing 12.1 My Frame.] ava 



1 

2 

3 

4 

5 

6 

7 

8 

9 
10 
11 } 



import j avax. swi ng.3 Frame; 



public class MyFrame { 

public static void main(String[] args) { 

JFrame frame = new JFrame("MyFrame") ; // Create a frame 
frame. setSize(400, 300); // Set the frame size 
frame. setLocationRelativeTo(null) ; // Center a frame 
frame . setDef aul tCl oseOpe rati on (3 Frame . EXIT_0N_CL0SE) ; 
frame.setVisible(true) ; // Display the frame 

} 
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j a vax.s wing. JFrame 



+3Frame() 

+D Frame (title: String) 
+setSize (width : int, height: int): void 
+setl_ocation(x: int, y: int): void 
+setVi si ble (visible: boolean): void 
+setDefaultCloseOpe rati on (mode: int): void 
+setLocationRelativeTo(c: Component) : 

void 
+pack() : voi d 



Creates a default frame with no title. 
Creates a frame with the specified title. 
Sets the size of the frame. 

Sets the upper-left-corner location of the frame. 

Sets true to display the frame. 

Specifies the operation when the frame is closed. 

Sets the location of the frame relative to the specified component. 

If the component is null, the frame is centered on the screen. 
Automatically sets the frame size to hold the components in the 

frame. 



Figure 12.2 JFrame is a top-level container to hold GUI components. 



The frame is not displayed until the frame.setVisible(true) method is invoked, 
frame. setSize (400, 300) specifies that the frame is 400 pixels wide and 300 pixels 
high. If the setSize method is not used, the frame will be sized to display just the title bar. 
Since the setSi ze and setVi si bl e methods are both defined in the Component class, they 
are inherited by the JFrame class. Later you will see that these methods are also useful in 
many other subclasses of Component. 

When you run the MyFrame program, a window will be displayed on the screen (see 
Figure 12.3(a)). 



Title bar 

Content 
pane 




Title bar 

Content 
pane 



Figure 12.3 (a) The program creates and displays a frame with the title MyFrame. (b) An OK button is added to the 
frame. 



Invoking setLocationRelativeTo(null) (line 7) centers the frame on the screen. 
Invoking setDefaultClose0peration(JFrame.EXIT_0N_CL0SE) (line 8) tells the pro- 
gram to terminate when the frame is closed. If this statement is not used, the program does not 
terminate when the frame is closed. In that case, you have to stop the program by pressing 
Ctrl+C at the DOS prompt window in Windows or stop the process by using the kill com- 
mand in Unix. If you run the program from an IDE such as Eclipse or NetBeans, you need to 
click the red Terminate button in the Console pane to stop the program. 

|p Note 

Recall that a pixel is the smallest unit of space available for drawing on the screen. You can think 

of a pixel as a small rectangle and think of the screen as paved with pixels. The resolution speci- pixel and resolution 

fies the number of pixels per square inch. The more pixels the screen has, the higher the screen's 
resolution. The higher the resolution, the finer the detail you can see. 

|p Note 

You should invoke the setSize(w, h) method before invoking setLocationRelativeTo- setSize before centering 

(nul 1 ) to center the frame. 
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12.4-2 Adding Components to a Frame 

The frame shown in Figure 12.3(a) is empty. Using the add method, you can add components 
into the frame, as in Listing 12.2. 



Listing 12.2 MyFrameWithComponents. java 





± 


i mport j avax . swi 119 . ; 




L. 

3 


Mr ■ ur 

public class MyFramewi tnComponents { 




A 
4 


publ ic s tat i c voi d inain(S~tring[] args) { 




c 
-> 

6 


jrrdinc rrdiric — new jrrdinc^ riyrramewi tru^oniponenTS j, 




7 


// Add a button into the frame 


create a button 


8 


JButton jbtOK = new J Button ("OK") ; 


add to frame 


9 


f rame.add(jbtOK) ; 




10 




set size 


11 


frame.setSize(400, 300); 


exit upon closing window 


12 


frame . setDef aul tG oseOpe rati on (D Frame . EXIT_0N_CL0SE) ; 


center the frame 


13 


frame. setLocationRelativeTo(null) ; // Center the frame 


set visible 


14 


frame . setVi si bl e(true) ; 




15 


} 




16 


} 



Each JFrame contains a content pane. A content pane is an instance of java. awt .Container. 
The GUI components such as buttons are placed in the content pane in a frame. In earlier version 
of Java, you had to use the getContentPane method in the JFrame class to return the content 
pane of the frame, then invoke the content pane's add method to place a component into the con- 
tent pane, as follows: 

java. awt. Container container = frame. getContentPaneO ; 
container. add (jbtOK) ; 

This was cumbersome. The new version of Java since Java 5 allows you to place components 
into the content pane by invoking a frame's add method, as follows: 

f rame.add(jbtOK) ; 

content-pane delegation This new feature is called content-pane delegation. Strictly speaking, a component is added 

into the content pane of a frame. For simplicity we say that a component is added to a 
frame. 

An object of JButton was created using new JButton("0K"), and this object was added 
to the content pane of the frame (line 9). 

The add(Component comp) method defined in the Container class adds an instance of 
Component to the container. Since JButton is a subclass of Component, an instance of 
JButton is also an instance of Component. To remove a component from a container, use the 
remove method. The following statement removes the button from the container: 

contai ner . remove(jbtOK) ; 

When you run the program MyFrameWithComponents, the window will be displayed as in 
Figure 12.3(b). The button is always centered in the frame and occupies the entire frame no 
matter how you resize it. This is because components are put in the frame by the content 
pane's layout manager, and the default layout manager for the content pane places the button 
in the center. In the next section, you will use several different layout managers to place com- 
ponents in the desired locations. 
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12.5 Layout Managers 

In many other window systems, the user-interface components are arranged by using hard- 
coded pixel measurements. For example, put a button at location (10, 10) in the window. 
Using hard-coded pixel measurements, the user interface might look fine on one system but 
be unusable on another. Java's layout managers provide a level of abstraction that automati- 
cally maps your user interface on all window systems. 

The Java GUI components are placed in containers, where they are arranged by the con- 
tainer's layout manager. In the preceding program, you did not specify where to place the OK 
button in the frame, but Java knows where to place it, because the layout manager works 
behind the scenes to place components in the correct locations. A layout manager is created 
using a layout manager class. 

Layout managers are set in containers using the setLayout(aLayoutManager) method. 
For example, you can use the following statements to create an instance of XLayout and set 
it in a container: 

LayoutManager I ayoutManager = new XLayoutO; 
contai ner . setLayout(l ayoutManager) ; 

This section introduces three basic layout managers: FlowLayout, GridLayout, and Bord- 
er Layout. 



12.5.1 FlowLayout 

Fl ow Layout is the simplest layout manager. The components are arranged in the container from 

left to right in the order in which they were added. When one row is filled, a new row is started. 

Video Note 

You can specify the way the components are aligned by using one of three constants: Fl owLay- y se p-| 0W |_ a y y ^ 
out. RIGHT, FlowLayout. CENTER, or FlowLayout. LEFT. You can also specify the gap 
between components in pixels. The class diagram for Fl owLayout is shown in Figure 12.4. 



java.awt.FlowLayout 



-alignment: int 
-hgap: int 
-vgap: int 



+FlowLayout() 

+F1 owLayout (al i gnment : int) 
+FlowLayout(al i gnment : int, hgap: 
int, vgap: int) 



The get and set methods for these data 
fields are provided in the class, but 
omitted in the UML diagram for brevity. 



"1 



The alignment of this layout manager (default: CENTER). 
The horizontal gap of this layout manager (default: 5 pixels). 
The vertical gap of this layout manager (default: 5 pixels). 

Creates a default Fl owLayout manager. 
Creates a Fl owLayout manager with a specified alignment. 
Creates a Fl owLayout manager with a specified alignment, 
horizontal gap, and vertical gap. 



Figure 12.4 Fl owLayout lays out components row by row. 



Listing 12.3 gives a program that demonstrates flow layout. The program adds three labels 
and text fields into the frame with a FlowLayout manager, as shown in Figure 12.5. 

Listing 12.3 ShowFl owLayout . java 

1 import javax. swi ng . D Label ; 

2 import javax. swing. JTextField; 

3 import javax. swing. J Frame; 
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extends 3 Frame 



set layout 



add label 
add text field 



create frame 
set visible 



4 
5 
6 
7 
8 
9 
10 
11 
12 
13 
14 
15 
16 
17 
18 
19 
20 
21 
22 
23 
24 
25 
26 
27 
28 
29 
30 



import java. awt . Fl owLayout ; 

public class ShowFl owLayout extends JFrame { 
public ShowFl owLayout () { 

// Set Fl owLayout, aligned left with horizontal gap 10 
// and vertical gap 20 between components 
setLayout(new FlowLayout(FlowLayout. LEFT, 10, 20)); 

// Add labels and text fields to the frame 

add(new JLabel ("First Name")); 

add(new JTextField(8)) ; 

add (new J Label ("MI")) ; 

add(new JTextField(l)) ; 

add(new JLabel ("Last Name")); 

add(new JTextField(8)) ; 

} 

/** Main method */ 

public static void mai n (Stri ng [] args) { 

ShowFl owLayout frame = new ShowFl owLayout () ; 
frame . setTi tl e ("ShowFl owLayout") ; 
frame.setSize(200, 200); 

frame. setLocationRelativeTo(null) ; // Center the frame 
frame . setDef aul tCl oseOpe rati on (1 Frame . EXIT_0N„CL0SE) ; 
frame . setVi si bl e(true) ; 

} 



I ShowFlow 



First Name 



Ml 



J Last Name 



First Name 



Last Name 



Ml □ 



(a) 



(b) 



Figure 12.5 The components are added by the Fl owLayout manager to fill in the rows in 
the container one after another. 



This example creates a program using a style different from the programs in the preceding sec- 
tion, where frames were created using the JFrame class. This example creates a class named 
ShowFl owLayout that extends the JFrame class (line 6). The main method in this program 
creates an instance of ShowFl owLayout (line 23). The constructor of ShowFl owLayout con- 
structs and places the components in the frame. This is the preferred style of creating GUI 
applications — for three reasons: 

■ Creating a GUI application means creating a frame, so it is natural to define a frame 
to extend JFrame. 

■ The frame may be further extended to add new components or functions. 

■ The class can be easily reused. For example, you can create multiple frames by 
creating multiple instances of the class. 

Using one style consistently makes programs easy to read. From now on, most of the GUI main 
classes will extend the JFrame class. The constructor of the main class constructs the user inter- 
face. The mai n method creates an instance of the main class and then displays the frame. 
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In this example, the FlowLayout manager is used to place components in a frame. If you 
resize the frame, the components are automatically rearranged to fit. In Figure 12.5(a), the 
first row has three components, but in Figure 12.5(a), the first row has four components, 
because the width has been increased. 

If you replace the setLayout statement (line 10) with set Layout (new FlowLayout- 
(FlowLayout . RIGHT, 0, 0)), all the rows of buttons will be right aligned with no gaps. 

An anonymous FlowLayout object was created in the statement (line 10): 

setLayout(new FIowLayout(Fl owLayout . LEFT, 10, 20)); 

which is equivalent to: 

FlowLayout layout = new FlowLayout(FIowLayout. LEFT, 10, 20); 
setLayout(layout) ; 

This code creates an explicit reference to the object layout of the FlowLayout class. The 
explicit reference is not necessary, because the object is not directly referenced in the 
ShowFl owLayout class. 

Suppose you add the same button into the frame ten times; will ten buttons appear in the 
frame? No, a GUI component such as a button can be added into only one container and only 
once in a container. Adding a button into a container multiple times is the same as adding it once. 




Caution 



Do not forget to put the new operator before a layout manager class when setting a layout style — 
for example, setLayout (new Fl owLayout ()). 

|p Note 

The constructor ShowFl owLayout () does not explicitly invoke the constructor DFrameO, 
but the constructor DFrameO is invoked implicitly. See § 1 1.3.2, "Constructor Chaining." 

12.5.2 GridLayout 

The GridLayout manager arranges components in a grid (matrix) formation. The compo- 
nents are placed in the grid from left to right, starting with the first row, then the second, and 
so on, in the order in which they are added. The class diagram for GridLayout is shown in 
Figure 12.6. 



_ 



java.awt.GndLayoui 



-rows: int 






-columns: int 






-hgap: int 






-vgap: int 






+Cn'dLayout() 






+Cn'dLayout(rows : 


int, columns: 


int) 


+Cn'dLayout(rows : 


int, columns: 


i nt , 


hgap: int, vgap 


: int) 





The get and set methods for these data 
fields are provided in the class, but 
omitted in the UML diagram for brevity 



The number of rows in this layout manager (default: 1). 
The number of columns in this layout manager (default: 1). 
The horizontal gap of this layout manager (default: 0). 
The vertical gap of this layout manager (default: 0). 

Creates a default Cri dLayout manager. 

Creates a Cri dLayout with a specified number of rows and columns. 

Creates a Cri dLayout manager with a specified number of rows and 
columns, horizontal gap, and vertical gap. 



Figure 12.6 GridLayout lays out components in equal-sized cells on a grid. 



414 Chapter 12 GUI Basics 

You can specify the number of rows and columns in the grid. The basic rule is as follows: 

■ The number of rows or the number of columns can be zero, but not both. If one is 
zero and the other is nonzero, the nonzero dimension is fixed, while the zero dimen- 
sion is determined dynamically by the layout manager. For example, if you specify 
zero rows and three columns for a grid that has ten components, GridLayout cre- 
ates three fixed columns of four rows, with the last row containing one component. If 
you specify three rows and zero columns for a grid that has ten components, 
GridLayout creates three fixed rows of four columns, with the last row containing 
two components. 

■ If both the number of rows and the number of columns are nonzero, the number of 
rows is the dominating parameter; that is, the number of rows is fixed, and the layout 
manager dynamically calculates the number of columns. For example, if you specify 
three rows and three columns for a grid that has ten components, GridLayout cre- 
ates three fixed rows of four columns, with the last row containing two components. 

Listing 12.4 gives a program that demonstrates grid layout. The program is similar to the one 
in Listing 12.3. It adds three labels and three text fields to the frame of GridLayout instead 
of FlowLayout, as shown in Figure 12.7. 

Listing 12.4 ShowCridLayout . java 

1 import javax. swi ng . 3Label ; 

2 import javax. swing. JTextField; 

3 import javax. swing. 3 Frame; 

4 import java. awt. GridLayout; 
5 

6 public class ShowGri dLayout extends 3Frame { 

7 public ShowGri dLayoutO { 

8 // Set GridLayout, 3 rows, 2 columns, and gaps 5 between 

9 // components horizontally and vertically 
10 setLayout(new Gri dLayout(3 , 2, 5, 5)); 
11 

12 // Add labels and text fields to the frame 

13 add(new ILabel ("First Name")); 

14 add(new 3TextField(8)) ; 

15 add(new ILabel ("MI")) ; 

16 add(new ITextField(l)) ; 

17 add(new DLabel ("Last Name")); 

18 add(new DTextField(8)) ; 

19 } 
20 

21 /** Main method */ 

22 public static void mai n (Stri ng [] args) { 

23 ShowGri dLayout frame = new ShowGri dLayout () ; 

24 frame. setTitle("ShowGridLayout") ; 

25 frame. setSize(200, 125); 

26 frame. setLocationRelati veTo(null) ; // Center the frame 

27 frame . setDef aul tCl oseOperati on (3 Frame . EXIT_0N_CL0SE) ; 

28 frame.setVisible(true) ; 

29 } 

30 } 



set layout 

add label 
add text field 



create a frame 
set visible 



If you resize the frame, the layout of the buttons remains unchanged (i.e., the number of rows 
and columns does not change, and the gaps don't change either). 

All components are given equal size in the container of GridLayout. 



12.5 Layout Managers 415 



First Name 
Ml 

Last Name 



Figure 12.7 The GridLayout manager divides the container into grids; then the compo- 
nents are added to fill in the cells row by row. 



Replacing the setLayout statement (line 10) with setLayout(new GridLayout(3 , 

10)) would still yield three rows and two columns. The columns parameter is ignored 
because the rows parameter is nonzero. The actual number of columns is calculated by the 
layout manager. 

What would happen if the setLayout statement (line 10) were replaced with setLay- 
out(new GridLayout (4, 2)) or with setLayout (new GridLayout(2 , 2))? Please 
try it yourself. 

§ Note 

In FlowLayout and GridLayout, the order in which the components are added to the con- 
tainer is important. It determines the location of the components in the container. 

12.5.3 Border Layout 

The BorderLayout manager divides a container into five areas: East, South, West, North, 
and Center. Components are added to a BorderLayout by using add (Component , 
index), where index is a constant BorderLayout . EAST, Border Layout. SOUTH, 
BorderLayout .WEST, BorderLayout .NORTH, or BorderLayout .CENTER. The class dia- 
gram for BorderLayout is shown in Figure 12.8. 



java.awt.BorderLayout 



-hgap: int 
-vgap: int 



nBorderLayoutO 

hBorderl_ayout(hgap : int, vgap: int) 



The get and set methods for these data 
fields are provided in the class, but 
omitted in the UML diagram for brevity. 



The horizontal gap of this layout manager (default: 0). 
The vertical gap of this layout manager (default: 0). 

Creates a default BorderLayout manager. 

Creates a BorderLayout manager with a specified number of 
horizontal gap, and vertical gap. 



Figure 12.8 BorderLayout lays out components in five areas. 



The components are laid out according to their preferred sizes and their placement in the 
container. The North and South components can stretch horizontally; the East and West com- 
ponents can stretch vertically; the Center component can stretch both horizontally and verti- 
cally to fill any empty space. 

Listing 12.5 gives a program that demonstrates border layout. The program adds five but- 
tons labeled East, South, West, North, and Center into the frame with a BorderLayout 
manager, as shown in Figure 12.9. 
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Listing 12.5 ShowBorderLayout. java 



set layout 



add buttons 



create a frame 
set visible 



1 
2 
3 
4 
5 
6 
7 
8 
9 
10 
11 
12 
13 
14 
15 
16 
17 
18 
19 
20 
21 
22 
23 
24 
25 
26 
27 



import javax. swi ng . 3 Button ; 
import javax. swing. J Frame; 
import java.awt.BorderLayout; 

public class ShowBorderLayout extends DFrame { 
public ShowBorderLayoutO { 

// Set BorderLayout with horizontal gap 5 and vertical gap 10 
setLayout(new BorderLayout(5 , 10)); 

// Add buttons to the frame 
add(new ]Button("East") , BorderLayout . EAST) ; 
add(new ]Button("South") , BorderLayout . SOUTH) ; 
add(new ]Button("West") , BorderLayout .WEST) ; 
add(new ]Button("North") , BorderLayout . NORTH) ; 
add(new ]Button("Center") , BorderLayout . CENTER) ; 

} 

/** Main method */ 

public static void main(String[] args) { 

ShowBorderLayout frame = new ShowBorderLayoutO; 
frame . setTi tl e ("ShowBorderLayout") ; 
frame. setSize(300, 200); 

frame. setLocationRelativeTo(null) ; // Center the frame 
frame . setDef aul tCl oseOperati on (D Frame . EXIT_0N_CL0SE) ; 
frame . setVi si bl e (true) ; 

} 
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west 


tenner 
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Figure 12.9 BorderLayout divides the container into five areas, each of which can hold a 
component. 



The buttons are added to the frame (lines 1 1-15). Note that the add method for BorderLayout 
is different from the one for Fl owLayout and GridLayout. With BorderLayout you specify 
where to put the components. 

It is unnecessary to place components to occupy all the areas. If you remove the East but- 
ton from the program and rerun it, you will see that the center stretches rightward to occupy 
the East area. 

§ Note 

BorderLayout interprets the absence of an index specification as Border Layout. CENTER. 
For example, add (component) is the same as add (Component , Border Layout. CEN- 
TER) . If you add two components into a container of BorderLayout, as follows, 

container. add (componentl) ; 
container. add(component2) ; 

only the last component is displayed. 
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12.5.4 Properties of Layout Managers 

Layout managers have properties that can be changed dynamically. FlowLayout has 
al ignment, hgap, and vgap properties. You can use the setAl ignment, setHgap, and 
setVgap methods to specify the alignment and the horizontal and vertical gaps. CridLayout 
has the rows, col umns, hgap, and vgap properties. You can use the setRows, setCol umns, 
setHgap, and setVgap methods to specify the number of rows, the number of columns, and 
the horizontal and vertical gaps. Border Layout has the hgap and vgap properties. You can 
use the setHgap and setVgap methods to specify the horizontal and vertical gaps. 

In the preceding sections an anonymous layout manager is used because the properties of a 
layout manager do not change, once it is created. If you have to change the properties of a lay- 
out manager dynamically, the layout manager must be explicitly referenced by a variable. You 
can then change the properties of the layout manager through the variable. For example, the 
following code creates a layout manager and sets its properties: 

// Create a layout manager 
FlowLayout fl owLayout = new FlowLayout () ; 

// Set layout properties 
f 1 owLayout . setAl i gnment (Fl owLayout . RIGHT) ; 
flowLayout.setHgap(lO) ; 
fl owLayout. setVgap(20) ; 

12.6 Using Panels as Subcontainers 

Suppose that you want to place ten buttons and a text field in a frame. The buttons are placed in 
grid formation, but the text field is placed on a separate row. It is difficult to achieve the desired 
look by placing all the components in a single container. With Java GUI programming, you can 
divide a window into panels. Panels act as subcontainers to group user-interface components. 
You add the buttons in one panel, then add the panel into the frame. 

The Swing version of panel is JPanel . You can use new JPanel () to create a panel with 
a default FlowLayout manager or new JPanel (LayoutManager) to create a panel with 
the specified layout manager. Use the add (Component) method to add a component to the 
panel. For example, the following code creates a panel and adds a button to it: 

JPanel p = new JPanel (); 
p.add(new JButton("OK")) ; 

Panels can be placed inside a frame or inside another panel. The following statement places 
panel p into frame f : 

f.add(p); 

Listing 12.6 gives an example that demonstrates using panels as subcontainers. The program 
creates a user interface for a microwave oven, as shown in Figure 12.10. 

Listing 12.6 Test Panel s.java 

1 import java.awt.*; 

2 import javax. swing.*; 
3 

4 public class TestPanels extends JFrame { 

5 public TestPanelsO { 

6 // Create panel pi for the buttons and set GridLayout 

7 JPanel pi = new JPanel (); panel pi 

8 pi . setLayout(new Gri dLayout(4 , 3)); 
9 




Video Note 

Use panels as subcontainers 



418 Chapter 12 GUI Basics 



10 // Add buttons to the panel 

11 for (int i = 1; i <= 9; i++) { 

12 pl.add(new ]Button("" + i)); 

13 } 
14 

15 pl.add(new JButtonC"" + 0)); 

16 pl.add(new JButton("Start")) ; 

17 pi. add (new J Button ("Stop")) ; 
18 

19 // Create panel p2 to hold a text field and pi 

panel p2 20 IPanel p2 = new JPanel(new BorderLayoutO) ; 

21 p2. add (new JTextFi eld ("Time to be displayed here"), 

22 BorderLayout . NORTH) ; 

23 p2.add(pl, BorderLayout. CENTER) ; 
24 

25 // add contents into the frame 

addp2toframe 26 add(p2, BorderLayout . EAST) ; 

27 add(new JButton("Food to be placed here"), 

28 BorderLayout. CENTER) ; 

29 } 
30 

31 /** Main method */ 

32 public static void mai n (Stri ng [] args) { 

33 TestPanels frame = new TestPanel s() ; 

34 frame. setTitle("The Front View of a Microwave Oven"); 

35 frame. setSize (400, 250); 

36 frame. setLocationRelativeTo(null) ; // Center the frame 

37 frame . setDef aul tCl oseOperati on (D Frame . EXIT_0N_CL0SE) ; 

38 frame.setVisible(true) ; 

39 } 

40 } 
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Figure 12.10 The program uses panels to organize components. 



The setLayout method is defined in java.awt .Container. Since JPanel is a subclass of 
Contai ner, you can use setLayout to set a new layout manager in the panel (line 8). Lines 
7-8 can be replaced by JPanel pi = new JPanel (new GridLayout(4, 3)). 

To achieve the desired layout, the program uses panel pi of GridLayout to group the 
number buttons, the Stop button, and the Start button, and panel p2 of BorderLayout to hold 
a text field in the north and pi in the center. The button representing the food is placed in the 
center of the frame, and p2 is placed in the east of the frame. 

The statement (lines 21-22) 

p2.add(new JTextField("Time to be displayed here"), 
BorderLayout . NORTH) ; 

creates an instance of JTextFi el d and adds it to p2. JTextFi el d is a GUI component that 
can be used for user input as well as to display values. 



12.8 The Font Class 419 



§ Note 

It is worthwhile to note that the Container class is the superclass for GUI component classes, superclass Container 

such as JButton. Every GUI component is a container. In theory, you could use the 
setLayout method to set the layout in a button and add components into a button, because all 
the public methods in the Container class are inherited into JButton, but for practical rea- 
sons you should not use buttons as containers. 

12.7 The Color Class 

You can set colors for GUI components by using the java.awt.Color class. Colors are 
made of red, green, and blue components, each represented by an i nt value that describes its 
intensity, ranging from (darkest shade) to 255 (lightest shade). This is known as the RGB 
model. 

You can create a color using the following constructor: 
public Color(int r, int g, int b) ; 
in which r, g, and b specify a color by its red, green, and blue components. For example, 
Color color = new Color(128, 100, 100); 

# Note 

The arguments r, g, b are between and 255. If a value beyond this range is passed to the argu- 
ment, an IllegalArgumentException will occur. IllegalArgumentException 

You can use the setBackground(Col or c) and setForeground(Color c) methods 
defined in the j ava . awt . Component class to set a component's background and foreground 
colors. Here is an example of setting the background and foreground of a button: 

JButton jbtOK = new JButton("OK") ; 

jbtOK. setBackground(col or) ; 

jbtOK. setForeground(new Color(100, 1, 1)); 

Alternatively, you can use one of the 13 standard colors (BLACK, BLUE, CYAN, DARK_GRAY, 
CRAY, GREEN, LICHT_GRAY, MAGENTA, ORANGE, PINK, RED, WHITE, and YELLOW) defined as 
constants in java . awt . Col or. The following code, for instance, sets the foreground color of 
a button to red: 

jbtOK. set Foreground (Col or . RED) ; 

12.8 The Font Class 

You can create a font using the j ava . awt . Font class and set fonts for the components using 
the setFont method in the Component class. 
The constructor for Font is: 

public Font(String name, int style, int size); 

You can choose a font name from SansSerif, Serif, Monospaced, Dialog, or 
Dialoglnput, choose a style from Font. PLAIN (0), Font. BOLD (1), Font. ITALIC (2), 
and Font. BOLD + Font. ITALIC (3), and specify a font size of any positive integer. For 
example, the following statements create two fonts and set one font to a button. 

Font fontl = new Font("SansSeri f " , Font. BOLD, 16); 

Font font2 = new Font("Seri f " , Font. BOLD + Font. ITALIC, 12); 



IButton jbtOK = new JButton("0K") ; 
jbtOK. setFont (fontl) ; 
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# Tip 

[f your system supports other fonts, such as "Times New Roman," you can use it to create a 
find available fonts Font object. To find the fonts available on your system, you need to obtain an instance of 

java.awt.GraphicsEnvironment using its static method getLocalGraphicsEnvi- 
ronment(). GraphicsEnvironment is an abstract class that describes the graphics environ- 
ment on a particular system. You can use its getAll FontsO method to obtain all the available 
fonts on the system and its getAvailableFontFamilyNamesO method to obtain the 
names of all the available fonts. For example, the following statements print all the available font 
names in the system: 

GraphicsEnvironment e = 

GraphicsEnvi ronment.getLocalGraphicsEnvi ronmentO ; 
String[] fontnames = e. getAvailableFontFamilyNamesO ; 

for (int i = 0; i < fontnames . 1 ength ; i++) 
System . out . pri ntl n (fontnames [i ] ) ; 



Component 



Video Note 

Use Swing common properties 



12.9 Common Features of Swing GUI Components 

In this chapter you have used several GUI components (e.g., JFrame, Container, JPanel , 
JButton, J Label, JTextField). Many more GUI components will be introduced in this 
book. It is important to understand the common features of Swing GUI components. The 



java.awt.Component 



-font: java. awt . Font 
-background: java. awt. Color 
-foreground: java. awt. Color 
-prefer redSize : java. awt . Dimension 
-visible: boolean 



+getWidth(): int 
+getHeight() : int 
+getX(): int 
+getY(): int 



=F 

java.awt.Container 



+add(comp: Component): Component 
+add(comp: Component, index: int): Component 
+remove(comp: Component): void 
+getl_ayout() : LayoutManager 
+setl_ayout(l : LayoutManager): void 
+paintComponents(g: Graphics): void 



javax.swing.JComponent 



-toolTipText: String 

-border: javax . swi ng . border . Border 



The get and set methods for these data^k 
fields are provided in the class, but 
omitted in the UML diagram for brevity. 



The font of this component. 
The background color of this component. 
The foreground color of this component. 
The preferred size of this component. 
Indicates whether this component is visible. 

Returns the width of this component. 
Returns the height of this component. 
getX() and getY() return the coordinate of the 
component's upper-left corner within its parent component. 



Adds a component to the container. 

Adds a component to the container with the specified index. 
Removes the component from the container. 
Returns the layout manager for this container. 
Sets the layout manager for this container. 
Paints each of the components in this container. 



The get and set methods for these data^^ 
fields are provided in the class, but 
omitted in the UML diagram for brevity. 



The tool tip text for this component. Tool tip text is displayed when 
the mouse points on the component without clicking. 

The border for this component. 



Figure 12.1 1 All the Swing GUI components inherit the public methods from Component, Container, and ^Component. 
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Component class is the root for all GUI components and containers. All Swing GUI compo- 
nents (except JFrame, JApplet, and JDialog) are subclasses of ^Component, as shown in Container 
Figure 12.1. Figure 12.11 lists some frequently used methods in Component, Container, 
and ^Component for manipulating properties such as font, color, size, tool tip text, and bor- ^Component 
der. 

A tool tip is text displayed on a component when you move the mouse on the component. 
It is often used to describe the function of a component. 

You can set a border on any object of the ^Component class. Swing has several types of 
borders. To create a titled border, use new TitledBorder(String title). To create aline 
border, use new LineBorder(Color color, int width), where width specifies the 
thickness of the line. 

Listing 12.7 is an example to demonstrate Swing common features. The example creates a 
panel pi to hold three buttons (line 8) and a panel p2 to hold two labels (line 25), as shown in 
Figure 12.12. The background of the button jbtLeft is set to white (line 12) and the fore- 
ground of the button jbtCenter is set to green (line 13). The tool tip of the button jbtRight 
is set in line 14. Titled borders are set on panels pi and p2 (lines 18, 36) and line borders are 
set on the labels (lines 32-33). 



Titled border 



Titled border 
Line border 



^t. Tests wingCommonFeatures 



Three Buttons 
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Right 
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Having the mouse cursor 
over the Right button 
^displays the tool tip text 



Figure 12.12 The font, color, border, and tool tip text are set in the message panel. 



Listing 12.7 TestSwi ngCommonFeatures . java 



1 

2 
3 
4 
5 
6 
7 
8 
9 
10 
11 
12 
13 
14 
15 
16 
17 
18 
19 
20 
21 
22 
23 
24 



import java.awt.*; 
import javax. swi ng . * ; 
import javax. swing. border.*; 

public class TestSwi ngCommonFeatures extends JFrame { 
public TestSwi ngCommonFeatures () { 

// Create a panel to group three buttons 

JPanel pi = new JPanel(new FlowLayout(FlowLayout. LEFT, 2, 2)); 

JButton jbtLeft = new JButton("Left") ; 

JButton jbtCenter = new JButton("Center") ; 

JButton jbtRight = new JButton("Right") ; 

jbtLeft. setBackg round (Col or. WHITE) ; 

jbtCenter . setForeg round (Col or . GREEN) ; 

jbtRight. setToolTi pText ("This is the Right button"); 

pi. add (jbtLeft) ; 

pl.add(jbtCenter) ; 

pi. add (jbtRight) ; 

pi. setBorder(new Ti tl edBorder("Three Buttons")); 

// Create a font and a line border 

Font largeFont = new Font("TimesRoman" , Font. BOLD, 20); 
Border lineBorder = new LineBorder(Color. BLACK, 2); 

// Create a panel to group two labels 



set background 
set foreground 
set tool tip text 



set titled border 



create a font 
create a border 
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set foreground 

set font 

set line border 

set titled border 



25 
26 
27 
28 
29 
30 
31 
32 
33 
34 
35 
36 
37 
38 
39 
40 
41 
42 
43 
44 
45 
46 
47 
48 
49 
50 
51 
52 

53 } 



J Panel p2 = new J Panel (new GridLayout(l, 2, 5, 5)); 

JLabel jlblRed = new ] Label ("Red") ; 

JLabel jlblOrange = new J Label ("Orange") ; 

jl bl Red . set Foreground (Col or . RED) ; 

jlblOrange . set Foreground (Col or .ORANGE) ; 

jlblRed. setFont(largeFont) ; 

jl bl Orange . set Font (1 argeFont) ; 

jlblRed. setBorder(l i neBorder) ; 

jlblOrange . setBorder(l i neBorder) ; 

p2. add (jlblRed) ; 

p2.add(jlbl0range) ; 

p2 . setBorder(new Ti tl edBorder("Two Labels")); 

// Add two panels to the frame 
setLayout(new Gri dLayout(2 , 1, 5, 5)); 
add (pi); 
add(p2); 

} 

public static void main(String[] args) { 

// Create a frame and set its properties 
JFrame frame = new TestSwi ngCommonFeatures() ; 
frame . setTitl e ("TestSwi ngCommonFeatures") ; 
frame. setSize(300, 150); 

frame. setLocationRelati veTo(null) ; // Center the frame 
frame . setDef aul tCl oseOpe rati on ( J Frame . EXIT_0N__CL0SE) ; 
frame . setVi si bl e (true) ; 

} 



property default values 



Note 

The same property may have different default values in different components. For example, the 
visible property in JFrame is false by default, but it is true in every instance of 
JComponent (e.g., JButton and JLabel) by default. To display a JFrame, you have to 
invoke setVisible(true) to set the visible property true, but you don't have to set this 
property for a JButton or a JLabel, because it is already true. To make a JButton or a 
JLabel invisible, you may invoke setVisible(false). Please run the program and see the 
effect after inserting the following two statements in line 37: 

j btLeft.setVi si ble (false) ; 
j 1 bl Red. setVi si ble (false) ; 



12.10 Image Icons 

An icon is a fixed-size picture; typically it is small and used to decorate components. Images 
are normally stored in image files. Java currently supports three image formats: GIF (Graph- 
ics Interchange Format), JPEG (Joint Photographic Experts Group), and PNG (Portable Net- 
work Graphics). The image file names for these types end with .gif, jpg, and .png, 
image-file format respectively. If you have a bitmap file or image files in other formats, you can use image-pro- 

cessing utilities to convert them into GIF, JPEG, or PNG format for use in Java. 

To display an image icon, first create an Imagelcon object using new 
javax. swing. Imagelcon (filename). For example, the following statement creates an 
icon from an image file us . gi f in the image directory under the current class path: 



create Imagelcon 
file path character 



Imagelcon icon = new Imagelcon ("image/us. gi f ") ; 



"image/us. gif" is located in "c:\book\image\us.gif." The back slash (\) is the 
Windows file path notation. In Unix, the forward slash (/) should be used. In Java, the forward 
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slash (/) is used to denote a relative file path under the Java classpath (e.g., image/us . gi f , as 
in this example). 



Tip 

File names are not case sensitive in Windows but are case sensitive in Unix. To enable your pro- 
grams to run on all platforms, name all the image files consistently, using lowercase. 

An image icon can be displayed in a label or a button using new JLabel ("image- 
Icon) or new JButton(imagelcon). Listing 12.8 demonstrates displaying icons in 
labels and buttons. The example creates two labels and two buttons with icons, as shown 
in Figure 12.13. 

Listing 12.8 Testlmagelcon . java 



naming files consistently 



1 

2 

3 

4 

5 

6 

7 

8 

9 
10 
11 
12 
13 
14 
15 
16 
17 
18 
19 
20 
21 
22 
23 
24 
25 
26 

27 } 



import javax. swi ng . 
import java.awt.*; 

public class Testlmagelcon extends JFrame { 



private 


Imagelcon 


uslcon 


= new 


ImagelconC 


image/us. gif") ; 


private 
private 
private 


Imagelcon 
Imagelcon 
Imagelcon 


mylcon 
f ricon 
uklcon 


= new 
= new 
= new 


ImagelconC 
ImagelconC 
ImagelconC 


image/my . jpg") ; 
image/fr.gif") ; 
image/uk.gif") ; 



public Testlmagelcon () { 

setLayout(new Gri dLayout(l , 4, 5, 5)); 
add(new JLabel (uslcon)) ; 
add(new JLabel (mylcon)) ; 
add(new JButton(f ricon)) ; 
add(new JButton(uklcon)) ; 

} 

/** Main method */ 

public static void main(String[] args) { 
Testlmagelcon frame = new Testlmagelcon () ; 
frame . setTi tl e ("Testlmagelcon") ; 
frame.setSize(200, 200); 

frame. setLocationRelativeTo(null) ; // Center the frame 
frame . setDef aul tCl oseOperati on (J Frame . EXIT_0N_CL0SE) ; 
frame . setVi si bl e (true) ; 

} 



create image icons 



a label with image 
a button with image 



I Testlmagelcon 




Figure 12.1 3 The image icons are displayed in labels and buttons. 



||| Note 

GUI components cannot be shared by containers, because one GUI component can appear in 
only one container at a time. Therefore, the relationship between a component and a container is 
the composition denoted by a solid diamond, as shown in Figure 12.1 . 
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IP Note 

sharing borders and icons Borders and icons can be shared. Thus you can create a border or icon and use it to set the 

border or icon property for any GUI component. For example, the following statements set a 
border b for two panels pi and p2: 

pi. setBorder(b) ; 
p2 . setBorder(b) ; 

The following statements set an icon in two buttons jbtl and jbt2: 

jbtl. setIcon(i con) ; 
jbt2 . setIcon(i con) ; 

# Tip 

splash screen A splash screen is an image that is displayed while the application is starting up. If your program 

takes a long time to load, you may display a splash screen to alert the user. For example, the fol- 
lowing command: 

java -spl ash :i mage/us. gif Testlmagelcon 

displays an image while the program Testlmagelcon is being loaded. 
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I . Every container has a layout manager that is used to position and place components in 
the container in the desired locations. Three simple and frequently used layout man- 
agers are Flow/Layout, CridLayout, and Border Layout. 



2 . You can use a J Panel as a subcontainer to group components to achieve a desired layout. 

3. Use the add method to place components to a JFrame or a JPanel . By default, the 
frame's layout is BorderLayout, and the JPanel 's layout is FlowLayout. 

4. You can set colors for GUI components by using the java . awt . Col or class. Colors 
are made of red, green, and blue components, each represented by an unsigned byte 
value that describes its intensity, ranging from (darkest shade) to 255 (lightest 
shade). This is known as the RGB model. 

5. To create a Color object, use new Col or (r, g, b), in which r, g, and b specify a 
color by its red, green, and blue components. Alternatively, you can use one of the 13 
standard colors (BLACK, BLUE, CYAN, DARK_GRAY, GRAY, GREEN, LIGHT_GRAY, 
MAGENTA, ORANGE, PINK, RED, WHITE, YELLOW) defined as constants in 
java. awt. Col or. 

6. Every Swing GUI component is a subclass of javax . swing . ^Component, and 
^Component is a subclass of java. awt. Component. The properties font, 
background, foreground, height, width, and preferredSize in Component 
are inherited in these subclasses, as are toolTipText and border in ^Component. 

7. You can use borders on any Swing components. You can create an image icon using the 
Imagelcon class and display it in a label and a button. Icons and borders can be shared. 
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Sections 12.3-12.4 

12.1 Which class is the root of the Java GUI component classes? Is a container class a 
subclass of Component? Which class is the root of the Swing GUI component 
classes? 

1 2 .2 Explain the difference between AWT GUI components, such as j ava . awt . Button, 
and Swing components, such as javax . swi ng . JButton. 

12.3 How do you create a frame? How do you set the size for a frame? How do you get 
the size of a frame? How do you add components to a frame? What would happen 
if the statements f rame . setSize(400 , 300) and frame.setVisible(true) 
were swapped in Listing 12.2 MyFrameWithComponents? 

1 2.4 Determine whether the following statements are true or false: 

■ You can add a button to a frame. 

■ You can add a frame to a panel. 

■ You can add a panel to a frame. 

■ You can add any number of components to a panel or a frame. 

■ You can derive a class from JButton, JPanel , or JFrame. 

1 2.5 The following program is supposed to display a button in a frame, but nothing is 
displayed. What is the problem? 

1 public class Test extends javax. swing. J Frame { 

2 public TestO { 

3 add(new javax. swing. JButton("0K")) ; 

4 } 
5 

6 public static void mai n(Stri ng [] args) { 

7 javax. swing. JFrame frame = new javax. swing. JFrameO ; 

8 frame. setSize(100, 200); 

9 frame . setVi si bl e(true) ; 

10 } 

11 } 

12.6 Which of the following statements have syntax errors? 

Component cl = new ComponentO; 
^Component c2 = new JComponentO ; 
Component c3 = new JButtonO; 
^Component c4 = new JButtonO; 
Container c5 = new JButtonO; 
c5.add(c4) ; 

Object c6 = new JButtonO; 
c5.add(c6) ; 

Sections 12.5 

12.7 Why do you need to use layout managers? What is the default layout manager for 
a frame? How do you add a component to a frame? 

12.8 Describe Fl owLayout. How do you create a Fl owLayout manager? How do you 
add a component to a Fl owLayout container? Is there a limit to the number of 
components that can be added to a Fl owLayout container? 

12.9 Describe GridLayout. How do you create a GridLayout manager? How do you 
add a component to a GridLayout container? Is there a limit to the number of 
components that can be added to a GridLayout container? 
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12.10 Describe BorderLayout. How do you create a BorderLayout manager? How 
do you add a component to a BorderLayout container? 

Section 12.6 

12.11 How do you create a panel with a specified layout manager? 

12.12 What is the default layout manager for a JJPanel ? How do you add a component 
to a JPanel? 

12.1 3 Can you use the setTitle method in a panel? What is the purpose of using a 
panel? 

12.14 Since a GUI component class such as JButton is a subclass of Container, can 

you add components into a button? 

Sections 12.7-12.8 

12.15 How do you create a color? What is wrong about creating a Color using new 
Col or (400, 200, 300)? Which of two colors is darker, new Col or (10, 0, 0) 
or new Col or (200, 0, 0)? 

12.16 How do you create a font? How do you find all available fonts on your system? 
Sections 12.9-12.10 

12.1 7 How do you set background color, foreground color, font, and tool tip text on a 
Swing GUI component? Why is the tool tip text not displayed in the following 
code? 

1 import javax . swi ng . * ; 
2 

3 public class Test extends J Frame { 

4 private JButton jbtOK = new JButton("0K") ; 
5 

6 public static void mai n(Stri ng [] args) { 

7 // Create a frame and set its properties 

8 JFrame frame = new TestO; 

9 frame. setTitle ("Logic Error"); 

10 frame. setSize(200, 100); 

11 frame . setDef aul tCl oseOperati on (J Frame . EXIT_0N_CL0SE) ; 

12 frame . setVi si bl e(true) ; 

13 } 
14 

15 public TestO { 

16 jbtOK.setToolTipText("This is a button"); 

17 add(new JButton("0K") ) ; 

18 } 

19 } 

12.18 Show the output of the following code: 
import javax . swi ng . * ; 

public class Test { 

public static void mai n(Stri ng [] args) { 
JButton jbtOK = new JButton("0K") ; 
System. out . pri ntl n(jbt0K. i sVi si ble()) ; 

JFrame frame = new JFrameO; 

System. out . pri ntl n (frame . i sVi si ble()) ; 

} 

} 
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12.19 How do you create an Imagelcon from the file image/us.gif in the class directory? 

12.20 What happens if you add a button to a container several times, as shown below? 
Does it cause syntax errors? Does it cause runtime errors? 

JButton jbt = new JButtonO; 
JPanel panel = new JPanelO; 
panel .add (jbt) ; 
panel .add (jbt) ; 
panel .add (jbt) ; 

1 2.2 1 Will the following code display three buttons? Will the buttons display the same 
icon? 

1 import javax . swi ng . * ; 

2 import j ava . awt . * ; 

3 

4 public class Test extends J Frame { 

5 public static void man n(Stri ng [] args) { 

6 // Create a frame and set its properties 

7 JFrame frame = new Test(); 

8 frame . setTi tl e ("Buttonlcons") ; 

9 frame. setSize(200, 100); 

10 frame . setDef aul tCl oseOpe rati on (J Frame . EXIT_0N_CL0SE) ; 

11 frame . setVi si bl e(true) ; 

12 } 
13 

14 public Test() { 

15 Imagelcon uslcon = new ImageIcon("image/us.gif") ; 

16 JButton jbtl = new JButton(usIcon) ; 

17 JButton jbt2 = new JButton(usIcon) ; 
18 

19 J Panel pi = new JPanelO; 

20 pl.add(jbtl) ; 
21 

22 JPanel p2 = new JPanelO; 

23 p2.add(jbt2) ; 
24 

25 JPanel p3 = new JPanelO; 

26 p2. add (jbtl) ; 
27 

28 add(pl, BorderLayout . NORTH) ; 

29 add(p2, BorderLayout . SOUTH) ; 

30 add(p3, BorderLayout . CENTER) ; 

31 } 

32 } 

1 2.22 Can a border or an icon be shared by GUI components? 

Programming Exercises 



Sections 12.5-12.6 

12.1 (Using the FT owLayout manager) Write a program that meets the following 
requirements (see Figure 12.14): 

■ Create a frame and set its layout to Fl owLayout. 

■ Create two panels and add them to the frame. 

■ Each panel contains three buttons. The panel uses Fl owLayout. 



428 Chapter 12 GUI Basics 



I Exercisel2_l 



Jnjjcj 



Button!] 


Button 2 


Button 3 




Button 4 


Button 5 


Button 6 



Figure 12.14 Exercise 12.1 places the first three buttons in one panel and the other three 
buttons in another panel. 



12.2 (Using the BorderLayout manager) Rewrite the preceding program to create 
the same user interface, but instead of using Fl owLayout for the frame, use 
BorderLayout. Place one panel in the south of the frame and the other in the 
center. 

1 2.3 (Using the CridLayout manager) Rewrite the preceding program to create the 
same user interface. Instead of using Fl owLayout for the panels, use a 
CridLayout of two rows and three columns. 

12.4 (Using J Panel to group buttons) Rewrite the preceding program to create the 
same user interface. Instead of creating buttons and panels separately, define a 
class that extends the J Panel class. Place three buttons in your panel class, and 
create two panels from the user-defined panel class. 

12.5 (Displaying labels) Write a program that displays four lines of text in four 
labels, as shown in Figure 12.15(a). Add a line border on each label. 
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Figure 12.15 (a) Exercise 12.5 displays four labels, (b) Exercise 12.6 displays four icons, 
(c) Exercise 12.7 displays a TicTacToe board with image icons in labels. 



Sections 12.7-12.10 

12.6 (Displaying icons) Write a program that displays four icons in four labels, as 
shown in Figure 12.15(b). Add a line border on each label. (Use any images of 
your choice or those in the book, which can be obtained along with the book's 
source code.) 

12.7** (Game: displaying a TicTacToe board) Display a frame that contains nine 
labels. A label may display an image icon for X, an image icon for O, or noth- 
ing, as shown in Figure 12.15(c). What to display is randomly decided. Use the 
Math . random () method to generate an integer 0, 1, or 2, which corresponds to 
displaying a cross image icon, a not image icon, or nothing. The cross and not 
images are in the files x . gi f and o . gi f , which are under the image directory 
in www.cs.armstrong.edu/liang/intro8e/book.zip). 

12.8* (Swing common features) Display a frame that contains six labels. Set the back- 
ground of the labels to white. Set the foreground of the labels to black, blue, 
cyan, green, magenta, and orange, respectively, as shown in Figure 12.16(a). Set 
the border of each label to a line border with the yellow color. Set the font of 
each label to TimesRoman, bold, and 20 pixels. Set the text and tool tip text of 
each label to the name of its foreground color. 
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(a) (b) (c) 

Figure 12.16 (a) Six labels are placed in the frame, (b) Three cards are randomly selected, 
(c) A checkerboard is displayed using buttons. 



12.9* (Game: displaying three cards) Display a frame that contains three labels. Each 
label displays a card, as shown in Figure 12.16(b). The card image files are named 
l.png, 2.png, . . . , 54.png and stored in the image/card directory. All three cards 
are distinct and selected randomly. The image files can be obtained from 
www.cs.armstrong.edu/liang/intro8e/book.zip. 

12.10* (Game: displaying a checkerboard) Write a program that displays a checker- 
board in which each white and black cell is a JButton with a background black video Note 
or white, as shown in Figure 12.16(c). Display a checker board 
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Exception Handling 

Objectives 

■ To get an overview of exceptions and exception handling (§13.2). 

■ To explore the advantages of using exception handling (§13.3). 

■ To distinguish exception types: Error (fatal) vs. Exception (nonfatal) and checked vs. 
unchecked (§13.4). 

■ To declare exceptions in a method header (§13.5.1). 

■ To throw exceptions in a method (§13.5.2). 

■ To write a try-catch block to handle exceptions (§13.5.3). 

■ To explain how an exception is propagated (§13.5.3). 

■ To use the finally clause in a try-catch block (§13.6). 

■ To use exceptions only for unexpected errors (§13.7). 

■ To rethrow exceptions in a catch block (§13.8). 

■ To create chained exceptions (§13.9). 

■ To define custom exception classes (§13.10). 
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13.1 Introduction 

Runtime errors occur while a program is running if the environment detects an operation that 
is impossible to carry out. For example, if you access an array using an index out of bounds, 
your program will get a runtime error with an ArraylndexOutOf BoundsException. To 
read data from a file, you need to create a Scanner object using new Scanner (new 
Fil e(f il ename)) (see Listing 9.6). If the file does not exist, your program will get a run- 
time error with a Fil eNotFoundException. 

In Java, runtime errors are caused by exceptions. An exception is an object that represents 
an error or a condition that prevents execution from proceeding normally. If the exception is 
not handled, the program will terminate abnormally. How can you handle the exception so 
that the program can continue to run or else terminate gracefully? This is the subject we intro- 
duce in this chapter. 



Video Note 

Exception-handling 
advantages 



reads two integers 



integer division 



13.2 Exception-Handling Overview 

To demonstrate exception handling, including how an exception object is created and thrown, 
we begin with an example (Listing 13.1) that reads in two integers and displays their quotient. 

Listing 13.1 Quotient, java 



1 

2 

3 

4 

5 

6 

7 

8 

9 
10 
11 
12 
13 
14 

15 } 



import java. util .Scanner; 



public class Quotient { 

public static void main(String[] args) { 
Scanner input = new Scanner(System.in) ; 

// Prompt the user to enter two integers 
System . out . pri nt("Enter two integers: ") ; 
int numberl = i nput . nextlntO ; 
int number2 = i nput . nextlntQ ; 



System. out. pri ntl n(numberl + " / 
(numberl / number2)); 



number2 



is 




Enter two integers: 3 [ 
Exception in thread "main' 



java.lang.ArithmeticException: / by zero 
at Quoti ent . mai n (Quoti ent . j ava : 11) 



If you entered for the second number, a runtime error would occur, because you cannot 
divide an integer by 0. (Recall that a floating-point number divided by does not raise an 
exception.) A simple way to fix the error is to add an i f statement to test the second number, 
as shown in Listing 13.2. 

Listing 13.2 Quoti entWi thlf . java 

1 import java. util .Scanner; 
2 

3 public class Quoti entWi thlf { 



13.2 Exception-Handling Overview 433 



4 public static void main(String[] args) { 

5 Scanner input = new Scanner(System.in) ; 
6 

7 // Prompt the user to enter two integers 

8 System . out . pri nt("Enter two integers: ") ; 

9 int numberl = i nput . nextlntO ; reads two integers 
10 int number2 = i nput . nextlntO ; 

11 

12 if (number2 != 0) testnumber2 

13 System. out. pri ntl n(numberl + " / " + number2 

14 + " is " + (numberl / number2)); 

15 else 

16 System. out . pri ntl n("Divisor cannot be zero ") ; 

17 } 

18 } 



Enter two integers: 5 
Divisor cannot be zero 



In order to demonstrate the concept of exception handling, including how to create, throw, 
catch, and handle an exception, we rewrite Listing 13.2 as shown in Listing 13.3. 

Listing 13.3 QuotientWithException. java 

1 import java. util .Scanner; 

2 

3 public class QuotientWithException { 

4 public static void main(String[] args) { 

5 Scanner input = new Scanner(System.in) ; 
6 

7 // Prompt the user to enter two integers 

8 System . out . pri nt("Enter two integers: ") ; 

9 int numberl = i nput . nextlntO ; reads two integers 
10 int number2 = i nput . nextlntO ; 

11 

12 try { try block 

13 if (number2 == 0) 

14 I throw new ArithmeticException("Divisor cannot be zero"); 

15 
16 
17 
18 
19 
20 

21 "cannot be divided by zero ") ; 

22 } 
23 

24 System. out. pri ntl n("Execution continues 

25 } 

26 } 



System. out. pri ntl n(numberl + " / " + number2 + " is " + 
(numberl / number2)); 

} 

catch (ArithmeticException ex) { catch block 

-►System. out. println("Exception: an integer " + 



Enter two integers: 
5 / 3 is 1 
Execution continues 



5 3 
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The program contains a try block and a catch block. The try block (lines 12-18) contains 
the code that is executed in normal circumstances. The catch block (lines 19-22) contains 
the code that is executed when number2 is 0. In this event the program throws an exception 
by executing 

throw statement throw new Ari thmeti cExcepti on ("Divisor cannot be zero"); 

The value thrown, in this case new ArithmeticException("Divisor cannot be 
exception zero"), is called an exception. The execution of a throw statement is called throwing an 

throwing exception exception. The exception is an object created from an exception class. In this case, the excep- 

tion class is java.lang.ArithmeticException. 

When an exception is thrown, the normal execution flow is interrupted. As the name sug- 
gests, to "throw an exception" is to pass the exception from one place to another. The excep- 
handle exception tion is caught by the catch block. The code in the catch block is executed to handle the 

exception. Afterward, the statement (line 24) after the catch block is executed. 

The throw statement is analogous to a method call, but instead of calling a method, it calls 
a catch block. In this sense, a catch block is like a method definition with a parameter that 
matches the type of the value being thrown. Unlike a method, after the catch block is exe- 
cuted, however, the program control does not return to the throw statement; instead, it exe- 
cutes the next statement after the catch block. 
The identifier ex in the catch-block header 



catch (Ari thmeti cExcepti on ex) 

acts very much like a parameter in a method. So this parameter is referred to as a 
catch-block parameter catch-block parameter. The type (e.g., ArithmeticException) preceding ex specifies 

what kind of exception the catch block can catch. Once the exception is caught, you can 
access the thrown value from this parameter in the body of a catch block. 
In summary, a template for a try-throw-catch block may look like this: 

try { 

Code to try; 

Throw an exception with a throw statement or 

from method if necessary; 
More code to try; 

} 

catch (type ex) { 

Code to process the exception; 

} 



An exception may be thrown directly by using a throw statement in a try block, or by invok- 
ing a method that may throw an exception. 



13.3 Exception-Handling Advantages 

You have seen from Listing 13.3 how an exception is created, thrown, caught, and handled. 
You may wonder what the benefits are. To see these benefits, we rewrite Listing 13.3 to com- 
pute a quotient using a method, as shown in Listing 13.4. 
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Listing 13.4 QuotientWithMethod. java 



1 import java. util .Scanner; 

2 

3 public class QuotientWithMethod { 

4 public static int quotient(int numberl, int number2) { 
if (number2 == 0) 

throw new ArithmeticException("Divisor cannot be zero") I 



return numberl / number2; 



5 
6 
7 
8 

9 } 
10 

11 public static void main(String[] args) { 

12 Scanner input = new Scanner(System.in) ; 
13 

14 
15 
16 
17 
18 
19 
20 
21 
22 
23 
24 
25 
26 



// Prompt the user to enter two integers 
System . out . pri nt("Enter two integers: ") ; 
int numberl = i nput . nextlntO ; 
int number2 = i nput . nextlntO ; 

try { 

— int result = quotient(numberl, number2) ; 



Arithmetic System. out . pri ntl n (numberl + " / " + number2 + " is " 

Exception + reslJ -| t ) ; 

occurs ■* 1 

} 

catch (ArithmeticException ex) { 

>-System.out.println("Exception: an integer " + 

"cannot be divided by zero "); 

} 



27 
28 

29 System. out. pri ntl n ("Execution continues 

30 } 

31 } 



quotient method 
throw exception 



reads two integers 



try block 
invoke method 



catch block 



Enter two integers: 5 3 
5 / 3 is 1 

Execution continues ... 



Enter two 


integers: 5 


-J Enter 


Excepti on 


an integer 


cannot be divided by zero 


Executi on 


continues . 





Method quotient (lines 4-9) returns the quotient of two integers. If number 2 is 0, it cannot 
return a value. So, an exception is thrown in line 6. 

The main method invokes quotient (line 20). If the quotient method executes normally, 
it returns a value to the caller. If the quotient method encounters an exception, it throws the 
exception back to its caller. The caller's catch block handles the exception. 

Now you see the advantages of using exception handling. It enables a method to throw an advantage 
exception to its caller. The caller can handle this exception. Without this capability, the called 
method itself must handle the exception or terminate the program. Often the called method 
does not know what to do in case of error. This is typically the case for the library methods. 
The library method can detect the error, but only the caller knows what needs to be done when 
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an error occurs. The essential benefit of exception handling is to separate the detection of an 
error (done in a called method) from the handling of an error (done in the calling method). 

Many library methods throw exceptions. Listing 13.5 gives an example that handles 
FileNotFoundException for invoking the Scanner(File file) constructor. 



try block 
create a Scanner 



catch block 



Listing 13.5 FileNotFoundExceptionDemo. java 



1 

2 

3 

4 

5 

6 

7 

8 

9 
10 
11 
12 
13 
14 
15 
16 
17 
18 
19 
20 } 



import java. util .Scanner; 
import java.io.*; 

public class FileNotFoundExceptionDemo { 
public static void main(String[] args) { 

Scanner i nputFromConsol e = new Scanner(System . i n) ; 

// Prompt the user to enter a file name 
System . out . pri nt("Enter a file name: ") ; 
String filename = i nputFromConsol e . nextLi ne() ; 



try { 

— Scanner i nputFromFi 1 e 



System. out . pri ntl n("File " + filename + " exists ") ; 



If a 

FileNot 

Found // Processing file ... 

Exception ' ' 
occurs } 

catch (FileNotFoundException ex) { 
>- System. out . pri ntl n("Exception : " + 



new Scanner(new File(filename)) ; 



filename + " not found"); 



} 



} 




Enter a file name: c:\book\Welcome.java |^ 
File c:\book\Welcome.java exists 




Enter a file name: c:\book\Testl0.java Renter 
Exception: c:\book\Testl0.java not found 



try block 
create a Scanner 



The program creates a Scanner for a file (line 12). If the file does not exist, the constructor 
throws a Fil eNotFoundException, which is caught in the catch block. 

Listing 13.6 gives an example that handles an InputMi smatchException exception. 

Listing 13.6 InputMi smatchExceptionDemo. java 



3 
4 
5 
6 
7 
8 
9 
10 
11 
12 
13 
14 



1 import java.util.*; 
2 

public class InputMi smatchExcepti onDemo { 
public static void main(String[] args) { 
Scanner input = new Scanner(System.in) ; 
boolean conti nuelnput = true; 



If an InputMi 
smatchExcep- 
ti on occurs 



do { 
try { 

System . out . pri nt("Enter an integer: 
int number = i nput . nextlntQ ; 



// Display the result 
System . out . pri ntl n ( 



); 
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} 



'The number entered is " + number); 
conti nuelnput = false; 



15 
16 
17 
18 

19 catch (InputMi smatchExcepti on ex) { 

20' »- System . out . pri ntl n ("Try again. (" + 

21 "Incorrect input: an integer is required)"); 

22 i nput . nextLi ne() ; // Discard input 

23 } 

24 } while (conti nuelnput) ; 

25 } 

26 } 



Enter an integer: 3.5 
Try again. (Incorrect input: an integer is required) 
Enter an integer: 4 
The number entered is 4 



When executing input.nextlntO (line 11), an InputMi smatchException occurs if the 
input entered is not an integer. Suppose 3 . 5 is entered. An InputMi smatchExcepti on occurs 
and the control is transferred to the catch block. The statements in the catch block are now 
executed. The statement i nput . nextLi ne() in line 22 discards the current input line so that 
the user can enter a new line of input. The variable conti nuelnput controls the loop. Its initial 
value is true (line 6), and it is changed to fal se (line 17) when a valid input is received. 



3.4 Exception Types 



The preceding sections used ArithmeticException, FileNotFoundException, and 
InputMi smatchException. Are there any other types of exceptions you can use? Yes. There 
are many predefined exception classes in the Java API. Figure 13.1 shows some of them. 



catch block 



Object | < — Th rowabl e | < — 



Exception [ <] — 



ClassNotFoundException | 
IOException | 
RuntimeException | <j 

Many more classes 



Error 



ArithmeticExce 



ption | 



Nul 1 Poi nterExce 



ption | 



IndexOutOf BoundsException 



111 egal Argument Excepti on 



Many more classes 



Li nkageError | 
Vi rtualMachi neError | 

Many more classes 

Figure 13.1 Exceptions thrown are instances of the classes shown in this diagram, or of subclasses of one of these 
classes. 



Note 

The class names Error, Exception, and RuntimeException are somewhat confusing. All 
three of these classes are exceptions, and all of the errors discussed here occur at runtime. 
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The Throwable class is the root of exception classes. All Java exception classes inherit 
directly or indirectly from Throwabl e. You can create your own exception classes by extend- 
ing Exception or a subclass of Exception. 

The exception classes can be classified into three major types: system errors, exceptions, 
and runtime exceptions. 

system error ■ System errors are thrown by the JVM and represented in the Error class. The 

Error class describes internal system errors. Such errors rarely occur. If one does, 
there is little you can do beyond notifying the user and trying to terminate the pro- 
gram gracefully. Examples of subclasses of Error are listed in Table 13.1. 

Table 13.1 Examples of Subclasses of Error 

Class Possible Reason for Exception 

LinkageError A class has some dependency on another class, but the latter class has 

changed incompatibly after the compilation of the former class. 

Vi rtual Machi neError The JVM is broken or has run out of the resources it needs in order to 

continue operating. 

exception ■ Exceptions are represented in the Exception class, which describes errors caused 

by your program and by external circumstances. These errors can be caught and 
handled by your program. Examples of subclasses of Exception are listed in 
Table 13.2. 



Table 13.2 Examples of Subclasses of Exception 

Class Possible Reason for Exception 

ClassNotFoundException Attempt to use a class that does not exist. This exception would occur, 

for example, if you tried to run a nonexistent class using the java 
command, or if your program were composed of, say, three class 
files, only two of which could be found. 

IOException Related to input/output operations, such as invalid input, reading past 

the end of a file, and opening a nonexistent file. Examples of sub- 
classes of IOException are InterruptedlOException, 
EOFException (EOF is short for End Of File), and Fil eNot- 
FoundException. 



runtime exception ■ Runtime exceptions are represented in the RuntimeException class, which 

describes programming errors, such as bad casting, accessing an out-of-bounds 
array, and numeric errors. Runtime exceptions are generally thrown by the JVM. 
Examples of subclasses are listed in Table 13.3. 



Table 1 3.3 Examples of Subclasses of RuntimeException 



Class 



Possible Reason for Exception 



ArithmeticException 



NuHPointerException 
IndexOutOfBoundsException 
I1 1 egal Argument Except i on 



Dividing an integer by zero. Note that floating-point arithmetic 
does not throw exceptions. See Appendix E, "Special 
Floating-Point Values." 

Attempt to access an object through a nul 1 reference variable. 

Index to an array is out of range. 

A method is passed an argument that is illegal or inappropriate. 
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Runt i meExcept i on, Error, and their subclasses are known as unchecked exceptions. All unchecked exception 
other exceptions are known as checked exceptions, meaning that the compiler forces the pro- checked exception 
grammer to check and deal with them. 

In most cases, unchecked exceptions reflect programming logic errors that are unrecover- 
able. For example, a NullPointerException is thrown if you access an object through a 
reference variable before an object is assigned to it; an IndexOutOf BoundsException is 
thrown if you access an element in an array outside the bounds of the array. These are logic 
errors that should be corrected in the program. Unchecked exceptions can occur anywhere in 
a program. To avoid cumbersome overuse of try-catch blocks, Java does not mandate that 
you write code to catch or declare unchecked exceptions. 

Caution 

At present, Java does not throw integer overflow or underflow exceptions. The following state- integer overflow/underflow 

ment adds 1 to the maximum integer. 

int number = Integer . MAX_VALUE + 1; 
System. out. pri nt~l n (number) ; 

It displays -2147483648, which is logically incorrect. The cause of this problem is overflow; 
that is, the result exceeds the maximum for an int value. 

A future version of Java may fix this problem by throwing an overflow exception. 




13.5 More on Exception Handling 

The preceding sections gave you an overview of exception handling and introduced several pre- 
defined exception types. This section provides an in-depth discussion of exception handling. 

Java's exception-handling model is based on three operations: declaring an exception, 
throwing an exception, and catching an exception, as shown in Figure 13.2. 



Catch exception 



methodl() { 

I try { 

invoke method2 ; 

| catch (Exception ex) { 
Process exception; 




I'- 



ll 



method2() ithrows Exception! { 

i i 

if (an error occurs) { 



}"- 



throw new ExceptionQ ; i-<- 



Declare exception 



Throw exception 



Figure 13.2 Exception handling in Java consists of declaring exceptions, throwing exceptions, and catching and 
processing exceptions. 



13.5.1 Declaring Exceptions 

In Java, the statement currently being executed belongs to a method. The Java interpreter 

invokes the main method to start executing a program. Every method must state the types of 

checked exceptions it might throw. This is known as declaring exceptions. Because system declare exception 

errors and runtime errors can happen to any code, Java does not require that you declare 

Error and RuntimeException (unchecked exceptions) explicitly in the method. However, 

all other exceptions thrown by the method must be explicitly declared in the method header so 

that the caller of the method is informed of the exception. 
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To declare an exception in a method, use the throws keyword in the method header, as in 
this example: 

public void myMethodO throws IOException 

The throws keyword indicates that myMethod might throw an IOException. If the method 
might throw multiple exceptions, add a list of the exceptions, separated by commas, after 
throws: 

public void myMethodO 

throws Exceptionl, Exception2, ExceptionN 

# Note 

[f a method does not declare exceptions in the superclass, you cannot override it to declare excep- 
tions in the subclass. 



throw exception 



13.5.2 Throwing Exceptions 

A program that detects an error can create an instance of an appropriate exception type and 
throw it. This is known as throwing an exception. Here is an example: Suppose the program 
detects that an argument passed to the method violates the method contract (e.g., the argument 
must be nonnegative, but a negative argument is passed); the program can create an instance 
of II 1 egal ArgumentException and throw it, as follows: 

IllegalArgumentException ex = 

new IllegalArgumentExceptionCWrong Argument"); 
throw ex; 

Or, if you prefer, you can use the following: 

throw new IllegalArgumentExceptionC'Wrong Argument"); 



exception message 



Note 

IllegalArgumentException is an exception class in the Java API. In general, each excep- 
tion class in the Java API has at least two constructors: a no-arg constructor, and a constructor 
with a String argument that describes the exception. This argument is called the exception 
message, which can be obtained using getMessageQ. 



throws and throw 



Tip 

The keyword to declare an exception is throws, and the keyword to throw an exception is 
throw. 



catch exception 



13.5.3 Catching Exceptions 

You now know how to declare an exception and how to throw an exception. When an excep- 
tion is thrown, it can be caught and handled in a try-catch block, as follows: 

try { 

statements; // Statements that may throw exceptions 

} 

catch (Exceptionl exVarl) { 
handler for exceptionl; 

} 

catch (Exception2 exVar2) { 
handler for exception2; 

} 
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catch (ExceptionN exVar3) { 
handler for exceptionN; 

} 

If no exceptions arise during the execution of the try block, the catch blocks are skipped. 

If one of the statements inside the try block throws an exception, Java skips the remaining 
statements in the try block and starts the process of finding the code to handle the exception. 
The code that handles the exception is called the exception handler, it is found by propagating exception handler 
the exception backward through a chain of method calls, starting from the current method. 
Each catch block is examined in turn, from first to last, to see whether the type of the excep- 
tion object is an instance of the exception class in the catch block. If so, the exception object 
is assigned to the variable declared, and the code in the catch block is executed. If no handler 
is found, Java exits this method, passes the exception to the method that invoked the method, 
and continues the same process to find a handler. If no handler is found in the chain of meth- 
ods being invoked, the program terminates and prints an error message on the console. The 
process of finding a handler is called catching an exception. 

Suppose the main method invokes methodl, methodl invokes method2, method2 
invokes method3, and method3 throws an exception, as shown in Figure 13.3. Consider the 
following scenario: 

■ If the exception type is Exception3, it is caught by the catch block for handling 
exception ex3 in method2. statements is skipped, and statement6 is executed. 

■ If the exception type is Exception2, method2 is aborted, the control is returned to 
methodl, and the exception is caught by the catch block for handling exception 
ex2 in methodl. statement3 is skipped, and statement4 is executed. 

■ If the exception type is Exceptionl, methodl is aborted, the control is returned to 
the mai n method, and the exception is caught by the catch block for handling excep- 
tion exl in the mai n method, statementl is skipped, and statement2 is executed. 

■ If the exception type is not caught in method2, methodl, and main, the program 
terminates, statementl and statement2 are not executed. 



main method { 

try { 

invoke methodl; 
statementl; 

} 

catch (Exceptionl exl) { 
Process exl; 

} 

statement2 ; 




invoke method2; 
statement3 ; 

} 

catch (Exception2 ex2) { 
Process ex2 ; 

} 

statement4 ; 




invoke method3; 
statements ; 

} 

catch (Exception3 ex3) { 
Process ex3; 

} 

statement6 ; 



An exception 
is thrown in 
method3 



Call Stack 



man n method 



methodl 

mai n method 



method2 
methodl 
mai n method 



method3 
method2 
methodl 
mai n method 



Figure 13.3 If an exception is not caught in the current method, it is passed to its caller. The process is repeated until 
the exception is caught or passed to the mai n method. 
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catch block 



Note 

Various exception classes can be derived from a common superclass. If a catch block catches excep- 
tion objects of a superclass, it can catch all the exception objects of the subclasses of that superclass. 



order of exception handlers 



Note 

The order in which exceptions are specified in catch blocks is important. A compile error will 
result if a catch block for a superclass type appears before a catch block for a subclass type. For 
example, the ordering in (a) below is erroneous, because RuntimeException is a subclass of 
Exception. The correct ordering should be as shown in (b). 



try { 






try { 




} 






} 




catch 


(Exception ex) { 




catch 


(RuntimeException ex) { 


} 






} 




catch 


(RuntimeException ex) { 




catch 


(Exception ex) { 


} 






} 






(a) Wrong order 




(b) Correct order 



catch or declare checked 
exceptions 



Note 

Java forces you to deal with checked exceptions. If a method declares a checked exception (i.e., an 
exception other than Error or RuntimeException), you must invoke it in a try-catch 
block or declare to throw the exception in the calling method. For example, suppose that method 
pi invokes method p2, and p2 may throw a checked exception (e.g., IOException); you have 
to write the code as shown in (a) or (b) below. 



void pl() { 
try { 

p2(); 

} 

catch (IOException ex) { 



(a) Catch exception 



void pl() throws IOException { 

p2(); 

} 



(b) Throw exception 



13.5.4 Getting Information from Exceptions 

An exception object contains valuable information about the exception. You may use the fol- 
methods in Throwable lowing instance methods in the java . 1 ang .Throwabl e class to get information regarding 

the exception, as shown in Figure 13.4. The printStackTraceQ method prints stack trace 



j a v a. lang.Thro wabl c 



+getMessage() : String 
+toString(): String 

+pri ntStackTrace() : void 



+getStackTrace() : 
StackTraceEl ement [] 



Returns the message of this object. 

Returns the concatenation of three strings: (1) the full name of the exception 
class; (2) " : " (a colon and a space); (3) the getMessage() method. 

Prints the Th rowabl e object and its call stack trace information on the 
console. 

Returns an array of stack trace elements representing the stack trace 
pertaining to this throwable. 



Figure 1 3.4 Throwabl e is the root class for all exception objects. 



13.5 More on Exception Handling 443 



information on the console. The getStackTraceO method provides programmatic access 
to the stack trace information printed by printStackTraceC). 

Listing 13.7 gives an example that uses the methods in Throwable to display exception 
information. Line 4 invokes the sum method to return the sum of all the elements in the array. 
There is an error in line 23 that causes the ArraylndexOutOf BoundsException, a sub- 
class of IndexOutOfBoundsException. This exception is caught in the try-catch block. 
Lines 7, 8, 9 display the stack trace, exception message, and exception object and message 
using the printStackTraceC), getMessageO, and toStringO methods, as shown in 
Figure 13.5. Line 10 brings stack trace elements into an array. Each element represents a 
method call. You can obtain the method (line 12), class name (line 13), and exception line 
number (line 14) for each element. 



Command Prompt 



Jnj*. 



C:\book>jaua TestException 



jaua . lang .ArraylndexOutOf BoundsException: 5 ~ 
ot TestException. sum (Test Except ion . jouo : 2f) 
at TestException. ma in( Test Except ion . jaua: t) 



"3 



jaua . lang .HrraylndexOutOfBoundsException: 5 



Trace Info Obtained from getStackTrace 

method sum( TestException : 24) 

method main(TestException :t) 



C:\book>. 
J 



J 



pri ntStackTraceQ 



getMessageO 
toStri ng() 

Using 

getStackTraceO 



Figure 13.5 You can use the printStackTraceC), getMessageO, toStringO, and 
getStackTraceO methods to obtain information from exception objects. 

Listing 13.7 TestException. java 

public class TestException { 

public static void main(String[] args) { 
try { 

System. out. pri nt~| n(sum(new int[] {1, 2, 3, 4, 5})); 

} 

catch (Exception ex) { 
ex . pri ntStackTrace() ; 

System. out . pri ntl n("\n" + ex. getMessageO) ; 
System. out . pri ntl n("\n" + ex. toStringO) ; 

System.out.println("\nTrace Info Obtained from getStackTrace"); 
StackTraceEl ement[] traceEl ements = ex. getStackTrace O ; 
for (int i = 0; i < traceEl ements . 1 ength ; i++) { 

System. out. pri nt("method " + traceEl ements [i ] .getMethodNameO) ; 
System. out. print("(" + traceEl ements [i ]. getCl assNameO + ":"); 
System. out. println(traceElements[i] .getLineNumberO + ")"); 



1 
2 
3 
4 
5 
6 
7 
8 
9 
10 
11 
12 
13 
14 
15 
16 
17 
18 
19 
20 
21 
22 
23 
24 
25 
26 
27 



} 



} 



private static int sum(int[] list) { 
int result = 0; 

for (int i = 0; i <= list. length ; i++) 

result += list[i] ; 
return result; 

} 



invoke sum 



printStackTraceC) 

getMessageO 

toStringO 
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declare exception 



throw exception 



13.5.5 Example: Declaring, Throwing, and Catching Exceptions 

This example demonstrates declaring, throwing, and catching exceptions by modifying the 
setRadius method in the Circle class in Listing 8.9, Circle3.java. The new setRadius 
method throws an exception if the radius is negative. 

Rename the circle class given in Listing 13.8 as Ci rcl eWithException, which is the 
same as Circle3 except that the setRadi us (doubl e newRadius) method throws an 
IllegalArgumentException if the argument newRadius is negative. 

Listing 13.8 Ci rcl eWithException. java 



1 

2 
3 
4 
5 
6 
7 
8 
9 
10 
11 
12 
13 
14 
15 
16 
17 
18 
19 
20 
21 
22 
23 
24 
25 
26 
27 
28 
29 
30 
31 
32 
33 
34 
35 
36 
37 
38 
39 
40 
41 
42 
43 



public class Ci rcl eWi thExcepti on { 

/** The radius of the circle */ 
private double radius; 

/** The number of the objects created */ 
private static int numberOfObjects = 0; 

/** Construct a circle with radius 1 */ 
public Ci rcl eWithException () { 
this(l.O); 

} 

/** Construct a circle with a specified radius */ 
public Ci rcl eWithException (double newRadius) { 

setRadi us(newRadi us) ; 

numbe rOfOb j ects++ ; 

} 

/** Return radius */ 
public double getRadius() { 
return radius; 

} 

/** Set a new radius */ 
public void setRadi us (double newRadius) 
throws IllegalArgumentException { 
if (newRadius >= 0) 

radius = newRadius; 
el se 

throw new IllegalArgumentException( 
"Radius cannot be negative"); 

} 

/** Return numberOfObjects */ 
public static int getNumber0f0bjects() { 
return numberOfObjects; 

} 

/** Return the area of this circle */ 
public double findArea() { 

return radius * radius * 3.14159; 

} 

} 



A test program that uses the new Ci rcl e class is given in Listing 13.9. 

Listing 13.9 TestCi rcl eWithException. java 

1 public class TestCi rcl eWithException { 

2 public static void main(String[] args) { 
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3 

4 

5 

6 

7 

8 

9 
10 
11 
12 
13 
14 

15 } 



try { 

Ci rcl eWi thExcepti on cl = new Ci rcl eWi thExcepti on(5) ; 

Ci rcl eWi thExcepti on c2 = new Ci rcl eWi thExcepti on(-5) ; 

Ci rcl eWi thExcepti on c3 = new Ci rcl eWi thExcepti on(0) ; 



try 



} 



catch (IllegalArgumentException ex) { 
System. out . pri ntl n(ex) ; 

} 



catch 



System. out. pri ntl n ("Number of objects created: 
Ci rcleWi thExcepti on. getNumberOfObjectsQ) ; 



+ 



} 



java.lang. IllegalArgumentException: Radius cannot be negative 
Number of objects created: 1 



The original Ci rcl e class remains intact except that the class name is changed to 
CircleWithException, a new constructor CircleWithExceptionCnewRadius) is 

added, and the setRadius method now declares an exception and throws it if the radius is 
negative. 

The setRadius method declares to throw IllegalArgumentException in the method 
header (lines 25-32 in Ci rcl eWi thExcepti on. java). The CircleWithException class 
would still compile if the throws IllegalArgumentException clause were removed 
from the method declaration, since it is a subclass of RuntimeException and every method 
can throw RuntimeException (unchecked exception) regardless of whether it is declared in 
the method header. 

The test program creates three CircleWithException objects, cl, c2, and c3, to test 
how to handle exceptions. Invoking new CircleWithException(-5) (line 5 in Listing 
13.9) causes the setRadius method to be invoked, which throws an IllegalArgu- 
mentException, because the radius is negative. In the catch block, the type of the object 
ex is IllegalArgumentException, which matches the exception object thrown by the 
setRadius method. So, this exception is caught by the catch block. 

The exception handler prints a short message, ex. toStringO (line 9), about the excep- 
tion, using System. out. pri ntl n (ex). 

Note that the execution continues in the event of the exception. If the handlers had not 
caught the exception, the program would have abruptly terminated. 

The test program would still compile if the try statement were not used, because the 
method throws an instance of IllegalArgumentException, a subclass of 
RuntimeException (unchecked exception). If a method throws an exception other than 
RuntimeException and Error, the method must be invoked within a try-catch 
block. 



Occasionally, you may want some code to be executed regardless of whether an exception 
occurs or is caught. Java has a f i nal 1 y clause that can be used to accomplish this objective. 
The syntax for the f i nal 1 y clause might look like this: 

try { 

statements ; 

} 

catch (TheExcepti on ex) { 
handling ex; 

} 
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finally { 

fi nal Statements ; 

} 

The code in the f i nal 1 y block is executed under all circumstances, regardless of whether an 
exception occurs in the try block or is caught. Consider three possible cases: 

■ If no exception arises in the try block, final Statements is executed, and the 
next statement after the try statement is executed. 

■ If a statement causes an exception in the try block that is caught in a catch block, 
the rest of statements in the try block are skipped, the catch block is executed, 
and the f i nal 1 y clause is executed. The next statement after the try statement is 
executed. 

■ If one of the statements causes an exception that is not caught in any catch block, 
the other statements in the try block are skipped, the finally clause is executed, 
and the exception is passed to the caller of this method. 

The finally block executes even if there is a return statement prior to reaching the 
finally block. 

IP Note 

omitting catch block The catch block may be omitted when the f i nal 1 y clause is used. 

A common use of the f i nal 1 y clause is in I/O programming. To ensure that a file is closed 
under all circumstances, you may place a file closing statement in the f i nal 1 y block, as 
shown in Listing 13.10. 

Listing 13.10 Fi nal lyDemo. java 

1 public class FinallyDemo { 

2 public static void main(String[] args) { 

3 java. i o . Pri ntWri ter output = null; 
4 

5 try { 

6 // Create a file 

7 output = new java.io.PrintWriterCtext.txt"); 

8 

9 // Write formatted output to the file 

10 output. pri ntln ("Wei come to Java"); 

11 } 

12 catch (java.io.IOException ex) { 

13 ex . pri ntStackTrace() ; 

14 } 

15 finally { 

16 // Close the file 

17 if (output != null) output . close() ; 

18 } 
19 

20 System. out. pri ntl n("End of program"); 

21 } 

22 } 



catch 



finally 



The statements in lines 7 and 10 may throw an IOException, so they are placed inside a try 
block. The statement output. close() closes the PrintWriter object output in the 
f i nal 1 y block. This statement is executed regardless of whether an exception occurs in the 
try block or is caught. 
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13.7 When to Use Exceptions 

The try block contains the code that is executed in normal circumstances. The catch block 
contains the code that is executed in exceptional circumstances. Exception handling separates 
error-handling code from normal programming tasks, thus making programs easier to read 
and to modify. Be aware, however, that exception handling usually requires more time and 
resources, because it requires instantiating a new exception object, rolling back the call stack, 
and propagating the exception through the chain of methods invoked to search for the handler. 

An exception occurs in a method. If you want the exception to be processed by its caller, 
you should create an exception object and throw it. If you can handle the exception in the 
method where it occurs, there is no need to throw or use exceptions. 

In general, common exceptions that may occur in multiple classes in a project are candi- 
dates for exception classes. Simple errors that may occur in individual methods are best han- 
dled locally without throwing exceptions. 

When should you use a try-catch block in the code? Use it when you have to deal with 
unexpected error conditions. Do not use a try-catch block to deal with simple, expected situa- 
tions. For example, the following code 

try { 

System . out . pri ntl n ( ref Var . toSt ri ng () ) ; 

} 

catch (Nul 1 Poi nterException ex) { 

System. out. pri ntl n("refVar is null"); 

} 

is better replaced by 

if (refVar != null) 

System . out . pri ntl n ( ref Var . toSt ri ng () ) ; 
el se 

System. out. pri ntl n("refVar is null"); 

Which situations are exceptional and which are expected is sometimes difficult to decide. The 
point is not to abuse exception handling as a way to deal with a simple logic test. 

13.8 Rethrowing Exceptions 

Java allows an exception handler to rethrow the exception if the handler cannot process the 
exception or simply wants to let its caller be notified of the exception. The syntax may look 
like this: 

try { 

statements ; 

} 

catch (TheExcepti on ex) { 

perform operations before exits; 
throw ex; 

} 

The statement throw ex rethrows the exception to the caller so that other handlers in the 
caller get a chance to process the exception ex. 

13.9 Chained Exceptions 

In the preceding section, the catch block rethrows the original exception. Sometimes, you may 
need to throw a new exception (with additional information) along with the original exception. 
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stack trace 



chained exception 



throw exception 



This is called chained exceptions. Listing 13.11 illustrates how to create and throw chained 
exceptions. 

Listing 13. 1 1 ChainedExceptionDemo. java 

1 public class ChainedExceptionDemo { 

2 public static void main(String[] args) { 
try { 

methodl() ; 

} 

catch (Exception ex) { 
ex.printStackTrace() ; 

} 



3 

4 

5 

6 

7 

8 

9 
10 
11 
12 
13 
14 
15 
16 
17 
18 
19 
20 
21 
22 

23 } 



} 

public static void methodl() throws Exception { 
try { 

method2() ; 

} 

catch (Exception ex) { 

throw new Exception("New info from methodl", ex); 

} 

} 

public static void method2() throws Exception { 
throw new Exception ("New info from method2"); 

} 



java. lang. Exception: New info from methodl 

at Chai nedExcepti onDemo . methodl (Chai nedExcepti onDemo . java: 16) 
at Chai nedExcepti onDemo . mai n (Chai nedExcepti onDemo . java : 4) 

Caused by: java. 1 ang . Exception : New info from method2 

at Chai nedExcepti onDemo . method2 (Chai nedExcepti onDemo . java : 21) 
at Chai nedExcepti onDemo . methodl (Chai nedExcepti onDemo . java: 13) 
... 1 more 



Video Note 

Create custom exception 
classes 



The main method invokes methodl (line 4), methodl invokes method2 (line 13), and 
method2 throws an exception (line 21). This exception is caught in the catch block in 
methodl and is wrapped in a new exception in line 16. The new exception is thrown and 
caught in the catch block in the mai n method in line 4. The sample output shows the output 
from the printStackTraceO method in line 7. The new exception thrown from methodl 
is displayed first, followed by the original exception thrown from method2. 



3.10 Creating Custom Exception Classes 



Java provides quite a few exception classes. Use them whenever possible instead of creating 
your own exception classes. However, if you run into a problem that cannot be adequately 
described by the predefined exception classes, you can create your own exception class, 
derived from Exception or from a subclass of Exception, such as IOException. 

In Listing 13.8, CircleWithException.java, the setRadius method throws an exception if 
the radius is negative. Suppose you wish to pass the radius to the handler. In that case, you 
may create a custom exception class, as shown in Listing 13.12. 



13.10 Creating Custom Exception Classes 449 



Listing 13.12 InvalidRadiusException. java 

1 public class InvalidRadiusException extends Exception { extends Exception 

2 private double radius; 
3 

4 /** Construct an exception */ 

5 public InvalidRadiusException(double radius) { 

6 super("Inval id radius " + radius); 

7 this. radius = radius; 

8 } 
9 

10 /** Return the radius */ 

11 public double getRadius() { 

12 return radius; 

13 } 

14 } 

This custom exception class extends java. lang. Exception (line 1). The Exception 
class extends java.lang.Throwable. All the methods (e.g., getMessageO, 
toStringC), and printStackTraceO) in Exception are inherited from Throwable. 
The Exception class contains four constructors. Among them, the following two construc- 
tors are often used: 



javaJang.Exception 



+Exception() 

+Exception(message: String) 



Constructs an exception with no message. 
Constructs an exception with the specified message. 



Line 6 invokes the superclass's constructor with a message. This message will be set in the 
exception object and can be obtained by invoking getMessageO on the object. 

# Tip 

Most exception classes in the Java API contain two constructors: a no-arg constructor and a con- 
structor with a message parameter. 

To create an InvalidRadiusException, you have to pass a radius. So, the setRadius 
method in Listing 13.8 can be modified as follows: 

/** Set a new radius */ 
public void setRadius (double newRadius) 
throws InvalidRadiusException { 
if (newRadius >= 0) 

radius = newRadius; 
el se 

throw new InvalidRadiusException (newRadius) ; 

} 

The following code creates a circle object and sets its radius to -5. 
try { 

Ci rcleWithExceptionl c = new Ci rcl eWi thExcepti onl(4) ; 
c . setRadi us(-5) ; 

} 

catch (InvalidRadiusException ex ) { 

System. out. pri ntl n("The invalid radius is " + ex.getRadiusO) ; 

} 



450 Chapter 13 Exception Handling 



Invoking setRadius(-5) throws an Inval idRadiusException, which is caught by the 
handler. The handler displays the radius in the exception object ex. 

HI Tip 

checked custom exception Can you define a custom exception class by extending RuntimeException? Yes, but it is not a 

good way to go, because it makes your custom exception unchecked. It is better to make a custom 
exception checked, so that the complier can force these exceptions to be caught in your program. 
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Chapter Summary 



1 . Exception handling enables a method to throw an exception to its caller. 

2. A Java exception is an instance of a class derived from java . 1 ang .Throwabl e. Java 
provides a number of predefined exception classes, such as Error, Exception, 
RuntimeException, ClassNotFoundException, Null PointerException, 
and ArithmeticException. You can also define your own exception class by 
extending Exception. 

3. Exceptions occur during the execution of a method. RuntimeException and Error 

are unchecked exceptions; all other exceptions are checked. 

4. When declaring a method, you have to declare a checked exception if the method 
might throw it, thus telling the compiler what can go wrong. 

5. The keyword for declaring an exception is throws, and the keyword for throwing an 
exception is throw. 

6. To invoke the method that declares checked exceptions, you must enclose the method 
call in a try statement. When an exception occurs during the execution of the method, 
the catch block catches and handles the exception. 

7. If an exception is not caught in the current method, it is passed to its caller. The 
process is repeated until the exception is caught or passed to the mai n method. 

8. Various exception classes can be derived from a common superclass. If a catch block 
catches the exception objects of a superclass, it can also catch all the exception objects 
of the subclasses of that superclass. 

9. The order in which exceptions are specified in a catch block is important. A compile 
error will result if you do not specify an exception object of a class before an excep- 
tion object of the superclass of that class. 

1 0. When an exception occurs in a method, the method exits immediately if it does not 
catch the exception. If the method is required to perform some task before exiting, you 
can catch the exception in the method and then rethrow it to the real handler. 

I I. The code in the finally block is executed under all circumstances, regardless of 
whether an exception occurs in the try block or is caught. 
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12. Exception handling separates error-handling code from normal programming tasks, 
thus making programs easier to read and to modify. 

I 3. Exception handling should not be used to replace simple tests. You should test simple 
exceptions whenever possible, and reserve exception handling for dealing with situa- 
tions that cannot be handled with i f statements. 

Review Questions 

Sections 13.1-13.3 

I 3.1 Describe the Java Throwable class, its subclasses, and the types of exceptions. 
What RuntimeException will the following programs throw, if any? 



public class Test { 

public static void main(String[] args) { 
System. out. println(l / 0); 

} 

} 



(a) 



public class Test { 

public static void main(String[] args) { 
String s = "abc"; 
System. out . pri ntl n(s . charAt(3)) ; 

} 

} 



(c) 



public class Test { 

public static void main(String[] args) { 
Object o = null ; 

System, out. pri ntl n(o.toStringO) ; 

} 

} 



(c) 



I 3.2 Show the output of the following code. 



public class Test { 

public static void main(String[] args) { 
for (int i =0; i < 2; i++) { 
System. out. print(i + " ") ; 
try { 

System . out . pri ntl n(l / 0); 

} 

catch (Exception ex) { 
} 

} 

} 

} 



(a) 



public class Test { 

public static void main(String[] args) { 
int[] list = new int[5]; 
System, out. p ri ntl n (list [5]) ; 

} 

} 



(b) 



public class Test { 

public static void main(String[] args) { 
Object o = new 0bject(); 
String d = (String)o; 

} 

} 



(d) 



public class Test { 

public static void main(String[] args) { 
System. out. pri ntl n (1.0 / 0); 

} 

} 



00 



public class Test { 

public static void main(String[] args) { 
try { 

for (int i = 0; i < 2; i++) { 
System. out. pri nt(i + " "); 
System. out. pri ntl n(l / 0); 

} 

} 

catch (Exception ex) { 
} 

} 

} 



(b) 



13.3 Point out the problem in the following code. Does the code throw any exceptions? 



long value = Long .MAX_VALUE + 1; 
System. out. pri ntl n (value) ; 
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I 3.4 What is the purpose of declaring exceptions? How do you declare an exception, 
and where? Can you declare multiple exceptions in a method header? 

I 3.5 What is a checked exception, and what is an unchecked exception? 

13.6 How do you throw an exception? Can you throw multiple exceptions in one th row 
statement? 

13.7 What is the keyword throw used for? What is the keyword throws used for? 

I 3.8 What does the JVM do when an exception occurs? How do you catch an excep- 
tion? 

13.9 What is the printout of the following code? 

public class Test { 

public static void man n(Stri ng [] args) { 
try { 

int value = 30; 
if (value < 40) 

throw new Except! on("val ue is too small"); 

} 

catch (Exception ex) { 

System. out. println(ex.getMessageO) ; 

} 

System. out . pri ntl n ("Continue after the catch block"); 

} 

} 

What would be the printout if the line 
int value = 30; 
were changed to 
int value = 50; 

13.10 Suppose that statement2 causes an exception in the following try-catch 
block: 

try { 

statementl; 
statement2 ; 
statements ; 

} 

catch (Excepti onl exl) { 
} 

catch (Exception2 ex2) { 
} 

statement4; 

Answer the following questions: 

■ Will statement3 be executed? 

■ If the exception is not caught, will statement4 be executed? 

■ If the exception is caught in the catch block, will statement4 be executed? 

■ If the exception is passed to the caller, will statement4 be executed? 

13.11 What is displayed when the following program is run? 

public class Test { 

public static void man n(Stri ng [] args) { 
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try { 

int[] list = new int[10]; 

System. out. println("list[10] is " + list[10]); 

} 

catch (Ari thmeti cExcepti on ex) { 

System. out. print"ln("ArithmeticException") ; 

} 

catch (Runti meExcepti on ex) { 

System . out . pri ntl n("RuntimeException") ; 

} 

catch (Exception ex) { 

System . out . pri ntl n("Exception") ; 

} 

} 

} 

13.12 What is displayed when the following program is run? 

public class Test { 

public static void mai n(Stri ng [] args) { 
try { 

methodO ; 

System . out . pri ntl n("After the method call"); 

} 

catch (Ari thmeti cExcepti on ex) { 

System. out. println("ArithmeticException") ; 

} 

catch (Runti meExcepti on ex) { 

System . out . pri ntl n("RuntimeException") ; 

} 

catch (Exception e) { 

System. out. pri ntl n("Exception") ; 

} 

} 

static void methodO throws Exception { 
System. out . pri ntl n(l / 0); 

} 

} 

13.13 What is displayed when the following program is run? 

public class Test { 

public static void mai n(Stri ng [] args) { 
try { 

methodO ; 

System . out . pri ntl n("After the method call"); 

} 

catch (Runti meExcepti on ex) { 

System . out . pri ntl n("RuntimeException in main"); 

} 

catch (Exception ex) { 

System . out . pri ntl n("Exception in main"); 

} 

} 

static void methodO throws Exception { 
try { 

String s ="abc"; 

System . out . pri ntl n(s . charAt(3)) ; 

} 
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catch (Runti meExcepti on ex) { 

System . out . pri ntl nC'RuntimeException in methodO"); 

} 

catch (Exception ex) { 

System . out . pri ntl n("Exception in methodO"); 

} 

} 

} 

13.14 What does the method getMessageO do? 

13.15 What does the method pri ntStackTrace do? 

13.16 Does the presence of a try-catch block impose overhead when no exception 
occurs? 

13.17 Correct a compile error in the following code: 

public void m(int value) { 
if (value < 40) 

throw new Exception ("value is too small"); 

} 

Sections 13.4-13.10 

13.18 Suppose that statement2 causes an exception in the following statement: 

try { 

statementl; 
statement2 ; 
statements ; 

} 

catch (Except! onl exl) { 
} 

catch (Excepti on2 ex2) { 
} 

catch (Exception3 ex3) { 
throw ex 3 ; 

} 

finally { 

statement4 ; 

}; 

statements ; 

Answer the following questions: 

■ Will statements be executed if the exception is not caught? 

■ If the exception is of type Exception3, will statement4 be executed, and 
will statements be executed? 

13.19 Suppose the setRadius method throws the RadiusException defined in §13.7. 
What is displayed when the following program is run? 

public class Test { 

public static void mai n(Stri ng [] args) { 
try { 

methodO I 

System . out . pri ntl n("After the method call"); 

} 

catch (Runti meExcepti on ex) { 

System . out . pri ntl nC'RuntimeException in main"); 

} 
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catch (Exception ex) { 

System . out . pri ntl n( "Except ion in main"); 

} 

} 

static void method() throws Exception { 
try { 

Circle cl = new Circle(l); 
cl. setRadi us(-l) ; 

System . out . pri ntl n(cl . getRadi us () ) ; 

} 

catch (Runti meExcepti on ex) { 

System . out . pri ntl n("RuntimeException in methodO"); 

} 

catch (Exception ex) { 

System . out . pri ntl n("Exception in methodO"); 
throw ex; 

} 

} 

} 

I 3.20 The following method checks whether a string is a numeric string: 

public static boolean i sNumeri c(Stri ng token) { 
try { 

Doubl e . pa rseDoubl e (token) ; 
return true; 

} 

catch (java.lang.NumberFormatException ex) { 
return false; 

} 

} 

Is it correct? Rewrite it without using exceptions. 

Programming Exercises 



Sections 13.2-13.10 

I 3.1 * (Number FormatExcept ion) Listing 9.5, Calculator.java, is a simple command- 
line calculator. Note that the program terminates if any operand is nonnumeric. 
Write a program with an exception handler that deals with nonnumeric operands; 
then write another program without using an exception handler to achieve the 
same objective. Your program should display a message that informs the user of 
the wrong operand type before exiting (see Figure 13.6). 



j«* command Prompt 


-In 


*\ 


C: \exercise>jaua Exercise! 3_1 45 34 

please use jaua Exercisel 3_1 operandi operator 


operand2 


l 


C: \exercise>jaua Exercise13_1 45 + 34 
45 + 34 = 79 






C: \exercise>jaua Exercise! 3_1 4/5 + 34 
Wrong Input: 4/5 






C: \exercise>_ 






«l I 


► 


1 



Figure 13.6 The program performs arithmetic operations and detects input errors. 
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I 3.2* (NumberFormatException) Write a program that prompts the user to read two 
integers and displays their sum. Your program should prompt the user to read the 
number again if the input is incorrect. 

13.3* (ArraylndexOutBoundsException) Write a program that meets the following 
requirements: 

■ Create an array with 100 randomly chosen integers. 

■ Prompt the user to enter the index of the array, then display the corresponding 
element value. If the specified index is out of bounds, display the message Out 
of Bounds. 

1 3.4* (IllegalArgumentException) Modify the Loan class in Listing 10.2 to throw 
Illegal ArgumentException if the loan amount, interest rate, or number of 
years is less than or equal to zero. 

13.5* (niegalTriangleException) Exercise 11.1 defined the Triangle class with 
three sides. In a triangle, the sum of any two sides is greater than the other side. The 
Triangle class must adhere to this rule. Create the II legal TriangleExcep- 
tion class, and modify the constructor of the Triangle class to throw an 
II 1 egal Tr i angl eExcepti on object if a triangle is created with sides that violate 
the rule, as follows: 



/** Construct a triangle with the specified sides */ 
public Triangle (double si del, double side2, double side3) 
throws niegalTriangleException { 

// Implement it 

} 

1 3.6* (NumberFormatException) Listing 9.2 implements the hexToDeci mal (Stri ng 
hexString) method, which converts a hex string into a decimal number. Imple- 
ment the hexToDecimal method to throw a NumberFormatException if the 

string is not a hex string. 

13.7* (NumberFormatException) Exercise 9.8 specifies the binaryToDecimal - 
(String binaryString) method, which converts a binary string into a deci- 
mal number. Implement the binaryToDecimal method to throw a 
NumberFormatException if the string is not a binary string. 

1 3.8* (HexFormatExceptiori) Exercise 13.6 implements the hexToDecimal method 
to throw a NumberFormatException if the string is not a hex string. Define a 
custom exception called HexFormatException. Implement the hexToDecimal 
Video Note method to throw a HexFormatException if the string is not a hex string. 

1 3.9* (BinaryFormatException) Exercise 13.7 implements the bi naryToDecimal 
method to throw a BinaryFormatException if the string is not a binary string. 
Define a custom exception called BinaryFormatException. Implement the 
binaryToDecimal method to throw a BinaryFormatException if the string 
is not a binary string. 

13.10* (OutOfMemoryError) Write a program that causes the JVM to throw an 
OutOfMemoryError and catches and handles this error. 



HexFormatException 



Chapter 14 



Abstract Classes 
and Interfaces 

Objectives 

■ To design and use abstract classes (§14.2). 

■ To process a calendar using the Calendar and GregorianCal endar classes (§14.3). 

■ To specify common behavior for objects using interfaces (§14.4). 

■ To define interfaces and define classes that implement 
interfaces (§14.4). 

■ To define a natural order using the Comparabl e 
interface (§14.5). 

■ To enable objects to listen for action events using 
the ActionListener interface (§14.6). 

■ To make objects cloneable using the CI oneabl e 
interface (§14.7). 

■ To explore the similarities and differences between 
an abstract class and an interface (§14.8). 



■ To create objects for primitive values using the wrapper 
classes (Byte, Short, Integer, Long, Float, Double, 
Character, and Boolean) (§14.9). 

■ To create a generic sort method (§ 14. 10). 

■ To simplify programming using automatic conversion 
between primitive types and wrapper class types (§14.1 1) 

■ To use the Biglnteger and BigDecimal classes 
for computing very large numbers with arbitrary 
precisions (§14.12). 

■ To design the Rational class for defining 
the Rational type (§14.13). 




458 Chapter 14 Abstract Classes and Interfaces 



problem 



14-1 Introduction 

You have learned how to write simple programs to create and display GUI components. Can you 
write the code to respond to user actions, such as clicking a button? As shown in Figure 14.1, 
when a button is clicked, a message is displayed on the console. 




C:\bt>ok>jaua HandleEuent 




OK button clicked 




Cancel button clicked 




OK button clicked 




Cancel button clicked 




<i i 



Figure 1 4- 1 The program responds to button-clicking action events. 



In order to write such code, you have to know interfaces. An interface is for defining com- 
mon behavior for classes (especially unrelated classes). Before discussing interfaces, we 
introduce a closely related subject: abstract classes. 



14-2 Abstract Classes 



Video Note 
Abstract Geometric- 
Object CI ass 

abstract class 



abstract method 
abstract modifier 



abstract class 



In the inheritance hierarchy, classes become more specific and concrete with each new sub- 
class. If you move from a subclass back up to a superclass, the classes become more general 
and less specific. Class design should ensure that a superclass contains common features of its 
subclasses. Sometimes a superclass is so abstract that it cannot have any specific instances. 
Such a class is referred to as an abstract class. 

In Chapter 11, GeometricObject was defined as the superclass for Circle and 
Rectangle. GeometricObject models common features of geometric objects. Both 
Circle and Rectangle contain the getAreaO and getPerimeterO methods for com- 
puting the area and perimeter of a circle and a rectangle. Since you can compute areas and 
perimeters for all geometric objects, it is better to define the getAreaO and 
getPerimeterO methods in the GeometricObject class. However, these methods cannot 
be implemented in the GeometricObject class, because their implementation depends on 
the specific type of geometric object. Such methods are referred to as abstract methods and 
are denoted using the abstract modifier in the method header. After you define the methods 
in GeometricObject, it becomes an abstract class. Abstract classes are denoted using the 
abstract modifier in the class header. In UML graphic notation, the names of abstract 
classes and their abstract methods are italicized, as shown in Figure 14.2. Listing 14.1 gives 
the source code for the new GeometricObject class. 

Listing 14.1 GeometricObject. java 



1 

2 
3 
4 
5 
6 
7 
8 
9 
10 
11 
12 
13 



public abstract class GeometricObject { 
private String color = "white"; 
private boolean filled; 
private java. util .Date dateCreated; 

/** Construct a default geometric object */ 
protected Geometri cObjectO { 

dateCreated = new java. util .DateO ; 

} 

/** Construct a geometric object with color and filled value */ 
protected Geometri cObject(Stri ng color, boolean filled) { 
dateCreated = new java. util .Date () ; 
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_ 



GeometricObject 



-color: String 
-filled: boolean 
-dateCreated : java.util .Date 



The # sign indicates 
protected modifier 



Abstract methods 
are italicized 



#Ceometri cObject() 
#CeometricObject(color: string, 

filled: boolean) 
+getColor(): String 
+setColor(color: String): void 
+isFilled(): boolean 
+setFi lied (filled: boolean): void 
+getDateCreated() : java.util .Date 
+toString(): String 
+getArea(): double 
+getPerimeter(): double 



Abstract class 



Methods getArea and getPeri meter are 
overridden in Ci rcl e and Rectangl e. 
Superclass methods are generally omitted 
in the UML diagram for subclasses. 



Circle 



-radius: double 



+Ci rcle() 

+Ci rcle(radius: double) 
+Ci rcle(radius: double, color, string, 
filled: boolean) 

+getRadius() : double 
+setRadius(radius: double): void 
+getDiameter() : double 



Rectangle 



-width: double 
-height: double 



+Rectangl e() 

+Rectangle(width: double, height: double) 

+Rectangle(width: double, height: double, 
color: string, filled: boolean) 

+getWidth(): double 

+setWidth(width: double): void 

+getHei ght() : double 

+setHeight(height: double): void 



Figure 14-2 The new GeometricObject class contains abstract methods. 



14 this. color = color; 

15 this. filled = filled; 

16 } 
17 

18 /** Return color */ 

19 public String getColorO { 

20 return color; 

21 } 
22 

23 /** Set a new color */ 

24 public void setColor(String color) { 

25 this. color = color; 

26 } 
27 

28 /** Return filled. Since filled is boolean, 

29 * the get method is named isFilled */ 

30 public boolean isFilledO { 

31 return filled; 

32 } 
33 
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34 /** Set a new filled */ 

35 public void setFi lied (boolean filled) { 

36 this. filled = filled; 

37 } 
38 

39 /** Get dateCreated */ 

40 public java. uti 1 . Date getDateCreatedO { 

41 return dateCreated; 

42 } 
43 

44 /** Return a string representation of this object */ 

45 public String toStringO { 

46 return "created on " + dateCreated + "\ncolor: " + color + 

47 " and filled: " + filled; 

48 } 
49 

50 /** Abstract method getArea */ 

51 public abstract double getAreaO ; 
52 

53 /** Abstract method getPerimeter */ 

54 public abstract double getPerimeterO ; 

55 } 

Abstract classes are like regular classes, but you cannot create instances of abstract classes 
using the new operator. An abstract method is defined without implementation. Its implemen- 
tation is provided by the subclasses. A class that contains abstract methods must be defined 
abstract. 

The constructor in the abstract class is defined protected, because it is used only by sub- 
classes. When you create an instance of a concrete subclass, its superclass's constructor is 
invoked to initialize data fields defined in the superclass. 

The GeometricObject abstract class defines the common features (data and methods) 
for geometric objects and provides appropriate constructors. Because you don't know how to 
compute areas and perimeters of geometric objects, getArea and getPerimeter are 
defined as abstract methods. These methods are implemented in the subclasses. The 
implementation of Circle and Rectangle is the same as in Listings 14.2 and 14.3, except 
that they extend the GeometricObject class defined in this chapter, as follows: 

Listing 14-2 Circle. java 

1 public class Circle extends GeometricObject { 

2 // Same as lines 2-46 in Listing 11.2, so omitted 

3 } 

Listing 14-3 Rectangle, java 

extends abstract 1 public class Rectangle extends GeometricObject { 

GeometricObject 2 // Same as lines 2-49 in Listing 11.3, so omitted 

3 } 

14-2.1 Why Abstract Methods? 

You may be wondering what advantage is gained by defining the methods getArea and 
getPerimeter as abstract in the GeometricObject class instead of defining them only in 
each subclass. The following example shows the benefits of defining them in the 
GeometricObject class. 

The example in Listing 14.4 creates two geometric objects, a circle and a rectangle, 
invokes the equal Area method to check whether they have equal areas and invokes the 
displ ayGeometricObject method to display them. 



abstract method 



abstract method 



why protected constructor? 



implementing Ci rcl e 
implementing Rectangl e 



extends abstract 
GeometricObject 
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Listing 14-4 TestGeometricObject. java 

1 public class TestGeometricObject { 

2 /** Main method */ 

3 public static void main(String[] args) { 

4 // Create two geometric objects 

5 Ceometri cObject geoObjectl = new Circle(S); create a circle 

6 Ceometri cObject geo0bject2 = new Rectangle(5, 3); create a rectangle 
7 

8 System. out. println ("The two objects have the same area? " + 

9 equalArea(geoObjectl, geo0bject2) ) ; 
10 

11 // Display circle 

12 displayCeometricObject(geoObjectl) ; 
13 

14 // Display rectangle 

15 displayCeometric0bject(geo0bject2) ; 

16 } 
17 

18 /** A method for comparing the areas of two geometric objects */ 

19 public static boolean equal Area(Geometri cObject objectl, equal Area 

20 Geometri cObject object2) { 

21 return objectl. getAreaO == object2 . getAreaO ; 

22 } 
23 

24 /** A method for displaying a geometric object */ 

25 public static void di spl ayGeometri cObject(Geometri cObject object) { displayGeometricObject 

26 System . out . pri ntl n () ; 

27 System. out. println("The area is " + object. getAreaO) ; 

28 System. out. println("The perimeter is " + object. getPerimeterO) ; 

29 } 

30 } 



The two objects have the same area? false 

The area is 78.53981633974483 

The perimeter is 31.41592653589793 

The area is 14.0 

The perimeter is 16.0 



The methods getAreaO and getPerimeterO defined in the GeometricObject class 
are overridden in the Ci rcl e class and the Rectangl e class. The statements (lines 5-6) 

GeometricObject geoObjectl = new Circle(5); 
GeometricObject geo0bject2 = new Rectangle(5, 3); 

create a new circle and rectangle and assign them to the variables geoObjectl and 
geo0bject2. These two variables are of the GeometricObject type. 

When invoking equal Area (geoObjectl , geo0bject2) (line 9), the getAreaO method 
defined in the Circle class is used for objectl. getAreaO, since geoObjectl is a circle, 
and the getAreaO method defined in the Rectangl e class is used for object2 . getAreaO, 
since geo0bject2 is a rectangle. 

Similarly, when invoking displayGeometricObject(geoObjectl) (line 12), the 
methods getArea and getPerimeter defined in the Circle class are used, and when 
invoking displayGeometric0bject(geo0bject2) (line 15), the methods getArea and 
getPerimeter defined in the Rectangl e class are used. The JVM dynamically determines 
which of these methods to invoke at runtime, depending on the type of object. 
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why abstract methods? 



Note that you could not define the equal Area method for comparing whether two geomet- 
ric objects have the same area if the get Area method were not defined in CeometricObject. 
So, you see the benefits of defining the abstract methods in CeometricObject. 



abstract method in abstract 
class 



object cannot be created from 
abstract class 



abstract class without abstract 
method 



superclass of abstract class 
may be concrete 

concrete method overridden 
to be abstract 



abstract class as type 



14-2.2 Interesting Points on Abstract Classes 

The following points on abstract classes are worth noting: 

■ An abstract method cannot be contained in a nonabstract class. If a subclass of an abstract 
superclass does not implement all the abstract methods, the subclass must be defined 
abstract. In other words, in a nonabstract subclass extended from an abstract class, all the 
abstract methods must be implemented. Also note that abstract methods are nonstatic. 

■ An abstract class cannot be instantiated using the new operator, but you can still 
define its constructors, which are invoked in the constructors of its subclasses. For 
instance, the constructors of GeometricObject are invoked in the Circle class 
and the Rectangl e class. 

■ A class that contains abstract methods must be abstract. However, it is possible to 
define an abstract class that contains no abstract methods. In this case, you cannot 
create instances of the class using the new operator. This class is used as a base class 
for defining a new subclass. 

■ A subclass can be abstract even if its superclass is concrete. For example, the Object 
class is concrete, but its subclasses, such as CeometricObject, may be abstract. 

■ A subclass can override a method from its superclass to define it abstract. This is 
very unusual but is useful when the implementation of the method in the superclass 
becomes invalid in the subclass. In this case, the subclass must be defined abstract. 

■ You cannot create an instance from an abstract class using the new operator, but an 
abstract class can be used as a data type. Therefore, the following statement, which 
creates an array whose elements are of the GeometricObject type, is correct. 

CeometricObject[] objects = new Ceometri cObject [10] ; 

You can then create an instance of GeometricObject and assign its reference to 
the array like this: 

objects [0] = new CircleQ; 



Video Note 

Calendar and Gregorian- 
Calendar Classes 

abstract add method 



constructing calendar 



get(field) 



14-3 Example: Calendar and GregorianCalendar 

An instance of j ava . u t i 1 .Date represents a specific instant in time with millisecond preci- 
sion, java.util .Calendar is an abstract base class for extracting detailed calendar infor- 
mation, such as year, month, date, hour, minute, and second. Subclasses of Calendar can 
implement specific calendar systems, such as the Gregorian calendar, the lunar calendar, and 
the Jewish calendar. Currently, java.util .GregorianCalendar for the Gregorian calen- 
dar is supported in Java, as shown in Figure 14.3. The add method is abstract in the Cal endar 
class, because its implementation is dependent on a concrete calendar system. 

You can use new GregorianCalendarO to construct a default GregorianCalendar 
with the current time and new GregorianCalendar(year , month, date) to construct a 
GregorianCal endar with the specified year, month, and date. The month parameter is 
based — that is, is for January. 

The get(int field) method defined in the Calendar class is useful for extracting the 
date and time information from a Cal endar object. The fields are defined as constants, as 
shown in Table 14.1. 
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java. util. Calendar 



#Ca"lendar() 

+get (field: int): int 

+set (field: int, value: int): void 

+set(year: int, month: int, 
dayOf Month: int): void 

+getActual Maximum (field: int): int 

+add (field: int, amount: int): void 

+getTime(): java. util .Date 

+setTime(date : java. util .Date) : void 



Constructs a default calendar. 

Returns the value of the given calendar field. 

Sets the given calendar to the specified value. 

Sets the calendar with the specified year, month, and date. The month 
parameter is based; that is, is for January. 

Returns the maximum value that the specified calendar field could have. 

Adds or subtracts the specified amount of time to the given calendar field. 

Returns a Date object representing this calendar's time value (million 
second offset from the Unix epoch). 

Sets this calendar's time with the given Date object. 



java.util.GregorianCalendar 


+Gregori anCal endar() 




+Gregori anCal endar(year : 


i nt , 


month: int, dayOf Month 


int) 


+Gregori anCal endar(year : 


i nt , 


month: int, dayOf Month 


int, 


hour: int, minute: int, 


second: int) 



Constructs a Gregori anCal endar for the current time. 
Constructs a Gregori anCal endar for the specified year, month, and 
day of month. 

Constructs a Gregori anCal endar for the specified year, month, day of 
month, hour, minute, and second. The month parameter is based; that 
is, is for January. 



Figure 14-3 The abstract Cal endar class defines common features of various calendars. 
Table 14.1 Field constants in the Calendar class 



Constant 



Description 



YEAR 
MONTH 
DATE 
HOUR 

HOUR_OF_DAY 

MINUTE 

SECOND 

DAY_OF_WEEK 

DAY_OF_MONTH 

DAY_OF_YEAR 

WEEK_OF_MONTH 

WEEK_OF_YEAR 

AM PM 



The year of the calendar. 

The month of the calendar with for January. 

The day of the calendar. 

The hour of the calendar (12-hour notation). 

The hour of the calendar (24-hour notation). 

The minute of the calendar. 

The second of the calendar. 

The day number within the week with 1 for Sunday. 
Same as DATE. 

The day number in the year with 1 for the first day of the year. 
The week number within the month with 1 for the first week. 
The week number within the year with 1 for the first week. 
Indicator for AM or PM (0 for AM and 1 for PM). 



Listing 14.5 gives an example that displays the date and time information for the current time. 

Listing 14-5 TestCal endar. java 

1 import java. util 
2 

3 public class TestCalendar { 

4 public static void main(String[] args) { 
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calendar for current time 
extract fields in calendar 



create a calendar 



5 

6 

7 

8 

9 
10 
11 
12 
13 
14 
15 
16 
17 
18 
19 
20 
21 
22 
23 
24 
25 
26 
27 
28 
29 
30 
31 
32 
33 
34 
35 
36 
37 
38 
39 
40 
41 
42 
43 
44 
45 

46 } 



// Construct a Gregorian calendar for the current date and time 
Calendar calendar = new Gregori anCal endarO ; 
System. out. println("Current time is " + new DateO); 
System. out. println("YEAR:\t" + calendar. get(Cal endar . YEAR)) ; 
System. out. println("MONTH:\t" + calendar. get(Cal endar . MONTH)) ; 
System. out. println ("DATE :\t" + calendar. get(Cal endar . DATE)) ; 
System. out. println("HOUR:\t" + calendar. get(Cal endar . HOUR)) ; 
Sy stem . out . p ri ntl n ("HOUR_OF_DAY : \t " + 

cal endar . get (Cal endar . H0UR„0F_DAY) ) ; 
System . out . pri ntl n("MINUTE:\t" + cal endar . get(Cal endar . MINUTE)) ; 
System . out . pri ntl n("SECOND :\t" + cal endar . get (Cal endar . SECOND) ) ; 
Sy stem . out . p ri ntl n ("DAY OF WEEK : \t " + 

cal endar . get (Cal endar . DAY_OF_WEEK)) ; 
System . out . pri ntl n ("DAY OF MONTH : \t" + 

cal endar . get (Cal endar . DAY_0F_M0NTH) ) ; 
System. out. println ("DAY OF YEAR: " + 

cal endar . get (Cal endar . DAY_0F_YEAR)) ; 
System. out. pri ntl n("WEEK OF_MONTH: " + 

cal endar . get (Cal endar . WEEK_0F_M0NTH) ) ; 
System . out . pri ntl n ("WEEK OF YEAR : " + 

cal endar . get (Cal endar . WEEK_0F_YEAR) ) ; 
System. out. println("AM_PM: " + calendar. get(Cal endar . AM_PM)) ; 

// Construct a calendar for September 11, 2001 

Calendar calendarl = new GregorianCalendar(2001, 8, 11); 

System . out . pri ntl n("September 11, 2001 is a " + 

dayName0fWeek(cal endarl . get (Cal endar . DAY_OF_WEEK))) ; 



} 



public static String dayName0fWeek(int dayOfWeek) { 
switch (dayOfWeek) { 



case 
case 
case 
case 
case 
case 
case 



return 
return 
return 
return 
return 
return 
return 



'Sunday" ; 
'Monday" ; 
'Tuesday" ; 
'Wednesday" ; 
'Thursday"; 
'Friday"; 
'Saturday"; 



default: return null 



Current time 


is Sun Sep 


09 21:23:59 EDT 2007 


YEAR: 


2007 




MONTH : 


8 




DATE: 


9 




HOUR: 


9 




H0UR_0F_DAY: 


21 




MINUTE: 


23 




SECOND: 


59 




DAY_0F_WEEK: 


1 




DAY_0F_M0NTH: 


9 




DAY_0F_YEAR: 


252 




WEEK_0F_M0NTH 


: 3 




WEEK_0F_YEAR : 


37 




AM_PM: 


1 




September 11, 


2001 is a 


Tuesday 
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The set(int field, value) method defined in the Calendar class can be used to set a set(field, value) 
field. For example, you can use calendar, set (Calendar .DAY_OF_MONTH, 1) to set the 
cal endar to the first day of the month. 

The add(field, value) method adds the specified amount to a given field. For example, add(field, amount) 
add (Cal endar . DAY_OF_MONTH , 5) adds five days to the current time of the calendar, 
add (Cal endar . DAY_OF_MONTH , - 5) subtracts five days from the current time of the calendar. 

To obtain the number of days in a month, use calendar . get Actual Maximum (Cal - getActual Maximum (field) 
endar . DAY_OF_MONTH) . For example, if the cal endar were for March, this method would 
return 31. 

You can set a time represented in a Date object for the calendar by invoking setTime(Date) 
cal endar . setTime(date) and retrieve the time by invoking cal endar . getTimeQ. getTimeQ 



14-4 Interfaces 



An interface is a classlike construct that contains only constants and abstract methods. In 
many ways an interface is similar to an abstract class, but its intent is to specify common 
behavior for objects. For example, using appropriate interfaces, you can specify that the 
objects are comparable, edible, and/or cloneable. 

To distinguish an interface from a class, Java uses the following syntax to define an 
interface: 

modifier interface Interf aceName { 

/** Constant declarations */ 
/** Method signatures */ 

} 



Video Note 

The concept of interface 



Here is an example of an interface: 

public interface Edible { 

/** Describe how to eat */ 

public abstract String howToEatO; 

} 

An interface is treated like a special class in Java. Each interface is compiled into a sepa- 
rate bytecode file, just like a regular class. As with an abstract class, you cannot create an 
instance from an interface using the new operator, but in most cases you can use an interface 
more or less the same way you use an abstract class. For example, you can use an interface as 
a data type for a reference variable, as the result of casting, and so on. 

You can now use the Edible interface to specify whether an object is edible. This is 
accomplished by letting the class for the object implement this interface using the 
implements keyword. For example, the classes Chicken and Fruit in Listing 14.6 (lines 
14, 23) implement the Edi bl e interface. The relationship between the class and the interface 
is known as interface inheritance. Since interface inheritance and class inheritance are essen- 
tially the same, we will simply refer to both as inheritance. 

Listing 14-6 Test Edi ble.java 



1 

2 
3 
4 
5 
6 
7 
8 
9 
10 



public class TestEdible { 

public static void main(String[] args) { 

0bject[] objects = {new TigerO, new ChickenO, new Apple()}; 
for (int i = 0; i < objects . 1 ength ; i++) 
if (objects[i] instanceof Edible) 

System . out . pri ntl n(((Edi bl e) objects [i ] ) . howToEatO) ; 

} 



} 

class Animal { 



interface inheritance 



Animal class 
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11 // Data fields, constructors, and methods omitted here 

12 } 
13 

implements Edible 14 class Chicken extends Animal implements Edible { 

howToEatO 15 public String howToEat() { 

16 return "Chicken: Fry it"; 

17 } 

18 } 
19 

Tiger class 20 class Tiger extends Animal { 

21 } 
22 

implements Edible 23 abstract class Fruit implements Edible { 

24 // Data fields, constructors, and methods omitted here 

25 } 
26 

Apple class 27 class Apple extends Fruit { 

28 public String howToEatO { 

29 return "Apple: Make apple cider"; 

30 } 

31 } 
32 

Orange class 33 class Orange extends Fruit { 

34 public String howToEatO { 

35 return "Orange: Make orange juice"; 

36 } 

37 } 




Chicken: Fry it 

Apple: Make apple cider 



The Chi cken class extends Ann mal and implements Edi bl e to specify that chickens are edi- 
ble. When a class implements an interface, it implements all the methods defined in the inter- 
face with the exact signature and return type. The Chicken class implements the howToEat 
method (lines 15-17). 

The Frui t class implements Edi bl e. Since it does not implement the howToEat method, 
Fruit must be denoted abstract (line 23). The concrete subclasses of Fruit must 
implement the howToEat method. The Apple and Orange classes implements the 
howToEat method (lines 28, 34). 

The main method creates an array with three objects for Tiger, Chicken, and Apple 
(line 3) and invokes the howToEat method if the element is edible (line 6). 

§ Note 

Since all data fields are public final static and all methods are public abstract in an 

omitting modifiers interface, Java allows these modifiers to be omitted. Therefore the following interface definitions 

are equivalent: 



public interface T { 

public static final int K 

public abstract void p(); 



; 



Equivalent 



public interface T { 
int K = 1; 

void pQ ; 
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# Tip 

A constant defined in an interface can be accessed using the syntax InterfaceName. accessing constants 

CONST ANT^NAME (e.g., T.K). 

14-5 Example: The Comparable Interface 

Suppose you want to design a generic method to find the larger of two objects of the same 
type, such as two students, two dates, two circles, two rectangles, or two squares. In order to 
accomplish this, the two objects must be comparable. So, the common behavior for the 
objects is comparable. Java provides the Comparabl e interface for this purpose. The inter- 
face is defined as follows: 

// Interface for comparing objects, defined in java.lang java.lang. Comparable 

package java.lang; 

public interface Comparable { 
public int compareTo(Object o) ; 

} 

The compareTo method determines the order of this object with the specified object o and 
returns a negative integer, zero, or a positive integer if this object is less than, equal to, or 
greater than o. 

Many classes in the Java library (e.g., String and Date) implement Comparable to 
define a natural order for the objects. If you examine the source code of these classes, you will 
see the keyword impl ements used in the classes, as shown below: 



public class Strinq extends Object 
implements Comparable { 

// class body omitted 

} 



public class Date extends Object 
implements Comparable { 

// class body omitted 

} 



Thus, strings are comparable, and so are dates. Let s be a String object and d be a Date 
object. All the following expressions are true. 



s instanceof String 
s instanceof Object 
s instanceof Comparable 



d instanceof java.util .Date 

d instanceof Object 

d instanceof Comparable 



A generic max method for finding the larger of two objects can be defined, as shown in (a) 
or (b) below: 



// Max.java: Find a maximum object 
public class Max { 

/** Return the maximum of two objects */ 
public static Comparable max 

(Comparable ol, Comparable o2) { 
if (ol.compareTo(o2) > 0) 

return ol; 
el se 

return o2 ; 

} 

} 



(a) 



// Max.java: Find a maximum object 
public class Max { 

/** Return the maximum of two objects */ 
public static Object max 

(Object ol, Object o2) { 
if (((Comparabl e)ol) . compareTo(o2) > 0) 

return ol; 
el se 

return o2 ; 

} 

} 



(b) 
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(a) is simpler The max method in (a) is simpler than the one in (b). In the Max class in (b), ol is declared 

as Object, and (Comparabl e)ol tells the compiler to cast ol into Comparabl e so that the 
compareTo method can be invoked from ol. However, no casting is needed in the Max class 
in (a), since ol is declared as Comparabl e. 

(a) is more robust The max method in (a) is more robust than the one in (b). You must invoke the max method 

with two comparable objects. Suppose you invoke max with two noncomparable objects: 

Max.max(anyObjectl, any0bject2) ; 

The compiler will detect the error using the max method in (a), because anyObjectl is not 
an instance of Comparabl e. Using the max method in (b), this line of code will compile fine 
but will have a runtime CI assCastException, because anyObjectl is not an instance of 
Comparabl e and cannot be cast into Comparabl e. 

From now on, assume that the max method in (a) is in the text. Since strings are compara- 
ble and dates are comparable, you can use the max method to find the larger of two instances 
of String or Date. Here is an example: 



String si = "abcdef"; 
String s2 = "abcdee"; 
String s3 = (String)Max.max(sl, s2); 



Date dl = new Date() ; 
Date d2 = new DateO ; 
Date d3 = (Date)Max.max(dl, d2) ; 



implements Comparabl e 



implement compareTo 



The return value from the max method is of the Comparabl e type. So you need to cast 
it to String or Date explicitly. 

You cannot use the max method to find the larger of two instances of Rectangl e, because 
Rectangle does not implement Comparable. However, you can define a new rectangle 
class that implements Comparabl e. The instances of this new class are comparable. Let this 
new class be named Comparabl eRectangl e, as shown in Listing 14.7. 

Listing 14.7 Comparabl eRectangl e.java 

1 public class Comparabl eRectangl e extends Rectangle 

2 implements Comparable { 

3 /** Construct a Comparabl eRectangl e with specified properties */ 

4 public Comparabl eRectangl e(double width, double height) { 

5 super (width, height); 

6 } 
7 

8 /** Implement the compareTo method defined in Comparable */ 

9 public int compareTo(Object o) { 

10 if (getAreaO > ((Comparabl eRectangl e)o) . getAreaO) 

11 return 1; 

12 else if (getAreaO < ((ComparableRectangle)o) .getAreaO) 

13 return -1; 

14 el se 

15 return 0; 

16 } 

17 } 



Comparabl eRectangl e extends Rectangl e and implements Comparabl e, as shown in 
Figure 14.4. The keyword implements indicates that Comparabl eRectangl e inherits all 
the constants from the Comparabl e interface and implements the methods in the interface. 
The compareTo method compares the areas of two rectangles. An instance of 
Comparabl eRectangl e is also an instance of Rectangle, CeometricObject, Object, 
and Comparabl e. 
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Notation: 

The interface name and the 
method names are italicized. 
The dashed lines and hollow 
triangles are used to point to 
the interface. 



Geometri cObj ect 



T 



«interface» 
java, lang. Comparable 



Rectangl e 



+compareTo(o: Object): int 



Comparabl eRectangl e -- 
Figure 14-4 Comparabl eRectangl e extends Rectangl e and implements Comparabl e. 



You can now use the max method to find the larger of two objects of Comparabl eRectangl e. 

Here is an example: 

Comparabl eRectangl e rectanglel = new Comparabl eRectangl e(4 , 5); 
Comparabl eRectangl e rectangl e2 = new Comparabl eRectangl e(3 , 6); 
System . out . pri ntl n (Max . max (rectangl el , rectangl e2) ) ; 

An interface provides another form of generic programming. It would be difficult to use a benefits of interface 
generic max method to find the maximum of the objects without using an interface in this 
example, because multiple inheritance would be necessary to inherit Comparable and 
another class, such as Rectangl e, at the same time. 

The Object class contains the equal s method, which is intended for the subclasses of the 
Object class to override in order to compare whether the contents of the objects are the same. 
Suppose that the Object class contains the compareTo method, as defined in the Comparabl e 
interface; the new max method can be used to compare a list of any objects. Whether a 
compareTo method should be included in the Object class is debatable. Since the compareTo 
method is not defined in the Ob j ect class, the Comparabl e interface is defined in Java to enable 
objects to be compared if they are instances of the Comparabl e interface. It is strongly recom- 
mended (though not required) that compareTo should be consistent with equal s. That is, for 
two objects ol and o2, ol . compareTo (o2) == if and only if ol . equal s(o2) is true. 



14-6 Example: The ActionLi stener Interface 

Now you are ready to write a short program to address the problem proposed in the introduc- 
tion of this chapter. The program displays two buttons in the frame, as shown in Figure 14.1. To 
respond to a button click, you need to write the code to process the button-clicking action. The 
button is a source object where the action originates. You need to create an object capable of 
handling the action event on a button. This object is called a listener, as shown in Figure 14.5. 

Not all objects can be listeners for an action event. To be a listener, two requirements must 
be met: 

1. The object must be an instance of the ActionLi stener interface. This interface 
defines the common behavior for all action listeners. 



ActionListener interface 



2. The ActionListener object 1 i stener must be registered with the source using the 
method source. addActionListener(l istener). 



addActionLi stener 
(listener) 



button 



Clicking a button 
fires an action event 



event 



An event is 
an object 



listener 



The listener object 
processes the event 



Figure 14-5 A listener object processes the event fired from the source object. 
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create listener 
register listener 



listener class 
process event 



listener class 
process event 



The ActionListener interface contains the actionPerformed method for processing the 
event. Your listener class must override this method to respond to the event. Listing 14.8 gives 
the code that processes the ActionEvent on the two buttons. When you click the OK button, 
the message "OK button clicked" is displayed. When you click the Cancel button, the mes- 
sage "Cancel button clicked" is displayed, as shown in Figure 14.1. 

Listing 14-8 HandleEvent . java 



36 
37 
38 
39 
40 
41 
42 
43 
44 



import javax. swi ng . * ; 
import java. awt . event . ' 



{ 



public class HandleEvent extends JFrame 
public HandleEventO { 

// Create two buttons 

JButton jbtOK = new )Button("0K") ; 

JButton jbtCancel = new JButton("Cancel ") ; 

// Create a panel to hold buttons 
J Panel panel = new JPanelO; 
panel .add(jbtOK) ; 
panel . add( jbtCancel ) ; 

add (panel); // Add panel to the frame 

// Register listeners 

OKLi stenerCl ass listenerl = new OKListenerClassO ; 
Cancel Li stenerCl ass listener2 = new Cancel Li stenerCl ass() ; 
jbtOK. addActi onLi stener(l i stenerl) ; 
jbtCancel . addActi onLi stener(l i stener2) ; 

} 

public static void main(String[] args) { 
JFrame frame = new HandleEventO; 
frame. setTitle("Handle Event") ; 
frame. setSize(200, 150); 
frame. setLocati on (200, 100); 

frame . setDef aul tCl oseOpe rati on (J Frame . EXIT_0N_CL0SE) ; 
frame . setVi si bl e (true) ; 

} 



} 



} 



class Cancel Li stenerCl ass implements ActionListener 
public void actionPerformed(ActionEvent e) { 
System. out. pri ntl n("Cancel button clicked"); 

} 

} 



Two listener classes are defined in lines 34-44. Each listener class implements ActionListener 
to process ActionEvent. The object 1 i stenerl is an instance of OKLi stenerCl ass (line 18), 
which is registered with the button jbtOK (line 20). When the OK button is clicked, the 
actionPerformed(ActionEvent) method (line 36) in OKLi stenerCl ass is invoked to 
process the event. The object 1 istener2 is an instance of Cancel Li stenerCl ass (line 19), 
which is registered with the button jbtCancel in line 21. When the OK button is clicked, the 
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actionPerformed(ActionEvent) method (line 42) in Cancel Li stenerCl ass is invoked to 
process the event. Ways to process events will be discussed further in Chapter 16, "Event-Driven 
Programming." 

14-7 Example: The Cloneable Interface 

Often it is desirable to create a copy of an object. You need to use the cl one method and 
understand the Cl oneabl e interface, which is the subject of this section. 

An interface contains constants and abstract methods, but the Cl oneabl e interface is a 
special case. The Cl oneabl e interface in the j ava . 1 ang package is defined as follows: 

package java.lang; j ava. 1 ang. Cl oneabl 

public interface Cloneable { 
} 

This interface is empty. An interface with an empty body is referred to as a marker interface, marker interface 
A marker interface does not contain constants or methods. It is used to denote that a class pos- 
sesses certain desirable properties. A class that implements the Cloneable interface is 
marked cloneable, and its objects can be cloned using the cloneO method defined in the 
Object class. 

Many classes in the Java library (e.g., Date, Calendar, and ArrayList) implement 
Cl oneabl e. Thus, the instances of these classes can be cloned. For example, the following code 

1 Calendar calendar = new Gregori anCal endar(2003 , 2, 1); 

2 Calendar calendarl = calendar; 

3 Calendar calendar2 = (Calendar)calendar.cloneO ; 

4 System. out. print! n ("calendar == calendarl is " + 

5 (calendar == calendarl)); 

6 System. out. println ("calendar == calendar2 is " + 

7 (calendar == calendar2)); 

8 System. out. println("calendar.equals(calendar2) is " + 

9 calendar. equals(calendar2)) ; 

displays 

calendar == calendarl is true 
calendar == calendar2 is false 
calendar. equals(calendar2) is true 

In the preceding code, line 2 copies the reference of calendar to calendarl, so 
cal endar and cal endarl point to the same Cal endar object. Line 3 creates a new object 
that is the clone of calendar and assigns the new object's reference to calendar2. 
cal endar2 and cal endar are different objects with the same contents. 

You can clone an array using the cl one method. For example, the following code clone arrays 

1 int[] listl = {1, 2}; 

2 int[] list2 = listl. clone() ; 

3 listl[0] = 7; listl[l] = 8; 
4 

5 System. out. pri ntl n("l istl is " + listl[0] + ", " + listl[l]); 

6 System. out. println("list2 is " + list2[0] + ", " + list2[l]); 

displays 

listl is 7, 8 
list2 is 1, 2 
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how to implement 
Cloneable 



This exception is thrown if 
House does not implement 
Cloneable 



To define a custom class that implements the CI oneabl e interface, the class must override 
the cloneO method in the Object class. Listing 14.9 defines a class named House that 
implements CI oneabl e and Comparabl e. 

Listing 14-9 House. java 

1 public class House implements Cloneable, Comparable { 

2 private int id; 
private double area; 
private java. util .Date whenBuilt; 



3 

4 

5 

6 

7 

8 

9 
10 
11 
12 
13 
14 
15 
16 
17 
18 
19 
20 
21 
22 
23 
24 
25 
26 
27 
28 
29 
30 
31 
32 
33 
34 
35 
36 
37 
38 

39 } 



public House(int id, double area) { 
this. id = id; 
this. area = area; 
whenBuilt = new java. util .Date() ; 

} 

public int getld() { 
return id; 

} 

public double getAreaO { 
return area; 

} 

public java. uti 1 . Date getWhenBui 1 t() { 
return whenBuilt; 

} 

/** Override the protected clone method defined in the Object 

class, and strengthen its accessibility */ 
public Object cloneO throws CloneNotSupportedException { 

return super . cloneO ; 

} 

/** Implement the compareTo method defined in Comparable */ 
public int compareTo(Object o) { 
if (area > ((House)o) . area) 

return 1; 
else if (area < ((House)o) . area) 

return -1; 
el se 

return 0; 

} 



The House class implements the clone method (lines 26-28) defined in the Object 
class. The header is: 



CI oneNotSupported- 
Exception 



protected native Object cloneO throws CloneNotSupportedException; 

The keyword native indicates that this method is not written in Java but is implemented 
in the JVM for the native platform. The keyword protected restricts the method to be 
accessed in the same package or in a subclass. For this reason, the House class must override 
the method and change the visibility modifier to publ ic so that the method can be used in 
any package. Since the clone method implemented for the native platform in the Object 
class performs the task of cloning objects, the clone method in the House class simply 
invokes super .clone(). The clone method defined in the Object class may throw 
CloneNotSupportedException. 
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The House class implements the compareTo method (lines 31-38) defined in the 
Comparabl e interface. The method compares the areas of two houses. 

You can now create an object of the House class and create an identical copy from it, as 
follows: 

House housel = new House(l, 1750.50); 
House house2 = (House)housel. c"lone() ; 

housel and house2 are two different objects with identical contents. The clone method in 

the Object class copies each field from the original object to the target object. If the field is of 

a primitive type, its value is copied. For example, the value of area (double type) is copied 

from housel to house2. If the field is of an object, the reference of the field is copied. For 

example, the field whenBuil t is of the Date class, so its reference is copied into house2, as 

shown in Figure 14.6. Therefore, housel .whenBuil t == house2 .whenBuil t is true, 

although housel == house2 is false. This is referred to as a shallow copy rather than a deep shallow copy 

copy, meaning that if the field is of an object type, the object's reference is copied rather than deep copy 

its contents. 



housel: House 



id 



area = 1750.50- 
whenBuilt 



house2 = housel. cloneO 

house2: House 



id = 1 



area = 1750.50- 
whenBuilt 



Memory 
1750.50 I 



reference 



Memory 
1750.50 I 



reference 



whenBuilt: Date 



date object contents 



Figure 14-6 The clone method copies the values of primitive type fields and the references 
of object type fields. 



If you want to perform a deep copy, you can override the clone method with custom 
cloning operations after invoking super, cl one (). See Exercise 14.4. 

i|| Caution 

[f the House class does not override the cloneO method, the program will receive a syntax 
error, because clone() is protected in java.lang. Object. If House does not implement 
java.lang.Cloneable, invoking super. clone() (line 27) in House.java will cause a 
CloneNotSupportedException. Thus, to enable cloning an object, the class for the object 
must override the clone() method and implement Cloneable. 



14-8 Interfaces vs. Abstract Classes 

An interface can be used more or less the same way as an abstract class, but defining an inter- 
face is different from defining an abstract class. Table 14.2 summarizes the differences. 

Java allows only single inheritance for class extension but allows multiple extensions for 
interfaces. For example, 
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Table 14.2 Interfaces vs. Abstract Classes 



Variables 



Constructors 



Methods 



Abstract class No restrictions. 



Interface All variables must be 

publ ic static 
final . 



Constructors are invoked by 
subclasses through constructor 
chaining. An abstract class 
cannot be instantiated using 
the new operator. 

No constructors. An interface 
cannot be instantiated using 
the new operator. 



No restrictions. 



All methods must be 
public abstract 
instance methods. 



public class NewClass extends BaseClass 

implements Interface]., . . . , InterfaceN { 

} 

An interface can inherit other interfaces using the extends keyword. Such an interface is 
subinterface called a subinterface. For example, Newlnterf ace in the following code is a subinterface of 

Interfacel, . . . , and InterfaceN. 

public interface Newlnterface extends Interfacel, InterfaceN { 

// constants and abstract methods 

} 

A class implementing Newlnterface must implement the abstract methods defined 
in Newlnterface, Interfacel, . . . , and InterfaceN. An interface can extend other 
interfaces but not classes. A class can extend its superclass and implement multiple 
interfaces. 

All classes share a single root, the Object class, but there is no single root for interfaces. 
Like a class, an interface also defines a type. A variable of an interface type can reference any 
instance of the class that implements the interface. If a class implements an interface, the 
interface is like a superclass for the class. You can use an interface as a data type and cast a 
variable of an interface type to its subclass, and vice versa. For example, suppose that c is an 
instance of Class2 in Figure 14.7. c is also an instance of Object, Classl, Interfacel, 
Interfacel_l, Interfacel_2, Interface2_l, and Interface2_2. 



Interfacel_2 
lnterface\_Y 

Object | <j 



Interfacel 









Classl | 


— 



Interface2_2 
Interface2_\ 



Class2 



Figure 14-7 Classl implements Interfacel; Interfacel extends Interfacel_l 
and Interfacel_2. Class2 extends Classl and implements Interface2_l and 
Interface2_2. 
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§ Note 

Class names are nouns. Interface names may be adjectives or nouns. For example, both naming convention 

java.lang. Comparable and java.awt. event. ActionListener are interfaces. 
Comparable is an adjective, and ActionListener is a noun. 



Design Guide 

Abstract classes and interfaces can both be used to specify common behavior of objects. How do 
you decide whether to use an interface or a class? In general, a strong is-a relationship that clearly 
describes a parent-child relationship should be modeled using classes. For example, Gregorian cal- 
endar is a calendar, so the relationship between the class java.util .GregorianCalendar 
and java.util .Calendar is modeled using class inheritance. A weak is-a relationship, also 
known as an is-kind-of relationship, indicates that an object possesses a certain property. A weak 
is-a relationship can be modeled using interfaces. For example, all strings are comparable, so the 
String class implements the Comparable interface. 

In general, interfaces are preferred over abstract classes because an interface can define a 
common supertype for unrelated classes. Interfaces are more flexible than classes. Consider 
the Animal class. Suppose the howToEat method is defined in the Animal class, as follows: 



is-a relationship 
is-kind-of relationship 



interface preferred 



abstract class Animal { 

public abstract String howToEat() ; 

} 



Animal class 



Two subclasses of Animal are defined as follows: 

class Chicken extends Animal { Chicken class 

public String howToEatO { 
return "Fry it"; 

} 

} 

class Duck extends Animal { Duck class 

public String howToEatO { 
return "Roast it"; 

} 

} 



Given this inheritance hierarchy, polymorphism enables you to hold a reference to a Chicken 
object or a Duck object in a variable of type Animal , as in the following code: 

public static void mai n(Stri ng [] args) { 
Animal animal = new ChickenO; 
eat (animal) ; 



animal = new DuckO ; 
eat (animal) ; 

} 



public static void eat(Animal animal) { 
ani mal . howToEatO ; 

} 

The JVM dynamically decides which howToEat method to invoke based on the actual object 
that invokes the method. 

You can define a subclass of Animal . However, there is a restriction. The subclass must be 
for another animal (e.g., Turkey). 

Interfaces don't have this restriction. Interfaces give you more flexibility than classes, 
because you don't have make everything fit into one type of class. You may define the 
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howToEatO method in an interface and let it serve as a common supertype for other classes. 
For example, 

public static void man n(Stri ng [] args) { 
Edible stuff = new ChickenO; 
eat(stuff) ; 

stuff = new Duck() ; 
eat(stuff) ; 

stuff = new Broccoli (); 
eat(stuff) ; 

} 



Edible interface 



Chicken class 



Duck class 



Broccoli class 



public static void eat(Edible stuff) { 
stuff . howToEatO ; 

} 

interface Edible { 

public String howToEatO ; 

} 

class Chicken implements Edible { 
public String howToEatO { 
return "Fry it"; 

} 

} 

class Duck implements Edible { 
public String howToEatO { 
return "Roast it"; 

} 

} 

class Broccoli implements Edible { 
public String howToEatO { 
return "Stir-fry it"; 

} 

} 



To define a class that represents edible objects, simply let the class implement the Edible 
interface. The class is now a subtype of the Edi bl e type. Any Edi bl e object can be passed 
to invoke the eat method. 



14-9 Processing Primitive Data Type Values as Objects 

Owing to performance considerations, primitive data types are not used as objects in Java. 
Because of the overhead of processing objects, the language's performance would be 
adversely affected if primitive data types were treated as objects. However, many Java meth- 
ods require the use of objects as arguments. For example, the add (object) method in the 
Ar rayLi st class adds an object to an Ar rayLi st. Java offers a convenient way to incorpo- 
rate, or wrap, a primitive data type into an object (e.g., wrapping i nt into the Integer class, 
why wrapper class? and wrapping doubl e into the Doubl e class). The corresponding class is called a wrapper 

class. By using a wrapper object instead of a primitive data type variable, you can take advan- 
tage of generic programming. 

Java provides Bool ean, Character, Double, Float, Byte, Short, Integer, and Long 
wrapper classes for primitive data types. These classes are grouped in the java.lang pack- 
age. Their inheritance hierarchy is shown in Figure 14.8. 
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Comparable | 

A 



Object I 



Number | 



Character | 



Boolean | 



Double | Float | Long | Integer | Short | Byte | 

Figure 14-8 The Number class is an abstract superclass for Double, Float, Long, 
Integer, Short, and Byte. 



why wrapper class? 



§ Note 

Most wrapper class names for a primitive type are the same as the primitive data type name with naming convention 

the first letter capitalized. The exceptions are Integer and Character. 

Each numeric wrapper class extends the abstract Number class, which contains the meth- 
ods doubleValueO, floatValueO, intValueO, longValueO, shortValueO, and 
byteValueC). These methods "convert" objects into primitive type values. Each wrapper 
class overrides the toString and equal s methods defined in the Object class. Since all the 
wrapper classes implement the Comparabl e interface, the compareTo method is imple- 
mented in these classes. 

Wrapper classes are very similar to each other. The Character class was introduced in 
Chapter 9, "Strings and Text I/O." The Bool ean class wraps a Boolean value true or f al se. 
This section uses Integer and Double as examples to introduce the numeric wrapper 
classes. The key features of Integer and Doubl e are shown in Figure 14.9. 



java. lang.Number 



+byteVal ue() : byte 
+shortVal ue() : short 
+ intValue() : int 
+ longVal ue() : long 
+floatValue() : float 
+doubleValue() : double 




«interface» 
java. lang. Comparable 



4- 



+compareTo(o: Object): int 



java.lang.Integer 



-value: int 
+MAX_VALUE: int 
+MIN_VALUE: int 



+Integer(value: int) 
+Integer(s: String) 
+ valueOf(s: String): Integer 
+ valueOf(s: String, radix: int): Integer 
+ parselnt(s: String): int 
+ parselnt(s: String, radix: int): int 



java.lang.Double 



-value: double 
+MAX_VALUE: double 
+MIN_VALUE: double 



+Double(value: double) 
+Double(s: String) 
+ valueOf(s: String): Double 
+ valueOf(s: String, radix: int): Double 
+ parseDoub1e(s : String): double 
+ parseDoub1e(s : String, radix: int): double 



Figure 14-9 The wrapper classes provide constructors, constants, and conversion methods for manipulating various 
data types. 
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You can construct a wrapper object either from a primitive data type value or from a string 
representing the numeric value — for example, new Double(5 .0), new Double("5 .0"), 
new Integer(5), and new Integer("5")- 

The wrapper classes do not have no-arg constructors. The instances of all wrapper classes 
are immutable; this means that, once the objects are created, their internal values cannot be 
changed. 

Each numeric wrapper class has the constants MAX_VALUE and MIN_VALUE. MAX_VALUE 
represents the maximum value of the corresponding primitive data type. For Byte, Short, 
Integer, and Long, MIN_VALUE represents the minimum byte, short, int, and long val- 
ues. For Float and Double, MIN_VALUE represents the minimum positive float and 
double values. The following statements display the maximum integer (2,147,483,647), the 
minimum positive float (1.4E— 45), and the maximum double floating-point number 
( 1 .79769313486231570e+308d) . 

System. out. pri nt~l n("The maximum integer is " + Integer .MAX_VALUE) ; 
System. out. println("The minimum positive float is " + 

Fl oat . MIN_VALUE) ; 
System .out.print~ln( 

"The maximum double-precision floating-point number is " + 
Double.MAX_VALUE); 

Each numeric wrapper class implements the abstract methods doubleValueO, 
floatValueC), intValueO, longValueO, and shortValueO, which are defined in 
the Number class. These methods return a double, float, int, long, or short value for 
the wrapper object. 

The numeric wrapper classes have a useful static method, valueOf (String s). This 
method creates a new object initialized to the value represented by the specified string. For 
example, 

Double doubleObject = Double. valueOf ("12.4") ; 
Integer i ntegerObject = Integer. valueOf ("12") ; 

static parsing methods You have used the parselnt method in the Integer class to parse a numeric string into an 

int value and the parseDoubl e method in the Doubl e class to parse a numeric string into 
a doubl e value. Each numeric wrapper class has two overloaded parsing methods to parse a 
numeric string into an appropriate numeric value based on 10 (decimal) or any specified 
radix (e.g., 2 for binary, 8 for octal, and 16 for hexadecimal). These methods are shown 
below: 

// These two methods are in the Byte class 

public static byte parseByte(Stri ng s) 

public static byte parseByte(Stri ng s, int radix) 

// These two methods are in the Short class 

public static short parseShort(Stri ng s) 

public static short parseShort(Stri ng s, int radix) 

// These two methods are in the Integer class 

public static int parseInt(Stri ng s) 

public static int parseInt(Stri ng s, int radix) 

// These two methods are in the Long class 

public static long parseLong(Stri ng s) 

public static long parseLong(Stri ng s, int radix) 

// These two methods are in the Float class 

public static float parseFl oat(Stri ng s) 

public static float parseFl oat(Stri ng s, int radix) 



constructors 

no no-arg constructor 
immutable 

constants 



conversion methods 



static val ueOf methods 
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// These two methods are in the Double class 

public static double parseDouble(String s) 

public static double parseDouble(String s, int radix) 

For example, 

Integer . parselnt("ll" , 2) returns 3; 

Integer . parselnt("12" , 8) returns 10; 

Integer . parselnt("13" , 10) returns 13; 

Integer . parseInt("lA" , 16) returns 26; 

Integer . parselnt("12" , 2) would raise a runtime exception because 12 is not a binary 



This example presents a static generic method for sorting an array of comparable objects. The 
objects are instances of the Comparable interface, and they are compared using the 
compareTo method. The method can be used to sort an array of any objects as long as their 
classes implement the Comparabl e interface. 

To test the method, the program sorts an array of integers, an array of double numbers, an 
array of characters, and an array of strings. The program is shown in Listing 14.10. 

Listing 14-10 GenericSort. java 

1 public class GenericSort { 

2 public static void main(String[] args) { 

3 // Create an Integer array 

4 Integer[] intArray = {new Integer(2), new Integer(4), 

5 new Integer(3)}; 



number. 
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6 
7 
8 
9 
10 
11 
12 
13 
14 
15 
16 
17 
18 
19 
20 
21 
22 
23 
24 
25 
26 
27 
28 
29 
30 
31 
32 
33 
34 



} 



// Create a Double array 

Double[] doubleArray = {new Double(3.4), new Double(1.3), 
new Double(-22.1)}; 



// Create a Character array 
Character[] charArray = {new Character('a') , 
new CharacterC ' 3 ' ) , new Character( ' r ' ) } ; 



// Sort the arrays 
sort(i ntArray) ; 



// Display the sorted arrays 

System . out . pri nt("Sorted Integer objects: ") ; 

pri ntLi st(i ntArray) ; 

System . out . pri nt("Sorted Double objects: ") ; 
pri ntLi st(doubl eArray) ; 

System . out . pri nt("Sorted Character objects: ") ; 
pri ntLi st(charArray) ; 

System . out . pri nt("Sorted String objects: ") ; 
pri ntLi st(stri ngArray) ; 



// Create a String array 

String [] stri ngArray = {"Tom", "John", "Fred"}; 



sort(doubl eArray) ; 
sort(charArray) ; 



sort(stri ngArray) ; 



sort Integer objects 
sort Doubl e objects 



sort Character objects 
sort String objects 
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generic sort method 



compareTo 



35 
36 
37 
38 
39 
40 
41 
42 
43 
44 
45 
46 
47 
48 
49 
50 
51 
52 
53 
54 
55 
56 
57 
5 
59 
60 
61 
62 
63 
64 
65 

66 } 



/** Sort an array of comparable objects */ 
public static void sort(Comparable[] list) { 

Comparable currentMin; 

int currentMinlndex; 

for (int i = 0; i < list. length - 1; i++) { 

// Find the maximum in the list[0..i] 
currentMin = list[i]; 
currentMinlndex = i; 

for (int j = i + 1; j < list. length; { 
if (currentMi n . compareTo(l i st [j] ) > 0) { 
currentMin = list[j]; 
currentMinlndex = j; 

} 

} 

// Swap list[i] with list[currentMinIndex] if necessary; 
if (currentMinlndex != i) { 

1 i st [currentMi nlndex] = list[i]; 

list[i] = currentMin; 

} 



8 } 



/** Print an array of objects */ 

public static void printList(0bject[] list) { 

for (int i = 0; i < list. length; i++) 
System. out. print(list[i] + " ") ; 

System . out . pri ntl n () ; 

} 



Sorted Integer objects: 2 3 4 
Sorted Double objects: -22.1 1.3 3.4 
Sorted Character objects: Jar 
Sorted String objects: Fred John Tom 



The algorithm for the sort method is the same as in §6.10.1, "Selection Sort." The sort 
method in §6.10.1 sorts an array of doubl e values. The sort method in this example can sort 
an array of any object type, provided that the objects are also instances of the Comparabl e 
interface. This is another example of generic programming. Generic programming enables a 
method to operate on arguments of generic types, making it reusable with multiple types. 

Integer, Double, Character, and String implement Comparable, so the objects of 
these classes can be compared using the compareTo method. The sort method uses the 
compareTo method to determine the order of the objects in the array. 

# Tip 

Arrays. sort method Java provides a static sort method for sorting an array of any object type in the 

java.util .Arrays class, provided that the elements in the array are comparable. Thus you 
can use the following code to sort arrays in this example: 

java. uti 1 .Arrays . sort(i ntArray) ; 
java.util .Arrays . sort(doubl eArray) ; 
java.util .Arrays . sort(charArray) ; 
java. uti 1 .Arrays . sort(stri ngArray) ; 
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§ Note 

Arrays are objects. An array is an instance of the Object class. Furthermore, if A is a subtype of 
B, every instance of A[] is an instance of B[]. Therefore, the following statements are all true: 

new int[10] instanceof Object 

new Integer[10] instanceof Object 

new Integer [10] instanceof Comparable [] 

new Integer [10] instanceof Number [] 

new Number[10] instanceof Object[] 

f|| Caution 

Although an int value can be assigned to a double type variable, int[] and double [] are 
two incompatible types. Therefore, you cannot assign an int[] array to a variable of double [] 
orObject[] type. 

14-11 Automatic Conversion between Primitive Types 
and Wrapper Class Types 

Java allows primitive types and wrapper classes to be converted automatically. For example, 
the following statement in (a) can be simplified as in (b) due to autoboxing: 



Integer intObject = new Integer(2); 



Equivalent 



Integer intObject = 2; 



(a) 



7^" 
autoboxing 



(b) 



Converting a primitive value to a wrapper object is called boxing. The reverse conversion boxing 
is called unboxing. The compiler will automatically box a primitive value that appears in a unboxing 
context requiring an object, and will unbox an object that appears in a context requiring a 
primitive value. Consider the following example: 

1 Integer[] intArray = {1, 2, 3}; 

2 System. out. pri ntl n(i ntArray [0] + intArray[l] + intArray[2]) ; 

In line 1, primitive values 1, 2, and 3 are automatically boxed into objects new Integer(l), 
new Integer (2), and new Integer (3). Inline 2, objects intArray[0], intArray[l], 
and intArray [2] are automatically converted into int values that are added together. 



14-12 The Biglnteger and BigDecimal Classes 

If you need to compute with very large integers or high-precision floating-point values, you 
can use the Biglnteger and BigDecimal classes in the java.math package. Both are 
immutable. Both extend the Number class and implement the Comparable interface. The immutable 
largest integer of the long type is Long . MAX_VALUE (i.e., 9223372036854775807). An 
instance of Biglnteger can represent an integer of any size. You can use new Biglnte- 
ger (String) and new BigDecimal (String) to create an instance of Biglnteger and 
BigDecimal , use the add, subtract, mul tiple, divide, and remainder methods to per- 
form arithmetic operations, and use the compareTo method to compare two big numbers. For 
example, the following code creates two Biglnteger objects and multiplies them. 

Biglnteger a = new Bi glnteger("9223372036854775807") ; 
Biglnteger b = new Bi glnteger("2") ; 

Biglnteger c = a.multiply(b) ; // 9223372036854775807 * 2 
System. out. println(c) ; 
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The output is 18446744073709551614. 

There is no limit to the precision of a BigDecimal object. The divide method may 
throw an ArithmeticException if the result cannot be terminated. However, you can use 
the overloaded di vide (BigDecimal d, int scale, int roundingMode) method to 
specify a scale and a rounding mode to avoid this exception, where seal e is the minimum 
number of digits after the decimal point. For example, the following code creates two 
BigDecimal objects and performs division with scale 20 and rounding mode 
BigDecimal .ROUNDJJP. 

BigDecimal a = new BigDecimal (1.0) ; 
BigDecimal b = new BigDecimal (3) ; 

BigDecimal c = a.divide(b, 20, BigDecimal .ROUNDJJP) ; 
System. out. println(c) ; 

The output is . 33333333333333333334. 

Note that the factorial of an integer can be very large. Listing 14.11 gives a method that can 
return the factorial of any integer. 



constant 



multiply 



Listing 14. II LargeFactorial . java 

1 import java. math.*; 



public static void main(String[] args) { 

System. out. pn'ntln("50! is \n" + factori al (50)) ; 

} 

public static Biglnteger factori al (long n) { 
Biglnteger result = Biglnteger. ONE; 
for (int i = 1; i <= n; i++) 

result = result. multiply(new Biglnteger(i + "")); 

return result; 



2 




3 


P 


4 




5 




6 




7 




8 




9 




10 




11 




12 




13 




14 




15 


} 



50! is 

30414093201713378043612608166064768844377641568960512000000000000 



Biglnteger .ONE (line 9) is a constant defined in the Biglnteger class. Biglnteger . ONE 
is same as new Biglnteger("l"). 

A new result is obtained by invoking the mul ti pi y method (line 11). 

14-13 Case Study: The Rational Class 

A rational number has a numerator and a denominator in the form a/b, where a is the numer- 
ator and b the denominator. For example, 1/3, 3/4, and 10/4 are rational numbers. 

A rational number cannot have a denominator of 0, but a numerator of is fine. Every inte- 
ger i is equivalent to a rational number i/1. Rational numbers are used in exact computations 
involving fractions — for example, 1/3 = 0.33333 This number cannot be precisely rep- 
resented in floating-point format using data type doubl e or f 1 oat. To obtain the exact result, 
we must use rational numbers. 

Java provides data types for integers and floating-point numbers, but not for rational num- 
bers. This section shows how to design a class to represent rational numbers. 
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Since rational numbers share many common features with integers and floating-point 
numbers, and Number is the root class for numeric wrapper classes, it is appropriate to define 
Rational as a subclass of Number. Since rational numbers are comparable, the Rational 
class should also implement the Comparable interface. Figure 14.10 illustrates the 
Rational class and its relationship to the Number class and the Comparabl e interface. 



java. Tang. Number 



java. lang. Comparable^ '''' 



Rational 



Rational 



-numerator: long 
-denominator: long 



+Rational () 

+Rational (numerator: long, 
denominator: long) 

+getNumerator() : long 
+getDenomi nator() : long 

+add(secondRational : Rational): 
Rational 

+subtract(secondRational : 
Rational): Rational 

+multiply(secondRational : 
Rational): Rational 

+di vide(secondRational : 

Rational): Rational 
+toString(): String 

-gcd(n: long, d: long): long 



Add, Subtract, Multiply, Divide 



The numerator of this rational number. 
The denominator of this rational number. 

Creates a rational number with numerator and denominator 1. 

Creates a rational number with specified numerator and 
denominator. 

Returns the numerator of this rational number. 
Returns the denominator of this rational number. 
Returns the addition of this rational with another. 

Returns the subtraction of this rational with another. 

Returns the multiplication of this rational with another. 

Returns the division of this rational with another. 

Returns a string in the form "numerator / denominator." Returns 

numerator if denominator is 1. 
Returns the greatest common divisor between n and d. 



Figure 14-10 The properties, constructors, and methods of the Rational class are illustrated 
in UML. 



A rational number consists of a numerator and a denominator. There are many equivalent 
rational numbers — for example, 1/3 = 2/6 = 3/9 = 4/12. The numerator and the denomina- 
tor of 1/3 have no common divisor except 1, so 1/3 is said to be in lowest terms. 

To reduce a rational number to its lowest terms, you need to find the greatest common divi- 
sor (GCD) of the absolute values of its numerator and denominator, then divide both numera- 
tor and denominator by this value. You can use the method for computing the GCD of two 
integers n and d, as suggested in Listing 4.8, GreatestCommonDivisor.java. The numerator 
and denominator in a Rational object are reduced to their lowest terms. 

As usual, let us first write a test program to create two Rational objects and test its meth- 
ods. Listing 14.12 is a test program. 

Listing 14-12 TestRationalClass. java 

1 public class TestRationalClass { 

2 /** Main method */ 

3 public static void main(String[] args) { 

4 // Create and initialize two rational numbers rl and r2 . 

5 Rational rl = new Rational (4, 2); create a Rational 

6 Rational r2 = new Rational (2, 3); create a Rational 
7 
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8 // Display results 



add 


9 


System 


out 


pri ntl n(rl 




' + " 


+ r2 + " = " + 


rl.add(r2)) ; 




10 


System 


out 


pri ntl n(rl 


+ ' 


i ii 


+ r2 + " = " + 


rl. subtract(r2) ) ; 




11 


System 


out 


pri ntl n(rl 


+ ' 


i ii 


+ r2 + " = " + 


rl.multiply(r2)) ; 




12 


System 


out 


pri ntl n(rl 


+ 


' / " 


+ r2 + " = " + 


rl.divide(r2)) ; 




13 


System 


out 


pri ntl n(r2 


+ ' 


' is 


+ r2.doubleValue()) ; 



14 } 

15 } 



2 + 2/3 = 8/3 
2 - 2/3 = 4/3 
2 * 2/3 = 4/3 
2/2/3=3 

2/3 is 0.6666666666666666 



The man n method creates two rational numbers, r 1 and r2 (lines 5-6), and displays the results 
of rl + r2, rl - r2, rl x r2, and rl / r2 (lines 9-12). To perform rl + r2, invoke 
rl.add(r2) to return a new Rational object. Similarly, rl . subtract (r2) is for rl - r2, 
rl.multiply(r2) for rl x r2, and rl.divide(r2) for rl / r2. 

The doubleValueO method displays the double value of r2 (line 13). The 
doubleValueO method is defined in java.lang. Number and overridden in Rational. 

Note that when a string is concatenated with an object using the plus sign (+), the object's string 
representation from the toStringO method is used to concatenate with the string. So rl + " + 
11 + r2 + " = " + rl.add(r2) is equivalent to rl . toStringO + " + " + r2.toString() + 
" = " + rl.add(r2) .toStringO. 

The Rational class is implemented in Listing 14.13. 

Listing 14-13 Rational .java 

1 public class Rational extends Number implements Comparable { 

2 // Data fields for numerator and denominator 

3 private long numerator = 0; 

4 private long denominator = 1; 
5 

6 /** Construct a rational with default properties */ 

7 public Rationale) { 

8 this(0, 1); 

9 } 
10 

11 /** Construct a rational with specified numerator and denominator */ 

12 public Rational (long numerator, long denominator) { 

13 long gcd = gcd(numerator , denominator); 

14 this. numerator = ((denominator > 0) ? 1 : -1) * numerator / gcd; 

15 this. denominator = Math . abs (denomi nator) / gcd; 

16 } 
17 

18 /** Find GCD of two numbers */ 

19 private static long gcd(long n, long d) { 

20 long nl = Math.abs(n); 

21 long n2 = Math.abs(d); 

22 int gcd = 1; 
23 

24 for (int k = 1; k <= nl && k <= n2 ; k++) { 

25 if (nl % k == && n2 % k == 0) 

26 gcd = k; 

27 } 
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28 

29 return gcd; 

30 } 
31 

32 /** Return numerator */ 

33 public long getNumeratorO { 

34 return numerator; 

35 } 
36 

37 /** Return denominator */ 

38 public long getDenomi natorO { 

39 return denominator; 

40 } 
41 

42 /** Add a rational number to this rational */ 

a _,_ c ad + 

43 public Rational add(Rational secondRati onal ) { /> + </~ u 

44 long n = numerator * secondRati onal . getDenomi natorO + 

45 denominator * secondRational .getNumeratorO ; 

46 long d = denominator * secondRational . getDenomi natorO I 

47 return new Rati onal (n, d) ; 

48 } 
49 

50 /** Subtract a rational number from this rational */ _ 

51 public Rational subtract(Rational secondRational) { 'i~~d = ~m 

52 long n = numerator * secondRati onal . getDenomi natorO 

53 - denominator * secondRati onal . getNumeratorO ; 

54 long d = denominator * secondRational . getDenomi natorO I 

55 return new Rati onal (n, d) ; 

56 } 
57 

58 /** Multiply a rational number to this rational */ 

59 public Rational multiply(Rational secondRational) { 7j x 7/ = ~£/ 

60 long n = numerator * secondRati onal . getNumeratorO ; 

61 long d = denominator * secondRational . getDenomi natorO I 

62 return new Rati onal (n, d) ; 

63 } 
64 

65 /** Divide a rational number from this rational */ 

66 public Rational di vi de(Rati onal secondRational) { b^~d = Tc 

67 long n = numerator * secondRati onal . getDenomi natorO ; 

68 long d = denominator * secondRational .numerator; 

69 return new Rati onal (n, d) ; 

70 } 
71 

72 /** Override the toStringO method */ 

73 public String toStringO { 

74 if (denominator == 1) 

75 return numerator + ""; 

76 else 

77 return numerator + "/" + denominator; 

78 } 
79 

80 /** Override the equals method in the Object class */ 

81 public boolean equal s(0bject parml) { 

82 if ((this . subtract((Rational ) (parml))) . getNumeratorO == 0) 

83 return true; 

84 else 

85 return false; 

86 } 
87 
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88 /** Implement the abstract intValue method in java.lang. Number */ 

89 public int intValueO { 

90 return (int)doubl eVal ue() ; 

91 } 
92 

93 /** Implement the abstract floatValue method in java.lang. Number */ 

94 public float floatValueO { 

95 return (float)doubl eVal ue() ; 

96 } 
97 

98 /** Implement the doubleValue method in java.lang. Number */ 

99 public double doubl eVal ue() { 

100 return numerator * 1.0 / denominator; 

101 } 
102 

103 /** Implement the abstract longValue method in java. 1 ang . Number */ 

104 public long longValue() { 

105 return (1 ong) doubl eVal ue () ; 

106 } 
107 

108 /** Implement the compareTo method in java.lang. Comparable */ 

109 public int compareTo (Object o) { 

110 if ((this.subtract((Rational)o)) . getNumeratorO > 0) 

111 return 1; 

112 else if ((this. subtract((Rational)o)) .getNumeratorO < 0) 

113 return -1; 

114 else 

115 return 0; 

116 } 

117 } 

The rational number is encapsulated in a Rational object. Internally, a rational number is 
represented in its lowest terms (line 13), and the numerator determines its sign (line 14). The 
denominator is always positive (line 15). 

The gcd() method (lines 19-30 in the Rational class) is private; it is not intended for 
use by clients. The gcd() method is only for internal use by the Rational class. The gcd() 
method is also static, since it is not dependent on any particular Rational object. 

The abs(x) method (lines 20-21 in the Rational class) is defined in the Math class that 
returns the absolute value of x. 

Two Rational objects can interact with each other to perform add, subtract, multiply, and 
divide operations. These methods return a new Rational object (lines 43-70). 

The methods toStri ng and equal s in the Object class are overridden in the Rational 
class (lines 73-91). The toStringO method returns a string representation of a Rational 
object in the form numerator/denominator, or simply numerator if denominator is 1. 
The equal s(0bject other) method returns true if this rational number is equal to the 
other rational number. 

The abstract methods intValue, longValue, floatValue, and doubleValue in the 

Number class are implemented in the Rational class (lines 88-106). These methods return 
i nt, 1 ong, f 1 oat, and doubl e value for this rational number. 

The compareTo(Object other) method in the Comparabl e interface is implemented 
in the Rational class (lines 109-116) to compare this rational number to the other rational 
number. 

|j| Tip 

The get methods for the properties numerator and denominator are provided in the 
Rational class, but the set methods are not provided, so, once a Rational object is created, 
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its contents cannot be changed. The Rational class is immutable. The String class and the 
wrapper classes for primitive type values are also immutable. 



immutable 



Tip 

The numerator and denominator are represented using two variables. It is possible to use an array 
of two integers to represent the numerator and denominator. See Exercise 14.18. The signatures 
of the public methods in the Rational class are not changed, although the internal representa- 
tion of a rational number is changed. This is a good example to illustrate the idea that the data 
fields of a class should be kept private so as to encapsulate the implementation of the class from 
the use of the class. 

The Rational class has serious limitations. It can easily overflow. For example, the fol- 
lowing code will display an incorrect result, because the denominator is too large. 

public class Test { 

public static void main(String[] args) { 
Rational rl = new Rational(l, 123456789); 
Rational r2 = new Rational (1, 123456789); 
Rational r3 = new Rational(l, 123456789); 
System . out . pri ntl n("rl * r2 * r3 is " + 
rl. mul ti ply (r2 . mul ti ply (r3))) ; 



encapsulation 



overflow 



} 



} 



rl * r2 * r3 is -1/2204193661661244627 



To fix it, you may implement the Rational class using the Biglnteger for numerator and 
denominator (see Exercise 14.19). 
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1 . Abstract classes are like regular classes with data and methods, but you cannot create 
instances of abstract classes using the new operator. 

2. An abstract method cannot be contained in a nonabstract class. If a subclass of an 
abstract superclass does not implement all the inherited abstract methods of the super- 
class, the subclass must be defined abstract. 

3. A class that contains abstract methods must be abstract. However, it is possible to 
define an abstract class that contains no abstract methods. 

4. A subclass can be abstract even if its superclass is concrete. 

5 . An interface is a classlike construct that contains only constants and abstract methods. 
In many ways, an interface is similar to an abstract class, but an abstract class can con- 
tain constants and abstract methods as well as variables and concrete methods. 
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6. An interface is treated like a special class in Java. Each interface is compiled into a 
separate bytecode file, just like a regular class. 

7. The java.lang. Comparable interface defines the compareTo method. Many 
classes in the Java library implement Comparable. 

8. The java.lang. CI oneable interface is a marker interface. An object of the class 
that implements the CI oneabl e interface is cloneable. 

9. A class can extend only one superclass but can implement one or more interfaces. 
1 0. An interface can extend one or more interfaces. 

I I . Many Java methods require the use of objects as arguments. Java offers a convenient 
way to incorporate, or wrap, a primitive data type into an object (e.g., wrapping int 
into the Integer class, and wrapping double into the Double class). The corre- 
sponding class is called a wrapper class. By using a wrapper object instead of a prim- 
itive data type variable, you can take advantage of generic programming. 

12. Java can automatically convert a primitive type value to its corresponding wrapper 
object in the context and vice versa. 

I 3. The Biglnteger class is useful to compute and process integers of any size. The 
BigDecimal class can be used to compute and process floating-point numbers with 
any arbitrary precision. 

Review Questions 



Section 14-2 

14-1 Which of the following classes definitions defines a legal abstract class? 



class A { 

abstract void unfinishedO { 
} 

} 




public class abstract A { 
abstract void unfinishedO; 

} 


(a) 


(b) 


class A { 

abstract void unfinishedO; 

} 




abstract class A { 

protected void unfinishedO; 

} 


(c) 


(d) 


abstract class A { 

abstract void unfinishedO; 

} 




abstract class A { 

abstract int unfinishedO; 

} 


(e) 


(f) 



14-2 The getArea and getPeri meter methods may be removed from the 
GeometricObject class. What are the benefits of defining getArea and 
getPerimeter as abstract methods in the GeometricObject class? 

14-3 True or false? An abstract class can be used just like a nonabstract class except that 
you cannot use the new operator to create an instance from the abstract class. 
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Sections 14-4- 14-6 

14-4 Which of the following is a correct interface? 



interface A { 

void print() { }; 

} 




abstract interface A extends 11, 12 { 
abstract void print() { }; 

} 


(a) 


(b) 


abstract interface A { 

printO ; 

} 




interface A { 
void pri nt() ; 

} 


(c) 


(d) 



14-5 True or false? If a class implements Comparable, the object of the class can 
invoke the compareTo method. 

14-6 Two max methods are defined in §14.5. Explain why the max with the signature 
max(Comparable, Comparable) is better than the one with the signature 
max(Object, Object). 

14-7 You can define the compareTo method in a class without implementing the 
Comparabl e interface. What are the benefits of implementing the Comparabl e 

interface? 

14-8 True or false? If a class implements java.awt. event. ActionListener, the 
object of the class can invoke the actionPerformed method. 

Sections 14-7-14.8 

14-9 Can you invoke the clone() method to clone an object if the class for the object 
does not implement the java.lang.Cloneable? Does the Date class imple- 
ment CI oneable? 

14-10 What would happen if the House class (defined in Listing 14.9) did not override 
the clone() method or if House did not implement java.lang.Cloneable? 

14-11 Show the printout of the following code: 

java.util .Date date = new java. uti 1 . DateO ; 
java.util .Date datel = date; 

java.util .Date date2 = (java. uti I . Date) (date . cl oneO) ; 
System. out. println(date == datel); 
System. out. pri ntln (date == date2) ; 
System . out .pri ntl n (date . equal s (date2) ) ; 

14-12 Show the printout of the following code: 

java. uti 1 . ArrayLi st list = new java.util .ArrayListO ; 

list.add("New York") ; 

java. uti 1 .ArrayLi st listl = list; 

java.util .ArrayList list2 = (java. uti 1 .ArrayLi st) (1 i st . cl one()) ; 

list.add("Atlanta") ; 

System. out. pri ntln (list == listl); 

System. out. println(list == list2); 

System. out. pri ntl n("l ist is " + list); 

System . out . pri ntl n("l istl is " + listl); 

System. out. println("list2.get(0) is " + list2.get(0)) ; 

System . out . pri ntl n("l ist2 . sizeQ is " + list2.size()) ; 
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14-13 What is wrong in the following code? 

public class Test { 

public static void man n(Stri ng [] args) { 
Geometri cObject x = new Circle(3); 
Geometri cObject y = x.clone(); 
System. out . pri ntl n(x == y) ; 

} 

} 

14-14 Give an example to show why interfaces are preferred over abstract classes. 
Section 14-9 

14-15 Describe primitive-type wrapper classes. Why do you need these wrapper classes? 
14-16 Can each of the following statements be compiled? 

Integer i = new Integer("23") ; 

Integer i = new Integer(23); 

Integer i = Integer . val ueOf ("23") ; 

Integer i = Integer . parselnt("23" , 8); 

Double d = new DoubleO; 

Double d = Double. valueOf ("23.45") ; 

int i = (Integer. val ueOf ("23")) .intValueO ; 

double d = (Double. valueOf("23. 4")) . doubl eVal ue() ; 

int i = (Double. valueOf("23. 4")). intValueO; 

String s = (Double. valueOf ("23.4")) .toStringO ; 

14-17 How do you convert an integer into a string? How do you convert a numeric string 
into an integer? How do you convert a double number into a string? How do you 
convert a numeric string into a double value? 

14-18 Why do the following two lines of code compile but cause a runtime error? 

Number numberRef = new Integer(O); 
Double doubleRef = (Double)numberRef ; 

14-19 Why do the following two lines of code compile but cause a runtime error? 

Number[] numberArray = new Integer[2] ; 
numberArray [0] = new Double(1.5); 

14-20 What is wrong in the following code? 

public class Test { 

public static void mai n(Stri ng [] args) { 
Number x = new Integer(3); 
System. out . pri ntl n(x. intVal ue()) ; 
System. out . pri ntl n(x. compareTo(new Integer(4))) ; 

} 

} 

14-21 What is wrong in the following code? 

public class Test { 

public static void mai n(Stri ng [] args) { 
Number x = new Integer(3); 
System. out . pri ntl n(x. intVal ue()) ; 

System. out . pri ntl n( (Integer) x. compareTo (new Integer (4))) ; 

} 

} 
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1 4-22 What is the output of the following code? 

public class Test { 

public static void man n(Stri ng [] args) { 
System. out . pri ntl n (Integer . parselnt("10")) ; 
System. out .pri ntl n (Integer . parselnt("10" , 10)) ; 
System. out .pri ntl n (Integer . parselnt("10" , 16)) ; 
System. out . pri ntl n (Integer . parselnt("ll")) ; 
System. out .pri ntl n (Integer . parselnt("ll" , 10)) ; 
System. out . pri ntl n (Integer . parselnt("ll" , 16)) ; 

} 

} 



Sections 14-10-14.12 

14-23 What are autoboxing and autounboxing? Are the following statements correct? 

Number x = 3; 

Integer x = 3; 

Double x = 3; 

Double x = 3.0; 

int x = new Integer(3); 

int x = new Integer(3) + new Integer(4); 

doubl e y = 3.4; 

y.intValue() ; 

lOpti onPane . showMessageDi alog(null , 45.5); 

14-24 Can you assign new int [10], new String[100], new Object [50], or new 
Calendar[20] into a variable of0bject[] type? 

14-25 What is the output of the following code? 

public class Test { 

public static void mai n(Stri ng [] args) { 

java.math.Biglnteger x = new java.math.BigInteger("3") ; 
java.math.Biglnteger y = new java.math.BigInteger("7") ; 
x.add(y) ; 

System. out . pri ntl n(x) ; 

} 

} 



Comprehensive 

14-26 Define the following terms: abstract classes, interfaces. What are the similarities 
and differences between abstract classes and interfaces? 

14-27 Indicate true or false for the following statements: 

■ An abstract class can have instances created using the constructor of the 
abstract class. 

■ An abstract class can be extended. 

■ An interface is compiled into a separate bytecode file. 

■ A subclass of a nonabstract superclass cannot be abstract. 

■ A subclass cannot override a concrete method in a superclass to define it 
abstract. 

■ An abstract method must be nonstatic 

■ An interface can have static methods. 

■ An interface can extend one or more interfaces. 
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■ An interface can extend an abstract class. 

■ An abstract class can extend an interface. 



Programming Exercises 



Sections 14.1-14.7 

I4-I* (Enabling GeometricObject comparable) Modify the GeometricObject 
class to implement the Comparabl e interface, and define a static max method in 
the GeometricObject class for finding the larger of two GeometricObject 
objects. Draw the UML diagram and implement the new GeometricObject 
class. Write a test program that uses the max method to find the larger of two cir- 
cles and the larger of two rectangles. 

1 4-2* (The Comparabl eCi re 7 e class) Create a class named Comparabl eCi rcl e that 
extends Circle and implements Comparable. Draw the UML diagram and 
implement the compareTo method to compare the circles on the basis of area. 
Write a test class to find the larger of two instances of Comparabl eCi rcl e 
objects. 

14-3* (The Colorable interface) Design an interface named Colorable with a void 
method named howToCol or () . Every class of a colorable object must implement 
the Colorable interface. Design a class named Square that extends 
GeometricObject and implements Colorable. Implement howToColor to 
display a message "Color all four sides". 

Draw a UML diagram that involves Colorable, Square, and Geomet- 
ricObject. Write a test program that creates an array of five GeometricOb- 
jects. For each object in the array, invoke its howToColor method if it is 
colorable. 

14-4* (Revising the House class) Rewrite the House class in Listing 14.9 to perform a 
deep copy on the whenBuil t field. 

1 4-5* (Enabling Ci rcl e comparable) Rewrite the Ci rcl e class in Listing 14.2 to extend 
GeometricObject and implement the Comparable interface. Override the 
equal s method in the Object class. Two Ci rcl e objects are equal if their radii 
are the same. Draw the UML diagram that involves Ci rcl e, GeometricObject, 
and Comparabl e. 

14-6* (Enabling Rectangle comparable) Rewrite the Rectangl e class in Listing 14.3 
to extend GeometricObject and implement the Comparable interface. Over- 
ride the equal s method in the Object class. Two Rectangl e objects are equal 
Video Note if their areas are the same. Draw the UML diagram that involves Rectangl e, 

Redesign the Rectangle GeometricObject, and Comparable. 

14-7* (The Octagon class) Write a class named Octagon that extends GeometricObject 
and implements the Comparable and Cloneable interfaces. Assume that all eight 
sides of the octagon are of equal size. The area can be computed using the following 
formula: 



class 



area = [2 + 4 / 'V 2 J* side* side 

Draw the UML diagram that involves Octagon, GeometricObject, 
Comparabl e, and Cloneabl e. Write a test program that creates an Octagon 
object with side value 5 and displays its area and perimeter. Create a new 
object using the clone method and compare the two objects using the 
compareTo method. 
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14-8* (Summing the areas of geometric objects) Write a method that sums the areas of 
all the geometric objects in an array. The method signature is: 

public static double sumArea(Ceometri cObject [] a) 

Write a test program that creates an array of four objects (two circles and two 
rectangles) and computes their total area using the sumArea method. 

14-9* (Finding the largest object) Write a method that returns the largest object in an 
array of objects. The method signature is: 

public static Object max(Comparabl e [] a) 

All the objects are instances of the Comparable interface. The order of the 
objects in the array is determined using the compareTo method. 

Write a test program that creates an array of ten strings, an array of ten integers, 
and an array of ten dates, and finds the largest string, integer, and date in the 
arrays. 

1 4- 1 0** (Displaying calendars) Rewrite the PrintCalendar class in Listing 5.12 to 
display a calendar for a specified month using the Calendar and 
GregorianCal endar classes. Your program receives the month and year from 
the command line. For example: 

java Exercisel4_10 1 2010 

This displays the calendar shown in Figure 14.1 1. 

You also can run the program without the year. In this case, the year is the cur- 
rent year. If you run the program without specifying a month and a year, the 
month is the current month. 



■ Command Prompt 
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Figure 14-11 The program displays a calendar for January 2010. 
Section 14-12 

1 4- 1 I ** (Divisible by 5 or 6) Find the first ten numbers (greater than Long . MAX_VALUE) 
that are divisible by 5 or 6. 

14-12** (Divisible by 2 or 3) Find the first ten numbers with 50 decimal digits that are 
divisible by 2 or 3. 

14-1 3** (Square numbers) Find the first ten square numbers that are greater than 
Long . MAX_VALUE. A square number is a number in the form of n 2 . 

14-14** (Large prime numbers) Write a program that finds five prime numbers larger 
than Long . MAX_VALUE. 
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14-15** (Mersenne prime) A prime number is called a Mersenne prime if it can be writ- 
ten in the form 2 P — 1 for some positive integer p. Write a program that finds all 
Mersenne primes with p < 100 and displays the output as shown below. (You 
have to use Biglnteger to store the number, because it is too big to be stored 
in 1 ong. Your program may take several hours to complete.) 

p 2Ap - 1 

2 3 

3 7 

5 31 

Section 14-13 

14-16** (Approximating e) Exercise 4.26 approximates e using the following series: 

1111 1 

e = 1 H H H H + ... + — 

1! 2! 3! 4! i! 



In order to get better precision, use BigDecimal with 25 digits of precision in 
the computation. Write a program that displays the e value for i = 100, 200, 
. . . , and 1000. 

14-17 (Using the Rational class) Write a program that will compute the following 
summation series using the Rational class: 

1 2 3 98 99 

- + - + -+ ... H H 

2 3 4 99 100 

You will discover that output is incorrect because of integer overflow (too 
large). To fix this problem, see Exercise 14.19. 

14-18* (Demonstrating the benefits of encapsulation) Rewrite the Rational class in 
§ 14. 13 using a new internal representation for numerator and denominator. Cre- 
ate an array of two integers as follows: 

private long[] r = new "long [2]; 

Use r[0] to represent the numerator and r[l] to represent the denominator. 
The signatures of the methods in the Rational class are not changed, so a 
client application that uses the previous Rational class can continue to use this 
new Rational class without being recompiled. 

\ 4. \ 9** (Using Biglnteger for the Rational class) Redesign and implement the 
Rational class in §14.13 using Biglnteger for numerator and denominator. 

1 4-20* (Creating a rational-number calculator) Write a program similar to Listing 9.5, 
Calculator.java. Instead of using integers, use rationals, as shown in Figure 14.12. 



C:\exercisojaua Exerciso14_20 1/2 + 
1/2 + 1/3 ! 5/6 


-In 

1/3 


*l 

1 


C : \exercise>jaua Exercise! H_20 1/2 - 
1/2 - 1/3 = 1/6 


1/3 




C ; \exercise> 




.1 \ 



Figure 14-12 The program takes three arguments (operandi, operator, and operand2) from 
the command line and displays the expression and the result of the arithmetic operation. 
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You will need to use the split method in the String class, introduced in 
§9.2.6, "Converting, Replacing, and Splitting Strings," to retrieve the numerator 
string and denominator string, and convert strings into integers using the 
Integer. parselnt method. 

1 4-2 I * (Math: The Complex class) A complex number is a number of the form a + bi, 
where a and b are real numbers and i is . The numbers a and b are known 
as the real part and imaginary part of the complex number, respectively. You can 
perform addition, subtraction, multiplication, and division for complex numbers 
using the following formula: 

a + bi + c + di = (a + c) + (b + d)i 

a + bi — (c + di) = (a ~ c) + (b ~ d)i 

(a + bi)*(c + di) = (ac — bd) + (be + ad)i 

(a + bi)/(c + di) = (ac + bd)/(c 2 + d 2 ) + (be - ad)i/(c 2 + d 2 ) 

You can also obtain the absolute value for a complex number using the follow- 
ing formula: 

\a + bi\ = Va 2 + b 2 

Design a class named Complex for representing complex numbers and the 
methods add, subtract, multiply, divide, and abs for performing com- 
plex-number operations, and override the toString method for returning a 
string representation for a complex number. The toStri ng method returns a + bi 
as a string. If b is 0, it simply returns a. 

Provide three constructors Complex (a, b), Complex (a), and ComplexC). 
Compl ex() creates a Compl ex object for number and Compl ex(a) creates a 
Complex object with for b. Also provide the getReal Part() and 
getlmaginaryPartO methods for returning the real and imaginary part of 
the complex number, respectively. 

Write a test program that prompts the user to enter two complex numbers and 
display the result of their addition, subtraction, multiplication, and division. 
Here is a sample run: 



Enter the first complex number: 3.5 5.5 h Er " 

Enter the second complex number: -3.5 1 h 

3.5 + 5.5i + -3.5 + l.Oi = 0.0 + 6.5i 

3.5 + 5.5i - -3.5 + l.Oi = 7.0 + 4.5i 

3.5 + 5.5i * -3.5 + l.Oi = -17.75 + -15.75i 

3.5 + 5.5i / -3.5 + l.Oi = -0.5094 + -1.7i 

13.5 + 5.5i| = 6.519202405202649 
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Chapter 15 

Graphics 

Objectives 

■ To describe Java coordinate systems in a GUI component (§15.2). 

■ To draw things using the methods in the Graphics class (§15.3). 

■ To override the paintComponent method to draw things on a GUI component (§15.3). 

■ To use a panel as a canvas to draw things (§15.3). 

■ To draw strings, lines, rectangles, ovals, arcs, and polygons 
(§§15.4, 15.6-15.7). 

■ To obtain font properties using FontMetrics and know 
how to center a message (§15.8). 

■ To display an image in a GUI component (§15.11). 

■ To develop reusable GUI components FigurePanel , 
MessagePanel, Still Clock, and ImageViewer 

(§§15.5, 15.9, 15.10, 15.12). 
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15.1 Introduction 

Problem Suppose you wish to draw shapes such as a bar chart, a clock, or a stop sign, as shown in 

Figure 15.1. How do you do so? 

This chapter describes how to use the methods in the Graphics class to draw strings, lines, 
rectangles, ovals, arcs, polygons, and images, and how to develop reusable GUI components. 




(a) (b) (c) 



Figure 15.1 You can draw shapes using the drawing methods in the Graphics class. 



15.2 Graphical Coordinate Systems 

To paint, you need to specify where to paint. Each component has its own coordinate system 
with the origin (0, 0) at the upper-left corner. The x-coordinate increases to the right, and the 
y-coordinate increases downward. Note that the Java coordinate system differs from the con- 
ventional coordinate system, as shown in Figure 15.2. 



(0, 0) 


X axis 




(x, y) 




Java Coordinate 




System 


' Y axis 





Conventional 

Coordinate 

System 



Figure 1 5.2 The Java coordinate system is measured in pixels, with (0 , 0) at its upper- 
left corner. 



Y axis 



(0,0) 



X axis 



The location of the upper-left corner of a component cl (e.g., a button) inside its parent 
component c2 (e.g., a panel) can be located using cl . getXO and cl . getY(). As shown in 
Figure 15.3, (xl, yl) = (cl.getXC), cl.getYO), (x2, y2) = (c2.getX(), 
c2.getYQ),and (x3, y3) = (c3.getX(), c3.getYQ). 



Cx3, y3) 
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(x2, y2) 
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Component c2 
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Figure 15.3 Each GUI component has its own coordinate system. 
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15.3 The Graphics Class 

The Graphics class provides the methods for drawing strings, lines, rectangles, ovals, arcs, 
polygons, and polylines, as shown in Figure 15.4. 

Think of a GUI component as a piece of paper and the Graphics object as a pencil or 
paintbrush. You can apply the methods in the Graphics class to draw things on a GUI 
component. 



java.awt. Graphics 



+setColor(color: Color): void 

+setFont(font : Font): void 

+drawString(s: String, x: int, y: int): void 

+drawl_ine(xl: int, yl: int, x2: int, y2 : 
i nt) : voi d 

+drawRect(x: int, y: int, w: int, h: int): 
void 

+fi"llRect(x: int, y: int, w: int, h: int): void 

+drawRoundRect(x : int, y: int, w: int, h: int, aw: 
i nt , ah : i nt) : void 

+fillRoundRect(x: int, y: int, w: int, h: int, 
aw: int, ah: int): void 

+draw3DRect(x: int, y: int, w: int, h: int, 
raised: boolean): void 

+f i 11 3DRect(x: int, y: int, w: int, h: int, 
raised: boolean): void 

+drawOval(x: int, y: int, w: int, h: int): 
void 

+fillOval(x: int, y: int, w: int, h: int): void 



int, 
void 
i nt, 
void 



+drawArc(x: int, y: int, w: int, h: 
startAngle: int, arcAngle: int): 
+fillArc(x: int, y: int, w: int, h: 
startAngle: int, arcAngle: int): 

+drawPolygon(xPoi nts : int[], yPoints: 
int[], nPoints: int): void 

+fi 11 Polygon (xPoi nts : int[], yPoints: int[], 

nPoints: int): void 
+drawPolygon(g: Polygon): void 
+f i 11 Polygon (g : Polygon): void 

+drawPolyl i ne(xPoi nts : int[], yPoints: 
int[], nPoints: int): void 



Sets a new color for subsequent drawings. 
Sets a new font for subsequent drawings. 
Draws a string starting at point (x , y) . 
Draws a line from (xl, yl) to (x2 , y2). 

Draws a rectangle with specified upper-left corner point at 
(x , y) and width w and height h. 

Draws a filled rectangle with specified upper-left corner point 
at (x , y) and width w and height h. 

Draws a round-cornered rectangle with specified arc width 
aw and arc height ah. 

Draws a filled round-cornered rectangle with specified arc 
width aw and arc height ah. 

Draws a 3-D rectangle raised above the surface or sunk into 
the surface. 

Draws a filled 3-D rectangle raised above the surface or sunk 
into the surface. 

Draws an oval bounded by the rectangle specified by the 
parameters X, y, w, and h. 

Draws a filled oval bounded by the rectangle specified by the 
parameters X, y, w, and h. 

Draws an arc conceived as part of an oval bounded by the 
rectangle specified by the parameters X, y, w. and h. 

Draws a filled arc conceived as part of an oval bounded by the 
rectangle specified by the parameters X, y, w, and h. 

Draws a closed polygon defined by arrays of X- and 

y-coordinates. Each pair of (x [i ] , y [i ] ) -coordinates is a point. 

Draws a filled polygon defined by arrays of X- and 

y-coordinates. Each pair of (x [i ] , y [i ] ) -coordinates is a point. 
Draws a closed polygon defined by a Pol ygon object. 
Draws a filled polygon defined by a Pol ygon object. 

Draws a polyline defined by arrays of X- and y-coordinates. 
Each pair of(x[i], y[i]) -coordinates is a point. 



Figure 15.4 The Graphics class contains the methods for drawing strings and shapes. 



The Graphics class-an abstract class — provides a device-independent graphics interface 
for displaying figures and images on the screen on different platforms. Whenever a compo- 
nent (e.g., a button, a label, a panel) is displayed, the JVM automatically creates a Graphics 
object for the component on the native platform and passes this object to invoke the 
paintComponent method to display the drawings. 

The signature of the paintComponent method is as follows: 

protected void paintComponent (Graphics g) 

This method, defined in the ^Component class, is invoked whenever a component is first dis- 
played or redisplayed. 
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In order to draw things on a component, you need to define a class that extends J Panel 
and overrides its paintComponent method to specify what to draw. Listing 15.1 gives an 
example that draws a line and a string on a panel, as shown in Figure 15.5. 



Listing 1 5.1 TestPaintComponent. java 



create a panel 



new panel class 

override paintComponent 

draw things in the superclass 
draw line 
draw string 



1 
2 
3 
4 
5 
6 
7 
8 
9 
10 
11 
12 
13 
14 
15 
16 
17 
18 
19 
20 
21 
22 
23 
24 
25 



import javax. swi ng . * ; 
import java.awt. Graphics; 

public class TestPaintComponent extends JFrame { 
public TestPai ntComponent() { 
add (new NewPanel ()); 

} 

public static void main(String[] args) { 

TestPaintComponent frame = new TestPai ntComponentO ; 
frame . setTitl e ("TestPaintComponent") ; 
frame.setSize(200, 100); 

frame. setLocationRelativeTo(null) ; // Center the frame 
frame . setDef aul tCl oseOpe rati on (D Frame . EXIT_0N_CL0SE) ; 
frame.setVisible(true) ; 



} 



} 



class NewPanel extends J Panel { 

protected void pai ntComponent(Craphi cs g) 
super . pai ntComponent(g) ; 
g.drawLine(0, 0, 50, 50); 
g.drawString("Banner", 0, 40); 



} 



} 



(0, 0) 

(0, 40) 
(50, 50) 





= TestPaintComponent | j | 




' > 















This is a 1 Panel 
object placed 
inside a frame 



Figure 1 5.5 A line and a string are drawn on a panel. 



The paintComponent method is automatically invoked to paint graphics when the compo- 
nent is first displayed or whenever the component needs to be redisplayed. Invoking 
super .paintComponent (g) (line 21) invokes the paintComponent method defined in 
the superclass. This is necessary to ensure that the viewing area is cleared before a new draw- 
ing is displayed. Line 22 invokes the drawLi ne method to draw a line from (0, 0) to (50, 50). 
Line 23 invokes the drawString method to draw a string. 

All the drawing methods have parameters that specify the locations of the subjects to be drawn. 
All measurements in Java are made in pixels. The string "Banner" is drawn at location (0, 40). 

The JVM invokes paintComponent to draw things on a component. The user should 
never invoke paintComponent directly. For this reason, the protected visibility is sufficient 
for paintComponent. 

Panels are invisible and are used as small containers that group components to achieve a 
desired layout. Another important use of JPanel is for drawing. You can draw things on any 
Swing GUI component, but normally you should use a J Panel as a canvas upon which to 
draw things. What happens if you replace JPanel with J Label in line 19 as follows? 

class NewPanel extends J Label { 
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The program will work, but it is not preferred, because J Label is designed for creating a label, 
not for drawing. For consistency, this book will define a canvas class by subclassing J Panel . 



extends JPaneV? 



Tip 

Some textbooks define a canvas class by subclassing ^Component. The problem is that, if you 
wish to set a background in the canvas, you have to write the code to paint the background color. 
A simple setBackground(Co1or color) method will not set a background color in a 
^Component 



extends ^Component? 



15.4 Drawing Strings, Lines, Rectangles, and Ovals 

The drawString (String s, int x, int y) method draws a string starting at the point 
(x, y), as shown in Figure 15.6(a). 

The drawLine(int xl, int yl, int x2, int y2) method draws a straight line from 
point (xl , yl) to point (x2 , y2), as shown in Figure 15.6(b). 



drawString 



drawLine 



(0, 0) 



(x, y) 



(getWidthQ, 0) 



s is displayed here 



(0, 0) 



(getWidthQ, 0) 



(xl, yl) 






(x2, y2) 



(0, getHeightO) (getWidth(), getHeightO) (0, getHeightO) (getWidth(), getHeightO) 

(a) drawString (b) drawLine 

Figure 15.6 (a) The drawString (s , x, y) method draws a string starting at (x , y). (b) The drawLine(xl, yl, 

x2 , y2) method draws a line between two specified points. 



Java provides six methods for drawing rectangles in outline or filled with color. You can 
draw or fill plain rectangles, round-cornered rectangles, or three-dimensional rectangles. 

The drawRect(int x, int y , int w, int h) method draws a plain rectangle, and the 
fillRect(int x, int y, int w, int h) method draws a filled rectangle. The parameters 
x and y represent the upper-left corner of the rectangle, and w and h are its width and height 
(see Figure 15.7). 



drawRect 
fillRect 



(x, y) 




(x, y) 



(a) Plain rectangle 



(b) Filled rectangle 



Figure 15.7 (a) The drawRect (x, y, w, h) method draws a rectangle, (b) The fillRect(x, y, w, h) method 
draws a filled rectangle. 



The drawRoundRect(int x, inty, intw, inth, int aw, int ah) method draws a drawRoundRect 
round-cornered rectangle, and the fill RoundRect (int x, inty, intw, inth, intaw, fiHRoundRect 

int ah) method draws a filled round-cornered rectangle. Parameters x, y, w, and h are the 
same as in the drawRect method, parameter aw is the horizontal diameter of the arcs at the 



Graphics 



corner, and ah is the vertical diameter of the arcs at the corner (see Figure 15.8(a)). In other 
words, aw and ah are the width and the height of the oval that produces a quarter-circle at 
each corner. 




-* w >- k w 

(a) drawRoundRect (b) drawOval 



Figure 15.8 (a) The drawRoundRect (x, y, w, h, aw, ah) method draws a round- 
cornered rectangle, (b) The drawOval (x, y , w, h) method draws an oval based on its 
bounding rectangle. 

The draw3DRect(int x, int y, int w, int h, boolean raised) method draws a 
3D rectangle and the f ill 3DRect(int x, int y, int w, int h, boolean raised) 

method draws a filled 3D rectangle. The parameters x, y, w, and h are the same as in the 
drawRect method. The last parameter, a Boolean value, indicates whether the rectangle is 
raised above the surface or sunk into the surface. 

Depending on whether you wish to draw an oval in outline or filled solid, you can use 
either the drawOval (int x, inty, intw, int h) method or the fillOval (int x, int 
y, int w, int h) method. An oval is drawn based on its bounding rectangle. Parameters x 
and y indicate the top-left corner of the bounding rectangle, and w and h indicate the width 
and height, respectively, of the bounding rectangle, as shown in Figure 15.8(b). 

15.5 Case Study: The FigurePanel Class 

This example develops a useful class for displaying various figures. The class enables the user 
to set the figure type and specify whether the figure is filled, and it displays the figure on a 
panel. The UML diagram for the class is shown in Figure 15.9. The panel can display lines, 
rectangles, round-cornered rectangles, and ovals. Which figure to display is decided by the 
type property. If the filled property is true, the rectangle, round-cornered rectangle, and 
oval are filled in the panel. 

The UML diagram serves as the contract for the FigurePanel class. The user can use the 
class without knowing how the class is implemented. Let us begin by writing a program in 
Listing 15.2 that uses the class to display six figure panels, as shown in Figure 15.10. 

Listing 15.2 TestFigurePanel . java 

1 import java.awt.*; 

2 import javax. swing.*; 
3 

4 public class TestFigurePanel extends JFrame { 

5 public TestFigurePanel () { 

6 setLayout(new Gri dLayout(2 , 3, 5, 5)); 

7 add(new FigurePanel (FigurePanel .LINE)) ; 

8 add(new FigurePanel (FigurePanel .RECTANGLE)) ; 

9 add(new FigurePanel (FigurePanel . ROUND_RECTANGLE)) ; 

10 add(new FigurePanel (FigurePanel .OVAL)) ; 

11 add(new FigurePanel (FigurePanel .RECTANGLE, true)); 
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12 add (new Fi gu rePanel (Fi gu rePanel . ROUND_RECTANGLE , true)); 

13 } 
14 

15 public static void main(String[] args) { 

16 TestFigurePanel frame = new TestFi gurePanel () ; 

17 frame.setSize(400, 200); 

18 frame. setTitle("TestFigurePanel") ; 

19 frame. setLocationRelativeTo(null) ; // Center the frame 

20 frame . setDef aul tCl oseOperati on (J Frame . EXIT_0N_CL0SE) ; 

21 frame.setVisible(true) ; 

22 } 

23 } 



j avax . swi ng . J Panel 



FigurePanel 



+LINE 



+RECTANCLE = 2 
+ROUND_RECTANGLE = 3 
+0VAL ~ 4 



-type: int 
-filled: boolean 



+FigurePanel () 

+Fi gurePanel (type : int) 

+Fi gurePanel (type : int, filled: boolean) 

+getType(): int 

+setType(type : int): void 

+isFilled(): boolean 

+setFilled(filled: boolean): void 



LINE, RECTANGLE, 
ROUND„RECTANGLE , and OVAL are 

constants, indicating the figure type 



Specifies the figure type (default: 1). 

Specifies whether the figure is filled (default: false). 

Creates a default figure panel. 

Creates a figure panel with the specified type. 

Creates a figure panel with the specified type and filled property. 

Returns the figure type. 

Sets a new figure type. 

Checks whether the figure is filled with a color. 
Sets a new filled property. 



Figure 15.9 FigurePanel displays various types of figures on the panel. 



Tral Fiij 1 1 re Prf neJ 



Jn]_xj 



Figure 15.10 Six FigurePanel objects are created to display six figures. 



The FigurePanel class is implemented in Listing 15.3. Four constants — LINE, RECTANGLE, 
ROUND_RECTANGLE, and OVAL — are declared in lines 6-9. Four types of figures are drawn 
according to the type property (line 37). The setCol or method (lines 39, 44, 53, 62) sets a 
new color for the drawing. 

Listing 15.3 FigurePanel .ja va 

1 import java.awt.*; 

2 import j avax. swi ng .) Panel ; 
3 

4 public class FigurePanel extends JPanel { 
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override 

pai ntComponent (g) 



check type 



draw lines 



fill a rectangle 
draw a rectangle 



fill round-cornered rect 



draw round-cornered rect 



fill an oval 



5 
6 
7 
8 
9 
10 
11 
12 
13 
14 
15 
16 
17 
18 
19 
20 
21 
22 
23 
24 
25 
26 
27 
28 
29 
30 
31 
32 
33 
34 
35 
36 
37 
38 
39 
40 
41 
42 
43 
44 
45 
46 
47 
48 
49 
50 
51 
52 
53 
54 
55 
56 
57 
58 
59 
60 
61 
62 
63 
64 



// Define constants 
public static final int 
public static final int 
public static final int 
public static final int 



private 
private 



int type = 1; 
bool ean f i 11 ed 



LINE = 1; 
RECTANGLE = 2; 
R0UND_RECTANGLE 
OVAL = 4; 



f al se ; 



; 



/** Construct a default FigurePanel */ 

public FigurePanel () { 

} 



the specified type */ 



/** Construct a FigurePanel with 
public FigurePanel (int type) { 
this. type = type; 

} 



/** Construct a FigurePanel with the specifi 
public FigurePanel (int type, boolean filled) 

this. type = type; 

this. filled = filled; 

} 

/** Draw a figure on the panel */ 
protected void pai ntComponent(Craphi cs g) { 
super . pai ntComponent(g) ; 



ed type and filled */ 
{ 



// Get the 
int width = 
int height 



appropriate size 

getWidthO ; 
= getHeight() ; 



for the figure 



■ width) , (int) 
(int)(0.8 * he 



switch (type) { 

case LINE: // Display two cross lines 
g.setColor(Color. BLACK) ; 
g.drawLine(10, 10, width - 10, height 
g.drawLine(width - 10, 10, 10, height 
break; 

case RECTANGLE: // Display a rectangle 
g.setColor(Color.BLUE) ; 
if (filled) 

g.fillRect((int)(0.1 
(int) (0.8 * width) 

el se 

g.drawRect((int)(0.1 * width), (int) 
(int) (0.8 * width), (int) (0.8 * he 
break; 

case R0UND_RECTANGLE : // Display a round-cornered rectangle 
g.setColor(Color.RED) ; 
if (filled) 

g.fillRoundRect((int)(0.1 * width), 
(int) (0.8 * width), (int) (0.8 * he 

el se 

g . drawRoundRect ((int) (0. 1 * width), 
(int)(0.8 * width), (int)(0.8 * he 
break; 

case OVAL: // Display an oval 
g.setColor(Color. BLACK) ; 
if (filled) 

g.fillOval ((int) (0.1 * width), (int) (0.1 * height), 



10); 
10); 



(0.1 * height) , 
ight)) ; 

(0.1 * height) , 
ight)); 



(int)(0.1 * height) , 
ight), 20, 20); 

(int) (0.1 * height) , 
ight), 20, 20); 
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65 (int) (0.8 * width), (int)(0.8 * height)); 

66 else 

67 g.drawOval ((int) (0. 1 * width), (int)(0.1 * height), draw an oval 

68 (int) (0.8 * width), (int) (0.8 * height)); 

69 } 

70 } 
71 

72 /** Set a new figure type */ 

73 public void setType(int type) { 

74 this. type = type; 

7 5 repai nt () ; repaint panel 

76 } 

77 

78 /** Return figure type */ 

79 public int getType() { 

80 return type; 

81 } 
82 

83 /** Set a new filled property */ 

84 public void setFi lied (boolean filled) { 

85 this. filled = filled; 

86 repai nt(); repaint panel 

87 } 
88 

89 /** Check if the figure is filled */ 

90 public boolean isFilled() { 

91 return filled; 

92 } 
93 

94 /** Specify preferred size */ 

95 public Dimension getPreferredSize() { override 

96 return new Dimension(80, 80); getPreferredSizeO 

97 } 

98 } 

The repaint method (lines 75, 86) is defined in the Component class. Invoking repaint 
causes the paintComponent method to be called. The repaint method is invoked to 
refresh the viewing area. Typically, you call it if you have new things to display. 

Caution 

The paintComponent method should never be invoked directly. It is invoked either by the JVM don't invoke 

whenever the viewing area changes or by the repaint method. You should override the paintComponent 
paintComponent method to tell the system how to paint the viewing area, but never override 
the repaint method. 

Note 

The repaint method lodges a request to update the viewing area and returns immediately. Its request repaint using 

effect is asynchronous, meaning that it is up to the JVM to execute the paintComponent repai nt() 

method on a separate thread. 



r 



The getPreferredSizeO method (lines 95-97), defined in Component, is overridden getPreferedSizeO 

in Fi gurePanel to specify the preferred size for the layout manager to consider when laying 
out a Fi gurePanel object. This property may or may not be considered by the layout man- 
ager, depending on its rules. For example, a component uses its preferred size in a container 
with a FI owLayout manager, but its preferred size may be ignored if it is placed in a con- 
tainer with a CridLayout manager. It is a good practice to override getPreferredSizeO 
in a subclass of JPanel to specify a preferred size, because the default preferred size for a 
JPanel is by 0. 
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15.6 Drawing Arcs 

An arc is conceived as part of an oval bounded by a rectangle. The methods to draw or fill an 
arc are as follows: 

drawArc(int x, int y, int w, int h, int startAngle, int arcAngle); 
fil!Arc(int x, int y, int w, int h, int startAngle, int arcAngle); 

Parameters x, y, w, and h are the same as in the drawOval method; parameter startAngle 
is the starting angle; arcAngle is the spanning angle (i.e., the angle covered by the arc). 
Angles are measured in degrees and follow the usual mathematical conventions (i.e., 
degrees is in the easterly direction, and positive angles indicate counterclockwise rotation 
from the easterly direction); see Figure 15.11. 

Listing 15.4 is an example of how to draw arcs; the output is shown in Figure 15.12. 

(x, y) w >- 



h 





/arcAngle\ 




^S^YstartAngl e ' 







Figure 15.11 The drawArc method draws an arc based on an oval with specified angles. 



Listing 15.4 DrawArcs. java 

1 import javax. swing. J Frame; 

2 import javax. swi ng . J Panel ; 

3 import java. awt. Graphics; 
4 

5 public class DrawArcs extends JFrame { 

6 public DrawArcsO { 

7 setTitle("DrawArcs") ; 

8 add(new ArcsPanel ()) ; 

9 } 
10 

11 /** Main method */ 

12 public static void main(String[] args) { 

13 DrawArcs frame = new DrawArcsO; 

14 frame. setSize(250, 300); 

15 frame. setLocationRelativeTo(null) ; // Center the frame 

16 frame . setDef aul tCl oseOperati on (3 Frame . EXIT_0N_CL0SE) ; 

17 frame.setVisible(true) ; 

18 } 

19 } 
20 

21 // The class for drawing arcs on a panel 

22 class ArcsPanel extends JPanel { 

23 // Draw four blades of a fan 

24 protected void pai ntComponent(Graphi cs g) { 

25 super . pai ntComponent(g) ; 
26 

27 int xCenter = getwidthO / 2; 

28 int yCenter = getHeightO / 2; 

29 int radius = (int) (Math . mi n(getWi dth() , getHeightO) * 0.4); 
30 



add a panel 



override paintComponent 
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31 


int x = xCenter 




radi us ; 








32 


int y = yCenter 




radi us ; 








33 














34 


g.fillArc(x, y, 


2 


* radius, 


2 * 


radi us , 


0, 30); 


35 


g.fil!Arc(x, y, 


~t 
I 


* radius, 


i * 


radi us , 


90, 30); 


36 


g.f"MlArc(x, y, 


2 


* radius, 


2 * 


radi us , 


180, 30); 


37 


g.fillArc(x, y, 


2 


* radius, 


2 * 


radi us , 


270, 30); 


38 


} " 












39 } 















30° arc from 0° 
30° arc from 90° 
30° arc from 180° 
30° arc from 270° 




(x, y) 









\ 



Figure 15.12 The program draws four filled arcs. 

Angles may be negative. A negative starting angle sweeps clockwise from the easterly direc- 
tion, as shown in Figure 15.13. A negative spanning angle sweeps clockwise from the starting 
angle. The following two statements draw the same arc: 



negative degrees 



g.fillArc(x, y, 2 
g.fillArc(x, y, 2 



radius, 2 
radius, 2 



radi us , 
radi us , 



-30, -20); 
-50, 20); 



The first statement uses negative starting angle -30 and negative spanning angle -20, as 
shown in Figure 15.13(a). The second statement uses negative starting angle -50 and positive 
spanning angle 20, as shown in Figure 15.13(b). 




(a) Negative starting angle -30° and (b) Negative starting angle -50° 

negative spanning angle -20° and positive spanning angle 20° 



Figure 15.13 Angles may be negative. 



15.7 Drawing Polygons and Polylines 

To draw a polygon, first create a Polygon object using the Polygon class, as shown in 
Figure 15.14. 

A polygon is a closed two-dimensional region. This region is bounded by an arbitrary 
number of line segments, each being one side (or edge) of the polygon. A polygon comprises 
a list of (x , y) -coordinate pairs in which each pair defines a vertex of the polygon, and two 
successive pairs are the endpoints of a line that is a side of the polygon. The first and final 
points are joined by a line segment that closes the polygon. 

Here is an example of creating a polygon and adding points into it: 

Polygon polygon = new PolygonO; 
polygon. addPoint(40, 20); 
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polygon. addPoi nt(70, 40) 

polygon. addPoi nt(60, 80) 

polygon. addPoi nt(45 , 45) 

polygon. addPoi nt(20, 60) 



java.awt.PoIygon 




+xpoints: int[] 




x-coordinates of all points in the polygon. 


+ypoints: int[] 




y-coordinates of all points in the polygon. 


+npoints: int 




The number of points in the polygon. 


+Polygon() 




Creates an empty polygon. 


+Pol ygon (xpoints: int[], ypoints: int[], 




Creates a polygon with the specified points. 


npoints: int) 






+addPoint(x: int, y: int) 




Appends a point to the polygon. 


The Pol ygon class models a polygon. 





After these points are added, xpoints is {40, 70, 60, 45, 20}, ypoints is {20, 40, 80, 45, 
60}, and npoints is 5. xpoints, ypoints, and npoints are public data fields in 
Pol ygon, which is a bad design. In principle, all data fields should be kept private. 
To draw or fill a polygon, use one of the following methods in the Graphics class: 

draw/Polygon (Pol ygon polygon); 

fill Polygon (Pol ygon polygon); 

drawPolygon(int[] xpoints, int[] ypoints, int npoints); 
fill Polygon(int[] xpoints, int[] ypoints, int npoints); 

For example: 

int x[] = {40, 70, 60, 45, 20}; 
int y[] = {20, 40, 80, 45, 60}; 
g.drawPolygon(x, y, x. length); 

The drawing method opens the polygon by drawing lines between point (x[i] , y[i]) and 

point (x[i+l] , y[i+l]) for i = x.length-1; it closes the polygon by drawing 

a line between the first and last points (see Figure 15.15(a)). 
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To draw apolyline, use the drawPolyl ine(int[] x, int[] y, intnPoints) method, 
which draws a sequence of connected lines defined by arrays of x- and y-coordinates. For 
example, the following code draws the polyline, as shown in Figure 15.15(b). 

int x[] = {40, 70, 60, 45, 20}; 
int y[] = {20, 40, 80, 45, 60}; 
g.drawPolyline(x, y, x. length); 

Listing 15.5 is an example of how to draw a hexagon, with the output shown in Figure 15.16. 

Listing 15.5 DrawPolygon. java 

1 import javax. swing.] Frame; 

2 import javax. swi ng . J Panel ; 

3 import java.awt. Graphics; 

4 import java.awt. Polygon; 
5 

6 public class DrawPolygon extends JFrame { 



7 public DrawPolygonO { 

8 setTi tie ("DrawPolygon") ; 

9 add (new PolygonsPanel ()) ; add a panel 
10 } 

11 

12 /** Main method */ 

13 public static void main(String[] args) { 

14 DrawPolygon frame = new DrawPolygonO; 

15 frame. setSize(200, 250); 

16 frame. setLocationRelativeTo(null) ; // Center the frame 

17 frame . setDef aul tCl oseOpe rati on (D Frame . EXIT_0N_CL0SE) ; 

18 frame.setVisible(true) ; 

19 } 



20 } 
21 

22 // Draw a polygon in the panel 

23 class PolygonsPanel extends JPanel { 



24 protected void pai ntComponent(Graphi cs g) { paintComponent 

25 super . pai ntComponent(g) ; 
26 

27 int xCenter = getwidth() / 2; 

28 int yCenter = getHeight() / 2; 

29 int radius = (int) (Math . mi n(getWi dth() , getHeightO) * 0.4); 
30 

31 // Create a Polygon object 

32 Polygon polygon = new Polygon(); 
33 

34 // Add points to the polygon in this order 

35 polygon. addPoi nt(xCenter + radius, yCenter) ; add a point 

36 polygon. addPoi nt ((int) (xCenter + radius * 

37 Math.cos(2 * Math. PI / 6)), (int) (yCenter - radius * 

38 Math.sin(2 * Math. PI / 6))); 

39 pol ygon . addPoi nt((int) (xCenter + radius * 

40 Math. cos (2 * 2 * Math. PI / 6)), (int) (yCenter - radius * 

41 Math.sin(2 * 2 * Math. PI / 6))); 

42 pol ygon . addPoi nt((int) (xCenter + radius * 

43 Math.cos(3 * 2 * Math. PI / 6)), (int) (yCenter - radius * 

44 Math.sin(3 * 2 * Math. PI / 6))); 

45 pol ygon . addPoi nt((int) (xCenter + radius * 

46 Math.cos(4 * 2 * Math. PI / 6)), (int) (yCenter - radius * 

47 Math.sin(4 * 2 * Math. PI / 6))); 

48 pol ygon . addPoi nt((int) (xCenter + radius * 
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49 
50 
51 
52 
53 
54 

55 } 



Math.cos(5 * 2 * Math . PI / 6)), (int) (yCenter - radius * 
Math.sin(5 * 2 * Math. PI / 6))); 



draw polygon 



// Draw the polygon 
g.drawPolygon(polygon) ; 



} 



BWPBBffiff _ |n | x| 




(x,y) 

x is xCenter + radius X cos(2tt/6) 
y is yCenter — radius X sin(2ir/6) 




radi us 



(xCenter, yCenter) 



Figure 15.16 The program uses the drawPolygon method to draw a polygon. 



15.8 Centering a String Using the FontMetrics Class 



You can display a string at any location in a panel. Can you display it centered? To do so, you need 
to use the FontMetri cs class to measure the exact width and height of the string for a particular 
font. FontMetrics can measure the following attributes for a given font (see Figure 15.17): 

■ Leading, pronounced ledding, is the amount of space between lines of text. 

■ Ascent is the distance from the baseline to the ascent line. The top of most characters 
in the font will be under the ascent line, but some may extend above the ascent line. 

■ Descent is the distance from the baseline to the descent line. The bottom of most 
descending characters (e.g., j, y, and g) in the font will be above the descent line, but 
some may extend below the descent line. 

■ Height is the sum of leading, ascent, and descent. 



Figure 15.17 The FontMetrics class can be used to determine the font properties of 
characters for a given font. 

FontMetrics is an abstract class. To get a FontMetrics object for a specific font, use the 
following getFontMetrics methods defined in the Graphics class: 

■ publ ic FontMetrics getFontMetrics(Font font) 

Returns the font metrics of the specified font. 

■ publ ic FontMetrics getFontMetricsO 

Returns the font metrics of the current font. 



i 



Descent line 
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You can use the following instance methods in the FontMetri cs class to obtain the attributes 
of a font and the width of a string when it is drawn using the font: 

public int getAscentO // Return the ascent 

public int getDescentO // Return the descent 

public int getLeadingO // Return the leading 

public int getHeightO // Return the height 

public int stringWidth(String str) // Return the width of the string 

Listing 15.6 gives an example that displays a message in the center of the panel, as shown in 
Figure 15.18. 



getHeightO 



t ., CenterMessage 



This is a MessagePanel object 

/ 

_ |n| x| 



stri ngAscen t ^ ^^i 



/ 

stri ngWi dthQ 



elcome to Java 



(xCoordi nate , yCoordinate) 

xCoordinate = getWidth / 2 - stringWidth / 2; 
yCoordinate = getHeight / 2 - stri ngAscent / 2; 

Figure 15.18 The program uses the FontMetrics class to measure the string width and 
height and displays it at the center of the panel. 



Listing 15.6 TestCenterMessage. java 



1 import javax. swing.*; 

2 import java.awt.*; 
3 

4 public class TestCenterMessage extends JFrame{ 

5 public TestCenterMessageO { 

6 CenterMessage messagePanel = new CenterMessageO ; create a message panel 

7 add (messagePanel ) ; add a message panel 

8 messagePanel .setBackground(Color. WHITE) ; set background 

9 messagePanel . setFont(new Font("Cal ifornian FB", Font. BOLD, 30)); set font 
10 } 

11 

12 /** Main method */ 

13 public static void main(String[] args) { 

14 TestCenterMessage frame = new TestCenterMessageO; 

15 frame. setSize(300, 150); 

16 frame. setLocationRelativeTo(null) ; // Center the frame 

17 frame . setDef aul tCl oseOperati on (J Frame . EXIT_0N_CL0SE) ; 

18 frame.setVisible(true) ; 

19 } 

20 } 
21 

22 class CenterMessage extends 1 Panel { 

23 /** Paint the message */ 

24 protected void pai ntComponent(Craphi cs g) { override pan ntComponent 

25 super. pai ntComponent(g) ; 
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get FontMetrics 



26 
27 
28 
29 
30 
31 
32 
33 
34 
35 
36 
37 
38 
39 

40 } 



// Get font metrics for the current font 
FontMetrics fm = g.getFontMetricsO ; 

// Find the center location to display 

int stringWidth = fm.stringWidth ("Wei come to Java") ; 

int stringAscent = fm.getAscentO ; 

// Get the position of the leftmost character in the baseline 
int xCoordinate = getWidthO / 2 - stringWidth / 2; 
int yCoordinate = getHeightO / 2 + stringAscent / 2; 

g . drawStri ng("Wel come to Java", xCoordinate, yCoordinate); 



The methods getWidthO and getHeightO (lines 35-36) defined in the Component class 
return the component's width and height, respectively. 

Since the message is centered, the first character of the string should be positioned at 
(xCoordinate, yCoordinate), as shown in Figure 15.18. 



Video Note 

The MessagePanel class 



15.9 Case Study: The MessagePanel Class 

This case study develops a useful class that displays a message in a panel. The class enables 
the user to set the location of the message, center the message, and move the message with the 
specified interval. The contract of the class is shown in Figure 15.19. 

Let us first write a test program in Listing 15.7 that uses the MessagePanel class to dis- 
play four message panels, as shown in Figure 15.20. 



javax . swi ng . D Panel 


Z 





MessagePanel 



-xCoordinate: int 
-yCoordinate: int 
-centered: boolean 
-message: String 
-i nterval : i nt 



+MessagePanel () 

+MessagePanel (message : Stri ng) 
+movel_eft(): void 
+moveRi ght () : voi d 
+moveUp(): void 
+moveDown(): void 



The get and set methods for these 
data fields are provided in the class, but 
omitted in the UML diagram for brevity. 



The x-coordinate for the message. 

The y-coordinate for the message. 

Specifies whether the message is displayed centered. 

The message to be displayed. 

The interval to move the message in the panel. 

Constructs a default message panel. 

Constructs a message panel with a specified string. 

Moves the message to the left. 

Moves the message to the right. 

Moves the message up. 

Moves the message down. 



Figure 15.19 MessagePanel displays a message on the panel. 
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Wecome to Java 


Java is fun 


Java is cool 


1 love Java 



Figure 15.20 TestMessagePanel uses MessagePanel to display four message panels. 

Listing 15.7 TestMessagePanel .java 

1 import java. awt.*; 

2 import javax. swing.*; 
3 

4 public class TestMessagePanel extends JFrame { 

5 public TestMessagePanel () { 

6 MessagePanel messagePanel 1 = new MessagePanel ("Wecome to Java"); create message panel 

7 MessagePanel messagePanel 2 = new MessagePanel ("Java is fun"); 

8 MessagePanel messagePanel 3 = new MessagePanel ("Java is cool"); 

9 MessagePanel messagePanel4 = new MessagePanel ("I love Java"); 

10 messagePanel 1. setFont(new Font("SansSeri f " , Font. ITALIC, 20)); setfont 

11 messagePanel 2. setFont(new Font("Courier", Font. BOLD, 20)); 

12 messagePanel 3. setFont(new Font("Times" , Font. ITALIC, 20)); 

13 messagePanel 4. setFont(new Font("Cal ifornian FB", Font. PLAIN, 20)); 

14 messagePanell.setBackground(Color.RED) ; set background 

15 messagePanel 2 . setBackg round (Col or .CYAN) ; 

16 messagePanel 3 . setBackg round (Col or .GREEN) ; 

17 messagePanel4.setBackground(Color. WHITE) ; 

18 messagePanel 1. setCentered(true) ; 
19 

20 setLayout(new Gri dLayout(2 , 2)); 

21 add(messagePanel 1) ; add message panel 

22 add(messagePanel 2) ; 

23 add(messagePanel 3) ; 

24 add(messagePane!4) ; 

25 } 
26 

27 public static void main(String[] args) { 

28 TestMessagePanel frame = new TestMessagePanel () ; 

29 frame. setSize(300, 200); 

30 frame. setTitle("TestMessagePanel") ; 

31 frame. setLocationRelativeTo(null) ; // Center the frame 

32 frame . setDef aul tCl oseOpe rati on (1 Frame . EXIT_0N_CL0SE) ; 

33 frame.setVisible(true) ; 

34 } 

35 } 

The rest of this section explains how to implement the MessagePanel class. Since you can use 

the class without knowing how it is implemented, you may skip the implementation if you wish, skip implementation? 

The MessagePanel class is implemented in Listing 15.8. The program seems long but is 
actually simple, because most of the methods are get and set methods, and each method is 
relatively short and easy to read. 



Listing 15.8 MessagePanel . java 

1 import java. awt . FontMetri cs ; 

2 import java. awt. Dimension; 

3 import java. awt. Graphics; 
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Graphics 



repaint panel 



repaint panel 



4 
5 
6 
7 
8 
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10 
11 
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14 
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20 
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23 
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26 
27 
28 
29 
30 
31 
32 
33 
34 
35 
36 
37 
38 
39 
40 
41 
42 
43 
44 
45 
46 
47 
48 
49 
50 
51 
52 
53 
54 
55 
56 
57 
58 
59 
60 
61 



i mpor t j avax . swi ng . J Panel ; 

public class MessagePanel extends DPanel { 

/** The message to be displayed */ 

private String message = "Welcome to Java"; 

/** The x-coordinate where the message is displayed */ 
private int xCoordinate = 20; 

/** The y-coordinate where the message is displayed */ 
private int yCoordinate = 20; 

/** Indicate whether the message is displayed in the center */ 
private boolean centered; 

/** The interval for moving the message horizontally and 

vertically */ 
private int interval = 10; 

/** Construct with default properties */ 

public MessagePanel () { 

} 

/** Construct a message panel with a specified message */ 
public MessagePanel (Stri ng message) { 
this. message = message; 

} 

/** Return message */ 
public String getMessageO { 
return message; 

} 

/** Set a new message */ 

public void setMessage(Stri ng message) { 

this. message = message; 

repai nt() ; 

} 

/** Return xCoordinator */ 
public int getXCoordi nate() { 
return xCoordinate; 

} 

/** Set a new xCoordinator */ 
public void setXCoordinate(int x) { 

this. xCoordinate = x; 

repai nt() ; 

} 

/** Return yCoordinator */ 
public int getYCoordi nate() { 
return yCoordinate; 

} 

/** Set a new yCoordinator */ 
public void setYCoordinate(int y) { 
this. yCoordinate = y; 
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62 repaint(); repaint panel 

63 } 
64 

65 /** Return centered */ 

66 public boolean i sCenteredO { 

67 return centered; 

68 } 
69 

70 /** Set a new centered */ 

71 public void setCente red (boolean centered) { 

72 this. centered = centered; 

73 repaintO; repaint panel 

74 } 
75 

76 /** Return interval */ 

77 public int getlnterval () { 

78 return interval; 

79 } 
80 

81 /** Set a new interval */ 

82 public void setlnterval (int interval) { 

83 this. interval = interval; 

84 repaintO; repaint panel 

85 } 
86 

87 /** Paint the message */ 

88 protected void pai ntComponent(Craphi cs g) { override paintComponent 

89 super . pai ntComponent(g) ; 
90 

91 if (centered) { check centered 

92 // Get font metrics for the current font 

93 FontMetrics fm = g.getFontMetrics() ; 
94 

95 // Find the center location to display 

96 int stringWidth = fm.stringWidth(message) ; 

97 int stringAscent = fm.getAscentO ; 

98 // Get the position of the leftmost character in the baseline 

99 xCoordinate = getWidthO / 2 - stringWidth / 2; 

100 yCoordinate = getHeightO / 2 + stringAscent / 2; 

101 } 
102 

103 g.drawString(message, xCoordinate, yCoordinate); 

104 } 
105 

106 /** Move the message left */ 

107 public void moveLeft() { 

108 xCoordinate -= interval; 

109 repaintO; 

110 } 
111 

112 /** Move the message right */ 

113 public void moveRight() { 

114 xCoordinate += interval; 

115 repaintO; 

116 } 
117 

118 /** Move the message up */ 

119 public void moveUpO { 

120 yCoordinate -= interval; 
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override 

getPreferredSize 



121 
122 
123 
124 
125 
126 
127 
128 
129 
130 
131 
132 
133 
134 } 



repai nt() ; 



} 



/** Move the message down */ 
public void moveDownO { 

yCoordinate += interval; 

repai nt() ; 

} 

/** Override get method for preferredSi ze */ 
public Dimension getPreferredSi ze() { 
return new Dimension(200, 30); 

} 



The paintComponent method displays the message centered, if the centered property is 
true (line 91). message is initialized to "Welcome to Java" in line 8. If it were not initialized, 
a Null PointerException runtime error would occur when you created a MessagePanel 
using the no-arg constructor, because message would be nul 1 in line 103. 



Caution 

The MessagePanel class uses the properties xCoordinate and yCoordinate to specify 
the position of the message displayed on the panel. Do not use the property names x and y, 
because they are already defined in the Component class to return the position of the compo- 
nent in the parent's coordinate system using getXQ and getYQ. 



Note 

The Component class has the setBackground, setForeground, and setFont methods. 
These methods are for setting colors and fonts for the entire component. Suppose you want to 
draw several messages in a panel with different colors and fonts; you have to use the setColor 
and setFont methods in the Graphics class to set the color and font for the current drawing. 



design classes for reuse 



Note 

A key feature of Java programming is the reuse of classes. Throughout this book, reusable classes 
are developed and later reused. MessagePanel is an example, as are Loan in Listing 10.2 and 
FigurePanel in Listing 15.3. MessagePanel can be reused whenever you need to display a 
message on a panel. To make your class reusable in a wide range of applications, you should pro- 
vide a variety of ways to use it. MessagePanel provides many properties and methods that will 
be used in several examples in the book. The next section presents a useful and reusable class for 
displaying a clock on a panel graphically. 



Video Note 

The StillClock class 



15.10 Case Study: The StillClock Class 

This case study develops a class that displays a clock on a panel. The contract of the class is 
shown in Figure 15.21. 

Let us first write a test program in Listing 15.9 that uses the Sti 11 CI ock class to display 
an analog clock and uses the MessagePanel class to display the hour, minute, and second in 
a panel, as shown in Figure 15.22(a). 

Listing 15.9 Di splayClock. java 

1 import java.awt.*; 

2 import javax. swing.*; 
3 

4 public class DisplayClock extends DFrame { 

5 public Di spl ayCl ock() { 
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6 

7 

8 

9 
10 
11 
12 
13 
14 
15 
16 
17 
18 
19 
20 
21 
22 
23 
24 
25 
26 
27 
28 

29 } 



// Create an analog clock for the current time 
StillClock clock = new StillClockO; 

// Display hour, minute, and second in the message panel 
MessagePanel messagePanel = new MessagePanel (clock. getHourO + 

":" + clock. getMinute() + ":" + clock. getSecondO) ; 
messagePanel . setCentered(true) ; 
messagePanel .setForeground(Color.blue) ; 

messagePanel . setFont(new Font("Courier" , Font. BOLD, 16)); 

// Add the clock and message panel to the frame 
add(clock) ; 

add(messagePanel , BorderLayout . SOUTH) ; 

} 

public static void main(String[] args) { 
DisplayClock frame = new DisplayClockO ; 
frame . setTi tl e ("Di spl ayCl ock") ; 
frame. setSize(300, 350); 

frame. setLocationRelativeTo(null) ; // Center the frame 
frame . setDef aul tCl oseOpe rati on (D Frame . EXIT_0N_CL0SE) ; 
frame . setVi si bl e (true) ; 

} 



create a clock 



create a message panel 



add a clock 

add a message panel 



j avax . swi ng . 3 Panel 



T 



-hour: int 




-minute: int >r 




-second: int 




+StillClock() 




+StillClock(hour: 
second: int) 


int, minute: int, 


+setCurrentTime() 


voi d 



The get and set methods for these 
data fields are provided in the class, but 
omitted in the UML diagram for brevity. 



The hour in the clock. 
The minute in the clock. 
The second in the clock. 

Constructs a default clock for the current time. 
Constructs a clock with a specified time. 

Sets hour, minute, and second to current time. 



Figure 15.21 StillClock displays an analog clock. 



The rest of this section explains how to implement the St i 11 CI ock class. Since you can use the 

class without knowing how it is implemented, you may skip the implementation if you wish. skip implementation? 

To draw a clock, you need to draw a circle and three hands for second, minute, and hour, implementation 
To draw a hand, you need to specify the two ends of the line. As shown in Figure 15.22(b), 
one end is the center of the clock at (xCenter, yCenter); the other end, at (xEnd, yEnd), 
is determined by the following formula: 

xEnd = xCenter + handLength x sin(8) 
yEnd = yCenter - handLength x cos(8) 

Since there are 60 seconds in one minute, the angle for the second hand is 



second x (2ji/60) 
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(0,0) 




10:6:43 



(a) (b) 

Figure 1 5.22 (a) The DisplayClock program displays a clock that shows the current time, 
(b) The endpoint of a clock hand can be determined, given the spanning angle, the hand 
length, and the center point. 

The position of the minute hand is determined by the minute and second. The exact minute 
value combined with seconds is minute + second/60. For example, if the time is 3 minutes 
and 30 seconds, the total minutes are 3.5. Since there are 60 minutes in one hour, the angle for 
the minute hand is 

(minute + second/60) x (27i/60) 

Since one circle is divided into 12 hours, the angle for the hour hand is 

(hour + minute/60 + second/(60 x 60)) x (27i/12) 

For simplicity in computing the angles of the minute hand and hour hand, you can omit the 
seconds, because they are negligibly small. Therefore, the endpoints for the second hand, 
minute hand, and hour hand can be computed as: 

xSecond = xCenter + secondHandLength x sin(second x (27i/60)) 
ySecond = yCenter - secondHandLength x cos(second x (27i/60)) 
xMinute = xCenter + mi nuteHandLength x sin(minute x (2ji/60)) 
yMinute = yCenter - mi nuteHandLength x cos(minute x (2ji/60)) 
xHour = xCenter + hourHandLength x sin((hour + minute/60) x (2tc/60)) 
yHour = yCenter - hourHandLength x cos((hour + minute/60) x (27i/60)) 

The StillClock class is implemented in Listing 15.10. 

Listing 15.10 StillClock. java 

1 import java.awt.*; 

2 import javax. swing.*; 

3 import java. uti 1 . * ; 
4 

5 public class StillClock extends JPanel { 

6 private int hour; 

7 private int minute; 

8 private int second; 
9 

10 /** Construct a default clock with the current time*/ 

11 public StillClockO { 

12 setCurrentTimeO ; 

13 } 
14 

15 /** Construct a clock with specified hour, minute, and second */ 
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16 public Still C~lock(int hour, int minute, int second) { 

17 this. hour = hour; 

18 this. minute = minute; 

19 this. second = second; 

20 } 
21 

22 /** Return hour */ 

23 public int getHourO { 

24 return hour; 

25 } 
26 

27 /** Set a new hour */ 

28 public void setHour(int hour) { 

29 this. hour = hour; 

30 repaintO; repaint panel 

31 } 
32 

33 /** Return minute */ 

34 public int getMinuteO { 

35 return minute; 

36 } 
37 

38 /** Set a new minute */ 

39 public void setMi nute(int minute) { 

40 this. minute = minute; 

41 repaint(); repaint panel 

42 } 
43 

44 /** Return second */ 

45 public int getSecondO { 

46 return second; 

47 } 
48 

49 /** Set a new second */ 

50 public void setSecond(int second) { 

51 this. second = second; 

52 repaint(); repaint panel 

53 } 
54 

55 /** Draw the clock */ 

56 protected void pai ntComponent(Craphi cs g) { override paintComponent 

57 super . pai ntComponent(g) ; 
58 

59 // Initialize clock parameters 

60 int clockRadius = 

61 (int)(Math.min(getWidth() , getHeightO) * 0.8 * 0.5); 

62 int xCenter = getWidth() / 2; 

63 int yCenter = getHeightO / 2; 
64 

65 // Draw circle 

66 g. setColor(Color. BLACK) ; 

67 g . drawOval (xCenter - clockRadius, yCenter - clockRadius, 

68 2 * clockRadius, 2 * clockRadius); 

69 g.drawString("12", xCenter - 5, yCenter - clockRadius + 12); 

70 g . drawStri ng("9" , xCenter - clockRadius + 3, yCenter + 5); 

71 g.drawString("3" , xCenter + clockRadius - 10, yCenter + 3); 

72 g.drawString("6" , xCenter - 3, yCenter + clockRadius - 3); 
73 

74 // Draw second hand 

75 int sLength = (int) (cl ockRadi us * 0.8); 
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get current time 



override 

getPreferredSize 
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int xSecond = (int) (xCenter + sLength * 
Math. sin (second * (2 * Math . PI / 60))); 

int ySecond = (int) (yCenter - sLength * 
Math. cos (second * (2 * Math. PI / 60))); 

g.setCo~lor(Co~lor. red) ; 

g . drawLi ne(xCenter , yCenter, xSecond, ySecond) ; 

// Draw minute hand 

int mLength = (int) (cl ockRadi us * 0.65); 
int xMinute = (int) (xCenter + mLength * 

Math.sin(minute * (2 * Math. PI / 60))); 
int yMinute = (int) (yCenter - mLength * 

Math. cos (minute * (2 * Math. PI / 60))); 
g.setColor(Color.blue) ; 

g . drawLi ne(xCenter , yCenter, xMinute, yMinute); 



// Draw hour hand 

int hLength = (int) (cl ockRadi us * 0.5); 
int xHour = (int) (xCenter + hLength * 

Math.sin((hour % 12 + minute / 60.0) * (2 
int yHour = (int) (yCenter - hLength * 

Math.cos((hour % 12 + minute / 60.0) * (2 
g.setColor(Color. green) ; 

g . drawLi ne(xCenter , yCenter, xHour, yHour); 



Math. PI / 12))); 
Math. PI / 12))); 



} 

public void setCurrentTime() { 

// Construct a calendar for the current date and time 
Calendar calendar = new Gregori anCal endar() ; 

// Set current hour, minute and second 
this. hour = calendar. get (Calendar.H0UR_0F_DAY) ; 
this. minute = cal endar . get(Cal endar . MINUTE) ; 
this. second = cal endar . get(Cal endar . SECOND) ; 

} 

public Dimension getPreferredSi ze() { 
return new Dimension (200, 200); 

} 



The program enables the clock size to adjust as the frame resizes. Every time you resize the 
frame, the paintComponent method is automatically invoked to paint the new frame. The 
paintComponent method displays the clock in proportion to the panel width (getWidthO) 
and height (getHeightQ) (lines 60-63 in StillCl ock). 



15.11 Displaying Images 

You learned how to create image icons and display them in labels and buttons in § 12. 10, "Image 
Icons." For example, the following statements create an image icon and display it in a label: 

Imagelcon icon = new ImageIcon("image/us.gif") ; 
J Label jlbl Image = new J Label (imagelcon) ; 

An image icon displays a fixed-size image. To display an image in a flexible size, you need to 
use the java.awt. Image class. An image can be created from an image icon using the 
get Image () method as follows: 

Image image = imagelcon. getlmageQ ; 
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Using a label as an area for displaying images is simple and convenient, but you don't have 
much control over how the image is displayed. A more flexible way to display images is to 
use the drawlmage method of the Graphics class on a panel. Four versions of the 
drawlmage method are shown in Figure 15.23. 



java. awt. Graphics 



+drawlmage (image : Image, x: int, y: int, 
bgcolor: Color, observer: 
ImageObserver) : void 



+drawlmage (image: Image, x: int, y: int, 
observer: ImageObserver): void 

+drawlmage(image: Image, x: int, y: int, 
width: int, height: int, observer: 
ImageObserver): void 

+drawlmage(image: Image, x: int, y: int, 
width: int, height: int, bgcolor: Color, 
observer: ImageObserver): void 



Draws the image in a specified location. The image's top-left corner is at 
(x, y) in the graphics context's coordinate space. Transparent pixels in 
the image are drawn in the specified color bgcol or. The observer is the 
object on which the image is displayed. The image is cut off if it is 
larger than the area it is being drawn on. 

Same as the preceding method except that it does not specify a background 
color. 

Draws a scaled version of the image that can fill all of the available space 
in the specified rectangle. 

Same as the preceding method except that it provides a solid background 
color behind the image being drawn. 



Figure 15.23 You can apply the drawlmage method on a Graphics object to display an image in a GUI component. 



ImageObserver specifies a GUI component for receiving notifications of image informa- 
tion as the image is constructed. To draw images using the drawlmage method in a Swing 
component, such as JPanel, override the paintComponent method to tell the component 
how to display the image in the panel. 

Listing 15.11 gives the code that displays an image from i mage/us. gif. The file 
image/us. gif (line 20) is under the class directory. An Image object is obtained in line 
21. The drawlmage method displays the image to fill in the whole panel, as shown in 
Figure 15.24. 




Figure 1 5.24 An image is displayed in a panel. 



Listing 15. II Display-Image, java 

1 import java. awt.'-; 

2 import javax. swing.*; 
3 

4 public class Di spl aylmage extends JFrame { 

5 public Di spl aylmage() { 

6 add(new ImagePanel ()) ; add panel 

7 } 
8 

9 public static void main(String[] args) { 

10 JFrame frame = new Di spl aylmageO ; 

11 frame. setTitle("Di spl aylmage") ; 

12 frame. setSize (300, 300); 

13 frame. setLocationRelati veTo(null) ; // Center the frame 

14 frame . setDef aul tCl oseOpe rati on (3 Frame . EXIT_0N„CL0SE) ; 
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15 frame.setVisible(true) ; 

16 } 

17 } 
18 

19 class ImagePanel extends J Panel { 

20 private Imagelcon imagelcon = new Imagelcon ("image/us. gif") ; 

21 private Image image = imagelcon. getlmageO ; 
22 

23 /** Draw image on the panel */ 

24 protected void pai ntComponent(Graphi cs g) { 

25 super . pai ntComponent(g) ; 
26 

27 if (image != null) 

28 g.drawlmage (image, 0, 0, getwidthO, getHeight(), this); 

29 } 

30 } 

15.12 Case Study: The ImageViewer Class 

Displaying an image is a common task in Java programming. This case study develops a 
reusable component named ImageViewer that displays an image on a panel. The class con- 
tains the properties image, stretched, xCoordinate, and yCoordinate, with associated 
accessor and mutator methods, as shown in Figure 15.25. 
stretchable image You can use images in Swing components such as J Label and JButton, but these images 

are not stretchable. The image in an ImageViewer can be stretched. 

Let us write a test program in Listing 15.12 that displays six images using the 
ImageViewer class. Figure 15.26 shows a sample run of the program. 



panel class 
create image icon 
get image 



override paintComponent 



draw image 



j avax . swi ng . J Panel 
S 



ImageViewer 



-image: Image 
-stretched: boolean 
-xCoordinate: int 
-yCoordinate: int 



+ImageViewer() 

+ImageVi ewer (image: Image) 



The get and set methods for these 
data fields are provided in the class, but 
omitted in the UML diagram for brevity. 



Image in the image viewer. 

True if the image is stretched in the viewer. 

x-coordinate of the upper-left corner of the image in the viewer. 

y-coordinate of the upper-left corner of the image in the viewer. 

Constructs an image viewer with no image. 
Constructs an image viewer with the specified image. 



Figure 15.25 The ImageViewer class displays an image on a panel. 




Figure 15.26 Six images are displayed in six ImageViewer components. 
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Listing 15.12 SixFlags. java 

1 import javax. swing.*; 

2 import java.awt.*; 

3 

4 public class SixFlags extends JFrame { 

5 public SixFlagsO { 

6 Image imagel = new ImageIcon("image/us.gif") .getlmageO ; createimage 

7 Image image2 = new ImageIcon("image/ca.gif") .getlmageO I 

8 Image image3 = new ImageIcon("image/india.gif") .getlmageO ; 

9 Image image4 = new ImageIcon("image/uk.gif") .getlmageO I 

10 Image image5 = new ImageIcon("image/china.gif") .getlmageO ; 

11 Image image6 = new Imagelcon("image/norway.gif") .getlmageO ; 
12 

13 setLayout(new Gri dLayout(2 , 0, 5, 5)); 

14 add(new ImageVi ewe r (i magel) ) ; create image viewer 

15 add(new ImageVi ewe rO'mage2)) I 

16 add (new ImageVi ewe r (i mage3) ) ; 

17 add (new ImageVi ewe r (i mage4) ) ; 

18 add(new ImageVi ewe r(image5)) ; 

19 add (new ImageVi ewe r (i mage6) ) ; 

20 } 
21 

22 public static void main(String[] args) { 

23 SixFlags frame = new SixFlagsO; 

24 frame. setTitle("SixFlags") ; 
2 5 frame. setSize (400, 320); 

26 frame. setLocationRelativeTo(null) ; // Center the frame 

27 frame . setDef aul tCl oseOperati on (3 Frame . EXIT_0N_CL0SE) ; 

28 frame.setVisible(true) ; 

29 } 

30 } 



The ImageViewer class is implemented in Listing 15.13. {Note: You may skip the implementation 
implementation.) The accessor and mutator methods for the properties image, stretched, skip implementation? 
xCoordinate, and yCoordinate are easy to implement. The paintComponent method 
(lines 26-35) displays the image on the panel. Line 29 ensures that the image is not nul 1 
before displaying it. Line 30 checks whether the image is stretched or not. 



Listing 15.13 ImageViewer. java 

1 import java.awt.'-; 

2 import javax. swing.*; 
3 

4 public class ImageViewer extends 3 Panel { 

5 /** Hold value of property image. */ 

6 private java.awt. Image image; properties 
7 

8 /** Hold value of property stretched. */ 

9 private boolean stretched = true; 
10 

11 /** Hold value of property xCoordinate. */ 

12 private int xCoordinate; 
13 

14 /** Hold value of property yCoordinate. */ 

15 private int yCoordinate; 
16 
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constructor 



constructor 



image null? 
stretched 

nonstretched 



17 
18 
19 
20 
21 
22 
23 
24 
25 
26 
27 
28 
29 
30 
31 
32 
33 
34 
35 
36 
37 
38 
39 
40 
41 
42 
43 
44 
45 
46 
47 
48 
49 
50 
51 
52 
53 
54 
55 
56 
57 
58 
59 
60 
61 
62 
63 
64 
65 
66 
67 
68 
69 
70 
71 
72 
73 
74 
75 



/** Construct an empty image viewer 

public ImageVi ewerO { 

} 



V 



a specified Image object */ 



/** Construct an image viewer for 
public ImageVi ewer (Image image) { 
this. image = image; 

} 



protected void pai ntComponent(Graphi cs g) { 
super . pai ntComponent(g) ; 

if (image != null) 
if (isStretchedO) 

g.drawlmage(image, xCoordinate, yCoordinate, 
getWidthO, getHeightO, this); 

el se 

g.drawlmage(image, xCoordinate, yCoordinate, this); 



} 



/** Return value of property image */ 
public java. awt . Image getlmage() { 
return image; 

} 

/** Set a new value for property image */ 
public void setlmage(java. awt. Image image) { 

this. image = image; 

repai nt() ; 

} 

/** Return value of property stretched * / 
public boolean isStretchedO { 
return stretched; 

} 

/** Set a new value for property stretched */ 
public void setSt retched (boolean stretched) { 

this . stretched = stretched; 

repai nt() ; 

} 

/** Return value of property xCoordinate */ 
public int getXCoordi nate() { 
return xCoordinate; 

} 

/** Set a new value for property xCoordinate */ 
public void setXCoordi nate(int xCoordinate) { 

this . xCoordi nate = xCoordinate; 

repai nt() ; 

} 

/** Return value of property yCoordinate */ 
public int getYCoordi nate() { 
return yCoordinate; 

} 

/** Set a new value for property yCoordinate */ 



Review Questions 525 



76 public void setYCoordi nate(int yCoordi nate) { 

77 this . yCoordi nate = yCoordinate; 

78 repaintO; 

79 } 

80 } 

Chapter Summary 



1 . Each component has its own coordinate system with the origin (0 , 0) at the upper-left 
corner of the window. The x-coordinate increases to the right, and the y-coordinate 
increases downward. 

2. The Graphics class is an abstract class for displaying figures and images on the 
screen on different platforms. The Graphics class is implemented on the native plat- 
form in the JVM. When you use the paintComponent(g) method to paint on a GUI 
component, this g is an instance of a concrete subclass of the abstract Graphics class 
for the specific platform. The Graphics class encapsulates the platform details and 
enables you to draw things uniformly without concern for the specific platform. 

3. Invoking super . paintComponent(g) is necessary to ensure that the viewing area 
is cleared before a new drawing is displayed. The user can request the component to 
be redisplayed by invoking the repaint () method defined in the Component class. 
Invoking repaint () causes paintComponent to be invoked by the JVM. The user 
should never invoke paintComponent directly. For this reason, the protected visibil- 
ity is sufficient for paintComponent. 

4. Normally you use JPanel as a canvas. To draw on a JPanel , you create a new class 
that extends JPanel and overrides the paintComponent method to tell the panel 
how to draw things. 

5. You can set fonts for the components or subjects you draw, and use font metrics to 
measure font size. Fonts and font metrics are encapsulated in the classes Font and 
FontMetrics. FontMetrics can be used to compute the exact length and width of 
a string, which is helpful for measuring the size of a string in order to display it in the 
right position. 

6. The Component class has the setBackground, setForeground, and setFont 

methods. These methods are used to set colors and fonts for the entire component. 
Suppose you want to draw several messages in a panel with different colors and fonts; 
you have to use the setColor and setFont methods in the Graphics class to set 
the color and font for the current drawing. 

7. To display an image, first create an image icon. You can then use Imagelcon's 
getlmageO method to get an Image object for the image and draw the image using 
the drawlmage method in the java.awt .Graphics class. 

Review Questions 

Sections 15.2-15.3 

15.1 Suppose that you want to draw a new message below an existing message. Should 
the x-coordinate, y- coordinate, or both increase or decrease? 

1 5.2 Why is the Graphics class abstract? How is a Graphics object created? 

15.3 Describe the paintComponent method. Where is it defined? How is it invoked? 
Can it be directly invoked? How can a program cause this method to be invoked? 
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1 5.4 Why is the pan ntComponent method protected? What happens if you change 
it to public or private in a subclass? Why is super . pai ntComponent (g) 

invoked in line 21 in Listing 15.1 and in line 31 in Listing 15.3? 

1 5.5 Can you draw things on any Swing GUI component? Why should you use a panel 
as a canvas for drawings rather than a label or a button? 

Sections 15.4-15.7 

15.6 Describe the methods for drawing strings, lines, rectangles, round-cornered rec- 
tangles, 3D rectangles, ovals, arcs, polygons, and polylines. 

15.7 Describe the methods for filling rectangles, round-cornered rectangle, ovals, arcs, 
and polygons. 

1 5.8 How do you get and set colors and fonts in a Graphics object? 

1 5.9 Write a statement to draw the following shapes: 

■ Draw a thick line from (10, 10) to (70, 30). You can draw several lines next to 
each other to create the effect of one thick line. 

■ Draw/fill a rectangle of width 100 and height 50 with the upper-left corner at 
(10, 10). 

■ Draw/fill a round-cornered rectangle with width 100, height 200, corner hori- 
zontal diameter 40, and corner vertical diameter 20. 

■ Draw/fill a circle with radius 30. 

■ Draw/fill an oval with width 50 and height 100. 

■ Draw the upper half of a circle with radius 50. 

■ Draw/fill a polygon connecting the following points: (20, 40), (30, 50), (40, 
90), (90, 10), (10, 30). 

Sections 15.8-15.10 

15.10 How do you find the leading, ascent, descent, and height of a font? How do you 
find the exact length in pixels of a string in a Graphics object? 

15.1 I If message is not initialized in line 8 in Listing 15.8, MessagePanel.java, what 
will happen when you create a MessagePanel using its no-arg constructor? 

15.12 The following program is supposed to display a message on a panel, but nothing is 
displayed. There are problems in lines 2 and 14. Correct them. 

1 public class TestDrawMessage extends javax . swi ng .] Frame { 

2 public void TestDrawMessageO { 

3 add(new DrawMessageO) ; 

4 } 
5 

6 public static void mai n(Stri ng [] args) { 

7 javax. swing. JFrame frame = new TestDrawMessageO; 

8 frame. setSize(100, 200); 

9 frame . setVi si bl e(true) ; 

10 } 

11 } 
12 

13 class DrawMessage extends javax. swing. J Panel { 

14 protected void Pai ntComponent (java.awt. Graphics g) { 

15 super. pai ntComponent(g) ; 

16 g.drawSt ring ("Wei come to Java", 20, 20); 

17 } " 

18 } 

Sections 15.1 1-15.12 

15.13 How do you create an Image object from the Imagelcon object? 
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15.14 How do you create an Imagelcon object from an Image object? 

15.15 Describe the drawlmage method in the Graphics class. 

15.16 Explain the differences between displaying images in a J Label and in a J Panel . 

15.17 Which package contains Imagelcon, and which contains Image? 

Programming Exercises 

Sections 15.2-15.7 

15.1* (Displaying a 3 X 3 grid) Write a program that displays a 3 X 3 grid, as shown in 
Figure 15.27(a). Use red color for vertical lines and blue for horizontals. 





EE -M*l 





















(a) 



(b) 




Figure 15.27 (a) Exercise 15.1 displays a grid, (b) Exercise 15.2 displays two objects of 
Oval Button, (c) Exercise 15.3 displays a checkerboard. 

1 5.2** {Creating a custom button class) Develop a custom button class named 
Oval Button that extends JButton and displays the button text inside an oval. 
Figure 15.27(b) shows two buttons created using the Oval Button class. 

{Displaying a checkerboard) Exercise 12.10 displays a checkerboard in which 
each white and black cell is a JButton. Rewrite a program that draws a checker- 
board on a JPanel using the drawing methods in the Graphics class, as shown 
in Figure 15.27(c). 

{Displaying a multiplication table) Write a program that displays a multiplication 
table in a panel using the drawing methods, as shown in Figure 15.28(a). 
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4 8 12 16 20 24 28 32 36 
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6 


6 1218 24 30 36 42 48 64 
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7 14 21 28 35 42 49 56 63 
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8 16 24 32 40 48 56 64 72 
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9 18 27 3S 45 54 63 72 81 
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(b) 



Figure 15.28 (a) Exercise 15.4 displays a multiplication table, (b) Exercise 15.5 displays 
numbers in a triangle formation. 

1 5.5** {Displaying numbers in a triangular pattern) Write a program that displays num- 
bers in a triangular pattern, as shown in Figure 15.28(b). The number of lines in 
the display changes to fit the window as the window resizes. 

1 5 .6** {Improving FigurePanel) The FigurePanel class in Listing 15.3 can display 
lines, rectangles, round-cornered rectangles, and ovals. Add appropriate new code 
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in the class to display arcs and polygons. Write a test program to display the 
shapes as shown in Figure 15.29(a) using the new FigurePanel class. 




(a) 



MJj<J 



X o 



XXX 




(b) 



(0 



Figure 1 5.29 (a) Four panels of geometric figures are displayed in a frame of 

Grid Layout, (b) TicTacToe cells randomly display X, O, or nothing, (c) Exercise 15. 

draws an octagon. 



15.7** (Displaying a TicTacToe board) Create a custom panel that displays X, 0, or 
nothing. What to display is randomly decided whenever a panel is repainted. 
Use the Math . randomO method to generate an integer 0, 1, or 2, which corre- 
sponds to displaying X, 0, or nothing. Create a frame that contains nine custom 
panels, as shown in Figure 15.29(b). 

15.8** (Drawing an octagon) Write a program that draws an octagon, as shown in 
Figure 15.29(c). 

15.9* (Creating four fans) Write a program that places four fans in a frame of 
GridLayout with two rows and two columns, as shown in Figure 15.30(a). 
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Figure 15.30 (a) Exercise 15.9 draws four fans, (b) Exercise 15.10 draws a cylinder, (c) 
Exercise 15.1 1 draws a diagram for function f(x) = x 2 . 



15.10* (Displaying a cylinder) Write a program that draws a cylinder, as shown in 
Figure 15.30(b). 

15.1 I** (Plotting the square function) Write a program that draws a diagram for the 
function f(x) = x 2 (see Figure 15.30(c)). 

Hint: Add points to a polygon p using the following loop: 

double scaleFactor = 0.1; 

for (int x = -100; x <= 100; x++) { 

p.addPoint(x + 200, 200 - (int) (scaleFactor * x * x)); 

} 
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Connect the points using g.drawPolyl ine(p.xpoints, p.ypoints, p.npoints) 
for a Graphics object g. p.xpoints returns an array of x-coordinates, p.ypoints an 
array of y-coordinates, and p.npoints the number of points in Polygon object p. 

1 5.1 2** (Plotting the sine function) Write a program that draws a diagram for the sine 
function, as shown in Figure 15.31(a). 




Figure 15.31 (a) Exercise 15.12 draws a diagram for function f(x)= sin(x). (b) Exercise 
15.13 draws the sine and cosine functions. 



Video Note 

Plot a sine function 



Hint: The Unicode for tt is \u03c0. To display — 2tt, use g.drawString 
C"-2\u03cO", x, y). For a trigonometric function like sin(x), x is in radians. 
Use the following loop to add the points to a polygon p: 

for (int x = -100; x <= 100; x++) { 
p.addPoint(x + 200, 

100 - (int)(50 * Math.sin((x / 100.0) * 2 * Math. PI))); 

} 

-277- is at (100, 100), the center of the axis is at (200, 100), and 2tt is at (300, 100). 
Use the drawPolyl ine method in the Graphics class to connect the points. 

1 5. 13** (Plotting functions using abstract methods) Write an abstract class that draws 
the diagram for a function. The class is defined as follows: 

public abstract class AbstractDrawFuncti on extends DPanel { 

/** Polygon to hold the points */ 
private Polygon p = new PolygonQ; 



protected AbstractDrawFuncti on () { 
drawFunctionO ; 

} 

/** Return the y-coordinate */ 
abstract double f (double x) ; 



/** Obtain points for x-coordinates 100, 101, 300 */ 

public void drawFunctionO { 

for (int x = -100; x <= 100; x++) { 
p.addPoint(x + 200, 200 - (int)f(x)); 

} 

} 

/** Implement pai ntComponent to draw axes, labels, and 
* connecting points 

V 

protected void pai ntComponent(Craphi cs g) { 

// To be completed by you 

} 
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Test the class with the following functions: 

f(x) = x 2 ; 

f (x) = si n(x) ; 

f (x) = cos(x) ; 

f (x) = tan(x) ; 

f(x) = cos(x) + 5sin(x); 

f(x) = 5cos(x) + sin(x); 

f(x) = log(x) + x 2 ; 



For each function, create a class that extends the AbstractDrawFunction 
class and implements the f method. Figure 15.31(b) displays the drawings for 
the sine function and the cosine function. 

15.1 4** (Displaying a bar chart) Write a program that uses a bar chart to display the per- 
centages of the overall grade represented by projects, quizzes, midterm exams, 
and the final exam, as shown in Figure 15.1(a). Suppose that projects take 
20 percent and are displayed in red, quizzes take 10 percent and are displayed 
in blue, midterm exams take 30 percent and are displayed in green, and the final 
exam takes 40 percent and is displayed in orange. 

15.15** (Displaying a pie chart) Write a program that uses a pie chart to display the per- 
centages of the overall grade represented by projects, quizzes, midterm exam, 
and the final exam, as shown in Figure 15.32(a). Suppose that projects take 
20 percent and are displayed in red, quizzes take 10 percent and are displayed in 
blue, midterm exam takes 30 percent and are displayed in green, and the final 
exam takes 40 percent and is displayed in orange. 

15.16 (Obtaining font information) Write a program that displays the message "Java is 
fun" in a panel. Set the panel's font to TimesRoman, bold, and 20 pixel. Dis- 
play the font's leading, ascent, descent, height, and the string width as a tool tip 
text for the panel, as shown in Figure 15.32(b). 




(a) (b) (c) 



Figure 15.32 (a) Exercise 15.15 uses a pie chart to show the percentages of projects, 
quizzes, midterm exam, and final exam in the overall grade, (b) Exercise 15.16 displays font 
properties in a tool tip text, (c) Exercise 15.17 draws a sketch for the hangman game. 



15.17 (Game: hangman) Write a program that displays a drawing for the popular hang- 
man game, as shown in Figure 15.32(c). 

15.18 (Using the StillClock class) Write a program that displays two clocks. The 
hour, minute, and second values are 4, 20, 45 for the first clock and 22, 46, 15 for 
the second clock, as shown in Figure 15.33(a). 
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Figure 15.33 (a) Exercise 15.18 displays two clocks, (b) Exercise 15.19 displays a clock with 
random hour and minute values, (c) Exercise 15.23 displays a rectanguloid. (d) Exercise 15.24 
simulates a bean machine. 



15.19* (Random time) Modify the Sti 11 Cl ock class with three new Boolean properties — 
hourHandVisible, nrinuteHandVisible, and secondHandVisible — and 

their associated accessor and mutator methods. You can use the set methods to 
make a hand visible or invisible. Write a test program that displays only the hour 
and minute hands. The hour and minute values are randomly generated. The hour is 
between and 11, and the minute is either or 30, as shown in Figure 15.33(b). 

1 5.20** (Drawing a detailed clock) Modify the StillClock class in §15.12, "Case 
Study: The StillClock Class," to draw the clock with more details on the 
hours and minutes, as shown in Figure 15.1(b). 

1 5 .2 1 ** (Displaying a TicTacToe board with images) Rewrite Exercise 12.7 to display an 
image in a 3 Panel instead of displaying an image icon in a J Label . 

1 5.22** (Displaying a STOP sign) Write a program that displays a STOP sign, as shown 
in Figure 15.1(c). The hexagon is in red and the sign is in white. 

(Hint: See Listing 15.5, DrawPolygon.java, and Listing 15.6, TestCenterMes- 
sage.java.) 

15.23 (Displaying a rectanguloid) Write a program that displays a rectanguloid, as 
shown in Figure 15.33(c). The cube should grow and shrink as the frame grows 
or shrinks. 

1 5.24** (Game: bean machine) Write a program that displays a bean machine intro- 
duced in Exercise 6.21. The bean machine should be centered in a resizable 
panel, as shown in Figure 15.33(d). 

\S. IS** (Geometry: displaying an n-sided regular polygon) Create a subclass of 
JPanel, named RegularPolygonPanel, to paint an «-sided regular poly- 
gon. The class contains a property named numberOf Sides, which specifies 
the number of sides in the polygon. The polygon is centered at the center of 
the panel. The size of the polygon is proportional to the size of the panel. 
Create a pentagon, hexagon, heptagon, and octagon, nonagon, and decagon 
from RegularPolygonPanel and display them in a frame, as shown in 
Figure 15.34(a). 

1 5.26 (Using the MessagePanel class) Write a program that displays four messages, 
as shown in Figure 15.34(b). 

15.27** (Displaying a graph) A graph consists of vertices and edges that connect ver- 
tices. Write a program that reads a graph from a file and displays it on a panel. 
The first line in the file contains a number that indicates the number of vertices 
(n). The vertices are labeled as 0, 1, . . . , n-1. Each subsequent line, with the 
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(b) 



Figure 15.34 (a) Exercise 15.25 displays several n-sided polygons, (b) Exercise 15.26 uses 
MessagePanel to display four strings. 



format u x y vl , v2 , . . . , describes that the vertex u is located at position (x, y) 
with edges (u, vl), (u, v2), etc. Figure 15.35(a) gives an example of the file for a 
graph. Your program prompts the user to enter the name of the file, reads data 
from the file, and displays the graph on a panel, as shown in Figure 15.35(b). 



File 
6 

30 30 1 2 

1 90 30 3 

2 30 90 3 4 

3 90 90 1 2 4 5 

4 30 150 2 3 5 

5 90 150 3 4 



(a) (b) (c) 

Figure 15.35 (a)-(b) The program reads the information about the graph and displays it visually, 
(c) The program displays an arrow line. 




1 



3 2 




1 5 .28** (Drawing an arrow line) Write a static method that draws an arrow line from a 
starting point to an ending point using the following method header: 

public static void drawArrowLi ne(int xl, int yl, 
int x2 , int y2 , Graphics g) 

Write a test program that randomly draws an arrow line when the Draw Random 
Arrow Line button is clicked, as shown in Figure 15.35(c). 



Chapter 16 



Event-Driven Programming 

Objectives 

■ To describe events, event sources, and event classes (§16.2). 

■ To define listener classes, register listener objects with the source object, 
and write the code to handle events (§16.3). 

■ To define listener classes using inner classes (§16.4). 

■ To define listener classes using anonymous inner classes (§16.5). 

■ To explore various coding styles for creating and registering 
listeners (§16.6). 

■ To get input from text field upon clicking a button (§ 16.7). 

■ To write programs to deal with Wi ndowEvent (§16.8). 

■ To simplify coding for listener classes using listener 
interface adapters (§16.9). 

■ To write programs to deal with MouseEvent (§16.10). 

■ To write programs to deal with KeyEvent (§ 16. 1 1). 

■ To use the j avax . swi ng . Ti mer class to control 
animations (§16.12). 
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16.1 Introduction 



problem 



Suppose you wish to write a GUI program that lets the user enter the loan amount, annual inter- 
est rate, and number of years and click the Compute Loan button to obtain the monthly payment 
and total payment, as shown in Figure 16.1(a). How do you accomplish the task? You have to 
use event-driven programming to write the code to respond to the button-clicking event. 
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(a) (b) (c) 

Figure 16.1 (a) The program computes loan payments, (b)-(d) A flag is rising upward. 



(d) 



Suppose you wish to write a program that animates a rising flag, as shown in Figure 
problem 16.1(b)-(d). How do you accomplish the task? There are several ways to solve this problem. 

An effective one is to use a timer in event-driven programming, which is the subject of this 
chapter. 

In event-driven programming, code is executed when an event occurs (e.g., a button click, 
a mouse movement, or a timer). §14.6, "Example: The ActionListener Interface," gave 
you a taste of event-driven programming. You probably have many questions, such as why a 
listener class is defined to implement the ActionLi stener interface. This chapter will give 
you all the answers. 



event 



fire event 
source object 



1 6.2 Event and Event Source 

When you run a Java GUI program, the program interacts with the user, and the events drive 
its execution. An event can be defined as a signal to the program that something has hap- 
pened. Events are triggered either by external user actions, such as mouse movements, button 
clicks, and keystrokes, or by internal program activities, such as a timer. The program can 
choose to respond to or ignore an event. 

The component that creates an event and fires it is called the source object or source compo- 
nent. For example, a button is the source object for a button-clicking action event. An event is an 
instance of an event class. The root class of the event classes is java.util . EventObject. 
The hierarchical relationships of some event classes are shown in Figure 16.2. 



ActionEvent | 
AdjustmentEvent | 



EventObject | <] — r— AWTEvent | <3 ComponentEvent | <] InputEvent | <1 



ItemEvent 



TextEvent | 
- Li stSel ecti onEvent | 
' ChangeEvent | 

Figure 1 6.2 An event is an object of the EventObject class. 



Contai nerEvent | 
FocusEvent | i — Mouss 



Pan ntEvent 



Wi ndowEvent 



— KeyEvent | 
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An event object contains whatever properties are pertinent to the event. You can identify 
the source object of an event using the getSourceO instance method in the EventObject 
class. The subclasses of EventObject deal with special types of events, such as action 
events, window events, component events, mouse events, and key events. Table 16.1 lists 
external user actions, source objects, and event types fired. 



getSourceO 



Table 16.1 User Action, Source Object, and Event Type 



User Action 



Source Object 



Event Type Fired 



Click a button JButton 

Press return on a text field JTextFi el d 

Select a new item XomboBox 

Select item(s) J Li st 

Click a check box JCheckBox 

Click a radio button JRadioButton 

Select a menu item JMenuItem 

Move the scroll bar JScrol 1 Bar 

Move the scroll bar JS1 i der 

Window opened, closed, iconified, Wi ndow 

deiconified, or closing 

Mouse pressed, released, clicked, Component 

entered, or exited 

Mouse moved or dragged Component 

Key released or pressed Component 

Component added or removed from Contai ner 
the container 

Component moved, resized, Component 

hidden, or shown 

Component gained or lost focus Component 



ActionEvent 
ActionEvent 
ItemEvent, ActionEvent 
ListSel ectionEvent 
ItemEvent, ActionEvent 
ItemEvent, ActionEvent 
ActionEvent 
Adjustment Event 
ChangeEvent 
WindowEvent 

MouseEvent 

MouseEvent 
KeyEvent 
Contai nerEvent 

Component Event 

FocusEvent 



||| Note 

[f a component can fire an event, any subclass of the component can fire the same type of event. 
For example, every GUI component can fire MouseEvent, KeyEvent, FocusEvent, and 
ComponentEvent, since Component is the superclass of all GUI components. 

|p Note 

All the event classes in Figure 16.2 are included in the java.awt. event package except 
ListSel ectionEvent and ChangeEvent, which are in the javax. swing, event pack- 
age. AWT events were originally designed for AWT components, but many Swing components 
fire them. 

16.3 Listeners, Registrations, and Handling Events 

Java uses a delegation-based model for event handling: a source object fires an event, and 

an object interested in the event handles it. The latter object is called a listener. For an listener 

object to be a listener for an event on a source object, two things are needed, as shown in ActionEvent/ActionListener 

Figure 16.3. 
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Trigger an event 


source: Source-Class 




+addXLi stener (1 i stener : XLi stener) 



(2) Register by invoking 

source. addXLi stener(l i stener) ; 



(1) A listener object is an 

instance of a listener interface 




listener: Li stenerCl ass 



(a) A generic source component with a generic listener 
source: javax.swing.JButton 



+addActionl_i stener (1 i stener: Action Li stener) 



«interface» 
java. awt. event. ActionListener 



(2) Register by invoking 

source . add/ActfonLi stener (1 i stener) f 



+actionPerformed(event: ActionEvent) 
^ 



(1) An action event listener is an listener: CustomLi stenerCl ass 
instance of Action Li stener 



(b) A J Button source component with an Action Li stener 
Figure 16.3 A listener must be an instance of a listener interface and must be registered with a source component. 



listener interface 
XLi stener/XEvent 



handler 



register listener 



create source object 
create listener object 

register listener 



1. The listener object must be an instance of the corresponding event-listener interface to 
ensure that the listener has the correct method for processing the event. Java provides a 
listener interface for every type of event. The listener interface is usually named 
XLi stener forXEvent, with the exception of MouseMotionLi stener. For example, the 
corresponding listener interface for ActionEvent is ActionListener; each listener for 
ActionEvent should implement the ActionListener interface. Table 16.2 lists event 
types, the corresponding listener interfaces, and the methods defined in the listener inter- 
faces. The listener interface contains the method(s), known as the handler(s), for processing 
the event. 

2. The listener object must be registered by the source object. Registration methods 
depend on the event type. For ActionEvent, the method is addActionLi stener. In 
general, the method is named addXLi stener for XEvent. A source object may fire 
several types of events. It maintains, for each event, a list of registered listeners and 
notifies them by invoking the handler of the listener object to respond to the event, as 
shown in Figure 16.4. (Figure 16.4 shows the internal implementation of a source class. 
You don't have to know how a source class such as JButton is implemented in order to 
use it. Nevertheless, this knowledge will help you to understand the Java event-driven 
programming framework). 

Let's revisit Listing 14.8, HandleEvent.java. Since a JButton object fires ActionEvent, a 
listener object for ActionEvent must be an instance of ActionListener, so the listener 
class implements ActionListener in line 34. The source object invokes addActionLi s- 
tener(l i stener) to register a listener, as follows: 

J Button jbtOK = new J Button ("OK") ; // Line 7 in Listing 14.8 
ActionListener listenerl 

= new OKLi stenerCl ass () ; // Line 18 in Listing 14.8 
jbtOK.addActionListener(Iistenerl) ; // Line 20 in Listing 14.8 



When you click the button, the JButton object fires an ActionEvent and passes it to invoke 
the listener's actionPerformed method to handle the event. 
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Table 16.2 Events, Event Listeners, and Listener Methods 



Event Class 
(Handlers) 



ActionEvent 

ItemEvent 

MouseEvent 



KeyEvent 



Wi ndowEvent 



ContainerEvent 



Listener Interface 



Listener Methods 



ActionListener 

ItemListener 

MouseListener 



MouseMotionListener 



Key Listener 



WindowListener 



Container Listener 



ComponentEvent ComponentListener 



FocusEvent 

AdjustmentEvent 

ChangeEvent 

Li stSel ectionEvent 



FocusListener 

Adjustment Listener 

ChangeListener 

Li stSel ectionLi stener 



act ionPer formed (ActionEvent) 
i temStateChanged (ItemEvent) 
mousePressed (MouseEvent) 
mouseRel eased (MouseEvent) 
mouseEntered (MouseEvent) 
mouseExi ted (MouseEvent) 
moused i eked (MouseEvent) 
mouseDragged (MouseEvent) 
mouseMoved (MouseEvent) 
keyPressed (KeyEvent) 
keyRel eased (KeyEvent) 
keyTyped (KeyEvent) 
wi ndowCl osi ng (Wi ndowEven t ) 
wi ndowOpened (Wi ndowEven t) 
wi ndowlconi f i ed (Wi ndowEvent) 
wi ndowDei coni f i ed (Wi ndowEvent) 
wi ndowCl osed (Wi ndowEvent) 
wi ndowAct i vated (Wi ndowEvent) 
wi ndowDeacti vated (Wi ndowEvent) 
component Added (Contai nerEvent) 
componentRemoved (ContainerEvent) 
componen tMoved (ComponentEvent) 
componentHi dden (ComponentEvent) 
componentResi zed (ComponentEvent) 
componentShown (ComponentEvent) 
focusCained (FocusEvent) 
focusLost (FocusEvent) 

ad justmentValueChanged (AdjustmentEvent) 

stateChanged (ChangeEvent) 

val ueChanged(Li stSel ectionEvent) 



The event object contains information pertinent to the event, which can be obtained using 
the methods, as shown in Figure 16.5. For example, you can use e . getSourceO to obtain 
the source object in order to determine whether it is a button, a check box, or a radio button. 
For an action event, you can use e . getWhen () to obtain the time when the event occurs. 
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source: Source-Class 



+addXLi stener(XLi stener listener) 

An event is 
triggered 



. Store in a list 



event: XEvent 




1 i stenerl 
1 i stener2 

1 i stenern 


Invoke 

li stenerl. handler (event) 
li stener2 . handler (event) 





1 i stenern. handler (event) 



(a) Internal function of a generic source object 



source: javax.swingJButton 



+add/\ct7onl_i stener(/4ct7'onl_i stener 1 i stener) 

An event is 
triggered 



„ Store in a list 



event: 

/4ct7'onEvent 




1 i stenerl 
1 i stener2 

1 i stenern 


Invoke 

1 i stenerl. action Performed (event) 
1 i stener2 . acti on Performed (event) 





1 i stenern. acti on Performed (event) 



(b) Internal function of a J Button object 

Figure 1 6.4 The source object notifies the listeners of the event by invoking the handler of 
the listener object. 



java.util.EventObject 



i-getSource() : Object 

T 

java.awt. event. AWTEvent 

T 

java.awt.event.ActionEvent 



+getActionCommand() : String 

+getModi fi ers() : int 
+getWhen(): long 



Returns the source object for the event. 



Returns the command string associated with this action. For a 
button, its text is the command string. 

Returns the modifier keys held down during this action event. 

Returns the timestamp when this event occurred. The time is the 
number of milliseconds since January 1, 1970, 00:00:00 GMT. 



Figure 16.5 You can obtain useful information from an event object. 



We now write a program that uses two buttons to control the size of a circle, as shown in 
Figure 16.6. 

first version We will develop this program incrementally. First we write a program in Listing 16.1 that 

displays the user interface with a circle in the center (line 14) and two buttons in the bottom 
(line 15). 
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Figure 1 6.6 The user clicks the Enlarge and Shrink buttons to enlarge and shrink the size 
of the circle. 



Listing 1 6. 1 ControlCi rclel. java 



import javax. swi ng . * ; 
import java.awt.*; 

public class ControlCi rclel extends JFrame { 

private JButton jbtEnlarge = new JButton("Enlarge") ; 
private JButton jbtShrink = new JButton("Shrink") ; 
private CirclePanel canvas = new Ci rclePanel () ; 

public ControlCi rclelO { 

JPanel panel = new JPanel (); // Use the panel to group buttons 
panel .add(jbtEnlarge) ; 
panel . add( jbtShri nk) ; 

this . add(canvas , BorderLayout . CENTER) ; // Add canvas to center 
this . add(panel , BorderLayout . SOUTH) ; // Add buttons to the frame 

} 

/** Main method */ 

public static void main(String[] args) { 
JFrame frame = new Control Ci rcl el() ; 
frame . setTi tl e ("Control Ci rcl el") ; 

frame. setLocationRelativeTo(null) ; // Center the frame 
frame . setDef aul tCl oseOperati on (J Frame . EXIT„ON_CLOSE) ; 
frame.setSize(200, 200); 
frame . setVi si bl e(true) ; 

} 



buttons 
circle canvas 



30 
31 
32 
33 
34 
35 
36 
37 
38 



private int radius =5; // Default circle radius 
/** Repaint the circle */ 

protected void pai ntComponent(Graphi cs g) { 
super . pai ntComponent(g) ; 

g.drawOval (getWidth() / 2 - radius, getHeight() / 2 - radius, 
2 * radius, 2 * radius); 

} 



CirclePanel class 



paint the circle 



How do you use the buttons to enlarge or shrink the circle? When the Enlarge button is clicked, second version 
you want the circle to be repainted with a larger radius. How can you accomplish this? You can 
expand the program in Listing 16.1 into Listing 16.2 with the following features: 

1. Define a listener class named EnlargeListener that implements ActionListener 

(lines 31-35). 



2. Create a listener and register it with jbtEnl arge (line 18). 



540 Chapter 16 Event-Driven Programming 



3. Add a method named enl argeO in Ci rcl ePanel to increase the radius, then repaint 
the panel (lines 41-44). 

4. Implement the actionPer formed method in Enl argeListener to invoke 
canvas. enl arge() (line 33). 

5. To make the reference variable canvas accessible from the actionPerformed 
method, define Enl argeListener as an inner class of the Control Ci rcl e2 class 
(lines 31-35). Inner classes are defined inside another class. We will introduce inner 
classes in the next section. 

6. To avoid compile errors, the Ci rcl ePanel class (lines 37-52) now is also defined as 
an inner class in Control Ci rcl e2, since an old Ci rcl ePanel class is already defined 
in Listing 16.1. 



Listing 16.2 ControlCi rcle2. java 



Video Note 

Listener and its registration 



create/register listener 



listener class 



Ci rcl ePanel class 



enlarge method 



1 
2 
3 
4 
5 
6 
7 
8 
9 
10 
11 
12 
13 
14 
15 
16 
17 
18 
19 
20 
21 
22 
23 
24 
25 
26 
27 
28 
29 
30 
31 
32 
33 
34 
35 
36 
37 
38 
39 
40 
41 
42 



import javax. swi ng . * ; 
import java.awt.*; 
import java. awt . event .* ; 

public class Control Ci rcl e2 extends JFrame { 

private JButton jbtEnlarge = new JButton("Enlarge") ; 
private JButton jbtShrink = new JButton("Shrink") ; 
private Ci rcl ePanel canvas = new Ci rcl ePanel () ; 

public ControlCi rcle2() { 

JPanel panel = new JPanel (); // Use the panel to group buttons 
panel .add(jbtEnlarge) ; 
panel . add( jbtShri nk) ; 

this . add(canvas , BorderLayout . CENTER) ; // Add canvas to center 
this . add(panel , BorderLayout . SOUTH) ; // Add buttons to the frame 

jbtEnl arge . addActionLi stener (new Enl argeLi stenerO) ; 

} 

/** Main method */ 

public static void main(String[] args) { 
JFrame frame = new Control Ci rcl e2 () ; 
frame . setTi tl e ("Control Ci rcl e2") ; 

frame. setLocationRelativeTo(null) ; // Center the frame 
frame . setDef aul tCl oseOpe rati on (J Frame . EXIT_0N_CL0SE) ; 
frame.setSize(200, 200); 
frame . setVi si bl e (true) ; 



} 



class EnlargeLi stener implements Acti onLi stener { 
public void actionPerformed(ActionEvent e) { 
canvas. enlarge() ; 

} 

} 

class CirclePanel extends JPanel { // Inner class 
private int radius = 5 ; // Default circle radius 

/** Enlarge the circle */ 
public void enlarge() { 
radi us++ ; 



// Inner class 
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43 repaintO; 

44 } 
45 

46 /** Repaint the circle */ 

47 protected void pai ntComponent(Graphi cs g) { 

48 super . pai ntComponent(g) ; 

49 g.drawOval (getWidthO / 2 - radius, getHeightO / 2 - radius, 

50 2 * radius, 2 * radius); 

51 } 

52 } 

53 } 

Similarly you can add the code for the Shrink button to display a smaller circle when the the Shrink button 
Shrink button is clicked. 

16.4 Inner Classes 

An inner class, or nested class, is a class defined within the scope of another class. The code 
in Figure 16.7(a) defines two separate classes, Test and A. The code in Figure 16.7(b) defines 
A as an inner class in Test. 



public class Test { 
} 

public class A { 

} 



(a) 



public class Test { 



// Inner class 
public class A { 



} 



// OuterClass . java: inner class demo 
public class OuterClass { 
private int data; 

/** A method in the outer class */ 
public void m() { 

// Do something 

} 

// An inner class 
class InnerClass { 

/** A method in the inner class */ 
publ ic void mi () { 

// Directly reference data and method 
// defined in its outer class 
data++ ; 
itiQ; 



} 



} 



} 



(b) (c) 

Figure 1 6.7 Inner classes combine dependent classes into the primary class. 



The class InnerCl ass defined inside OuterCl ass in Figure 16.7(c) is another example of 
an inner class. An inner class may be used just like a regular class. Normally, you define a class 
an inner class if it is used only by its outer class. An inner class has the following features: 

■ An inner class is compiled into a class named OuterCl assName$InnerCl ass- 
Name, cl ass. For example, the inner class A in Test is compiled into Test$A . cl ass 
in Figure 16.7(b). 

■ An inner class can reference the data and methods defined in the outer class in which it 
nests, so you need not pass the reference of an object of the outer class to the constructor 
of the inner class. For this reason, inner classes can make programs simple and concise. 

■ An inner class can be defined with a visibility modifier subject to the same visibility 
rules applied to a member of the class. 



542 Chapter 16 Event-Driven Programming 



■ An inner class can be defined static. A static inner class can be accessed using 
the outer class name. A static inner class cannot access nonstatic members of the 
outer class. 

■ Objects of an inner class are often created in the outer class. But you can also create 
an object of an inner class from another class. If the inner class is nonstatic, you must 
first create an instance of the outer class, then use the following syntax to create an 
object for the inner class: 

OuterCl ass. InnerCl ass i nnerObject = outerObject.new InnerCl ass() ; 

■ If the inner class is static, use the following syntax to create an object for it: 
OuterCI ass . InnerCl ass innerObject = new OuterClass.InnerClassO ; 

A simple use of inner classes is to combine dependent classes into a primary class. This 
reduces the number of source files. It also makes class files easy to organize, since they are all 
named with the primary class as the prefix. For example, rather than creating two source files, 
Test.java and A.java, in Figure 16.7(a), you can combine class A into class Test and create 
just one source file Test.java in Figure 16.7(b). The resulting class files are Test.class and 
Test$A.class. 

Another practical use of inner classes is to avoid class-naming conflict. Two versions of 
Ci rcl ePanel are defined in Listings 16.1 and 16.2. You can define them as inner classes to 
avoid conflict. 



16.5 Anonymous Class Listeners 

A listener class is designed specifically to create a listener object for a GUI component (e.g., a 
button). The listener class will not be shared by other applications and therefore is appropriate 
to be defined inside the frame class as an inner class, 
anonymous inner class Inner-class listeners can be shortened using anonymous inner classes. An anonymous inner 

class is an inner class without a name. It combines defining an inner class and creating an 
instance of the class in one step. The inner class in Listing 16.2 can be replaced by an anony- 
mous inner class as shown below. 



public ControlCi rcle2() { 

// Omitted 

jbtEnlarge.addActionl_istener( 
new EnlargeLi stenerO ) ; 

class EnlargeListener 

implements ActionListener { 
public void actionPerformed(ActionEvent e) { 
canvas. enlarge () ; 

} 

} 



public ControlCi rcl e2() { 

// Omitted 

jbtEnlarge.addActionl_istener( 
new class EnlargoListonor 

imp! omonts ActionLi stenerO { 
public void 

actionPerformed(ActionEvent e) { 
canvas. enlargeO ; 

} 

}); 

} 



(a) Inner class EnlargeListener (b) Anonymous inner class 

The syntax for an anonymous inner class is as follows: 

new SuperClassName/InterfaceNameO { 

// Implement or override methods in superclass or interface 



// Other methods if necessary 
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Since an anonymous inner class is a special kind of inner class, it is treated like an inner class 
with the following features: 

■ An anonymous inner class must always extend a superclass or implement an inter- 
face, but it cannot have an explicit extends or i mpl ements clause. 

■ An anonymous inner class must implement all the abstract methods in the superclass 
or in the interface. 

■ An anonymous inner class always uses the no-arg constructor from its superclass to 
create an instance. If an anonymous inner class implements an interface, the con- 
structor is Ob j ect () . 

■ An anonymous inner class is compiled into a class named OuterCl assName$n . cl ass. 
For example, if the outer class Test has two anonymous inner classes, they are compiled 
into Test$l . cl ass and Test$2 . cl ass. 

Listing 16.3 gives an example that handles the events from four buttons, as shown in 
Figure 16.8. 



■ Command Prompt - java AnonymousLstenet Demo 



C:\bOOk>jaua AnonyiiiousListensrDeiiso 
Process New 



□ jxj 



Process Open 
Process Saue 
Process Print 

u 



Figure 16.8 The program handles the events from four buttons. 



Listing 16.3 AnonymousLi stenerDemo. java 



1 import javax. swi ng . * ; 

2 import java. awt . event .* ; 

3 Video Note 

4 public class AnonymousLi stenerDemo extends JFrame { Anonymous listener 

5 public AnonymousLi stenerDemo() { 

6 // Create four buttons 

7 JButton jbtNew = new JButton("New") ; 

8 JButton jbtOpen = new JButton("Open") ; 

9 JButton jbtSave = new JButton("Save") ; 
10 JButton jbtPrint = new JButton("Print") ; 
11 

12 // Create a panel to hold buttons 

13 J Panel panel = new JPanelO; 

14 panel . add( jbtNew) ; 

15 panel . add(jbtOpen) ; 

16 panel . add(jbtSave) ; 

17 panel .add(jbtPrint) ; 
18 

19 add (panel); 
20 

21 // Create and register anonymous inner-class listener 

22 jbtNew. addActi onLi stener( 

23 new Acti onLi stenerO { anonymous listener 

24 public void actionPerformed(ActionEvent e) { handleevent 

25 System. out. pri ntl n("Process New") ; 

26 } 

27 } 

28 ); 
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29 

30 jbtOpen . addActionLi stener( 

31 new Acti onLi stenerO { 

32 public void actionPerformed(ActionEvent e) { 

33 System. out. pri ntl n ("Process Open"); 

34 } 

35 } 

36 ); 
37 

38 jbtSave.addActionListener( 

39 new Acti onLi stenerO { 

40 public void actionPerformed(ActionEvent e) { 

41 System. out. pri ntl n ("Process Save"); 

42 } 

43 } 

44 ); 
45 

46 jbtPrint.addActionListener( 

47 new Acti onLi stenerO { 

48 public void actionPerformed(ActionEvent e) { 

49 System. out. pri ntl n ("Process Print"); 

50 } 

51 } 

52 ); 

53 } 
54 

55 /** Main method */ 

56 public static void mai n (Stri ng [] args) { 

57 JFrame frame = new AnonymousLi stenerDemo() ; 

58 frame. setTi tie ("AnonymousLi stenerDemo") ; 

59 frame. setLocationRelativeTo(null) ; // Center the frame 

60 frame . setDef aul tCl oseOperati on (3 Frame . EXIT„0N_CL0SE) ; 

61 frame . pack() ; 

62 frame.setVisible(true) ; 

63 } 



64 } 

The program creates four listeners using anonymous inner classes (lines 22-52). Without 
using anonymous inner classes, you would have to create four separate classes. An anony- 
mous listener works the same way as an inner class listener. The program is condensed using 
an anonymous inner class. 

Anonymous inner classes are compiled into OuterCl assName$# . cl ass, where # 
starts at 1 and is incremented for each anonymous class the compiler encounters. In this 
example, the anonymous inner class is compiled into AnonymousLi stenerDenio$l . cl ass, 
AnonymousLi stenerDemo$2 . cl ass, AnonymousLi stenerDemo$3 . cl ass, and Anony- 
mousLi stenerDemo$4 . cl ass. 

Instead of using the setSize method to set the size for the frame, the program uses the 
packO pack() method (line 61), which automatically sizes the frame according to the size of the 

components placed in it. 

1 6.6 Alternative Ways of Defining Listener Classes 

There are many other ways to define the listener classes. For example, you may rewrite List- 
ing 16.3 by creating just one listener, register the listener with the buttons, and let the listener 
detect the event source — i.e., which button fires the event — as shown in Listing 16.4. 



16.6 Alternative Ways of Defining Listener Classes 



Listing 16.4 DetectSourceDemo. java 

1 import javax. swing.*; 

2 import java.awt. event.*; 
3 

4 public class DetectSourceDemo extends JFrame { 



5 // Create four buttons 

6 private JButton jbtNew = new JButton("New") ; 

7 private JButton jbtOpen = new JButton("Open") ; 

8 private JButton jbtSave = new JButton("Save") ; 

9 private JButton jbtPrint = new JButton("Print") ; 
10 

11 public DetectSourceDemoO { 

12 // Create a panel to hold buttons 

13 J Panel panel = new JPanelO; 

14 panel .add (jbtNew) ; 

15 panel .add(jbtOpen) ; 

16 panel .add (jbtSave) ; 

17 panel . add(jbtPri nt) ; 
18 

19 add (panel); 
20 

21 // Create a listener 

22 ButtonLi stener listener = new ButtonLi stener() ; create listener 
23 

24 // Register listener with buttons 

25 jbtNew. addActi onLi stener(l i stener) ; register listener 

26 jbtOpen.addActionListener(listener) ; 

27 jbtSave. addActionListener(listener) ; 

28 jbtPrint. addActi onLi stener(l i stener) ; 

29 } 
30 

31 class ButtonLi stener implements ActionLi stener { listener class 

32 public void acti onPerformed(Acti onEvent e) { handle event 

33 if (e.getSource() == jbtNew) 

34 System. out. println ("Process New"); 

35 else if (e.getSource() == jbtOpen) 

36 System. out. println("Process Open"); 

37 else if (e.getSource() == jbtSave) 

38 System. out. println ("Process Save"); 

39 else if (e.getSource() == jbtPrint) 

40 System . out . pri ntl n("Process Print"); 

41 } 

42 } 
43 

44 /** Main method */ 

45 public static void main(String[] args) { 

46 JFrame frame = new DetectSourceDemoO; 

47 frame. setTitle("DetectSourceDemo") ; 

48 frame. setLocationRelativeTo(null) ; // Center the frame 

49 frame . setDef aul tCl oseOpe rati on (J Frame . EXIT_0N_CL0SE) ; 

50 frame . pack() ; 

51 frame.setVisible(true) ; 

52 } 



53 } 



546 Chapter 16 Event-Driven Programming 



implement ActionListener 



register listeners 



handle event 



This program defines just one inner listener class (lines 31^12), creates a listener from the 
class (line 22), and registers it to four buttons (lines 25-28). When a button is clicked, the but- 
ton fires an ActionEvent and invokes the listener's actionPerformed method. The 
actionPerformed method checks the source of the event using the getSourceO method 
for the event (lines 33, 35, 37, 39) and determines which button fired the event. 

You may also rewrite Listing 16.3 by defining the custom frame class that implements 
ActionListener, as shown in Listing 16.5. 

Listing 16.5 FrameAsLi stenerDemo. java 



1 

2 
3 
4 
5 
6 
7 
8 
9 
10 
11 
12 
13 
14 
15 
16 
17 
18 
19 
20 
21 
22 
23 
24 
25 
26 
27 
28 
29 
30 
31 
32 
33 
34 
35 
36 
37 
38 
39 
40 
41 
42 
43 
44 
45 
46 
47 
48 
49 
50 



import javax. swi ng . * ; 
import java. awt . event .* ; 

public class FrameAsLi stenerDemo extends DFrame 
implements ActionListener { 

// Create four buttons 

private JButton jbtNew = new JButton("New") ; 
private JButton jbtOpen = new DButton("Open") ; 
private JButton jbtSave = new DButton("Save") ; 
private JButton jbtPrint = new JButton("Print") ; 

public FrameAsLi stenerDemo() { 

// Create a panel to hold buttons 
1 Panel panel = new JPanelO; 
panel .add(jbtNew) ; 
panel . add(jbtOpen) ; 
panel .add(jbtSave) ; 
panel .add(jbtPrint) ; 

add(panel) ; 

// Register listener with buttons 
jbtNew. addActi on Li stener(this) ; 
jbtOpen . addActi on Li stener(this) ; 
jbt Save. addActi on Li stener(this) ; 
jbtPri nt . addActi on Li stener(this) ; 

} 

/** Implement actionPerformed */ 
public void actionPerformed(ActionEvent e) { 
if (e.getSourceO == jbtNew) 

System. out . pri ntl n ("Process New") ; 
else if (e.getSourceO == jbtOpen) 

System. out .pri ntl n("Process Open") ; 
else if (e.getSourceO == jbtSave) 

System. out .pri ntl n("Process Save") ; 
else if (e.getSourceO == jbtPrint) 

System. out .pri ntl n("Process Print") ; 

} 

/** Main method */ 

public static void main(String[] args) { 
JFrame frame = new FrameAsLi stenerDemo() ; 
frame . setTi tl e(" FrameAsLi stenerDemo") ; 
frame. setLocationRelativeTo(null) ; // Center the frame 
frame . setDef aul tCl oseOperati on (J Frame . EXIT_0N_CL0SE) ; 
frame . pack() ; 
frame . setVi si bl e(true) ; 

} 
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The frame class extends JFrame and implements ActionListener (line 5). So the class is a 
listener class for action events. The listener is registered to four buttons (lines 23-26). When 
a button is clicked, the button fires an ActionEvent and invokes the listener's 
actionPerformed method. The actionPerformed method checks the source of the event 
using the getSourceO method for the event (lines 31, 33, 35, 37) and determines which 
button fired the event. 

This design is not desirable because it places too many responsibilities into one class. It is 
better to design a listener class that is solely responsible for handling events. This design 
makes the code easy to read and easy to maintain. 

You can define listener classes in many ways. Which way is preferred? Defining listener 
classes using inner class or anonymous inner class has become a standard for event-handling 
programming because it generally provides clear, clean, and concise code. So, we will consis- 
tently use it in this book. 



16.7 Problem: Loan Calculator 

Now you can write the program for the loan-calculator problem presented in the introduction 
of this chapter. Here are the major steps in the program: 

1. Create the user interface, as shown in Figure 16.9. 

a. Create a panel of a CridLayout with 5 rows and 2 columns. Add labels and text 
fields into the panel. Set a title "Enter loan amount, interest rate, and years" for the 
panel. 

b. Create another panel with a FlowLayout(F"lowLayout . RIGHT) and add a button 
into the panel. 

c. Add the first panel to the center of the frame and the second panel to the south side 
of the frame. 

2. Process the event. 

Create and register the listener for processing the button-clicking action event. The 
handler obtains the user input on loan, interest rate, and number of years, computes 
the monthly and total payments, and displays the values in the text fields. 



f LoanCalculator 



Enter loan amount, interest rate, and year 
Animal Interest Rote 
Nnmher of Years 
I oan Animinit 
Monthly Payment 
Total Payment 
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114.02 



Comnute Payment 
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Gridl_ayout(5,2) 



J Panel of FlowLayout 
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Figure 16.9 The program computes loan payments. 
The complete program is given in Listing 16.6. 



Listing 16.6 LoanCalculator. java 

1 import java.awt.'" ; 

2 import java.awt. event.*; 

3 import javax. swi ng . * ; 

4 import javax. swing. border. Titl edBorder ; 
5 

6 public class LoanCalculator extends JFrame { 

7 // Create text fields for interest rate, 
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text fields 



button 



create UI 



add to frame 



register listener 



get input 



create loan 



set result 



8 
9 
10 
11 
12 
13 
14 
15 
16 
17 
18 
19 
20 
21 
22 
23 
24 
25 
26 
27 
28 
29 
30 
31 
32 
33 
34 
35 
36 
37 
38 
39 
40 
41 
42 
43 
44 
45 
46 
47 
48 
49 
50 
51 
52 
53 
54 
55 
56 
57 
58 
59 
60 
61 
62 
63 
64 
65 
66 
67 



// year, loan amount, monthly payment, and total payment 
private JTextField jtfAnnual InterestRate = new JTextFieldO ; 
private JTextField jtf NumberOfYears = new JTextFieldO ; 
private JTextField jtf LoanAmount = new JTextFieldO; 
private JTextField jtfMonthlyPayment = new JTextFieldO; 
private JTextField jtfTotal Payment = new JTextFieldO; 

// Create a Compute Payment button 

private JButton jbtComputeLoan = new JButton("Compute Payment"); 

public LoanCal cul atorO { 

// Panel pi to hold labels and text fields 

JPanel pi = new JPanel (new GridLayout(5 , 2)); 

pl.add(new JLabel ("Annual Interest Rate")); 

pl.add(jtfAnnuallnterestRate) ; 

pl.add(new JLabel ("Number of Years")); 

pl.add(jtfNumberOfYears) ; 

pl.add(new JLabel ("Loan Amount")); 

pi. add (jtf LoanAmount) ; 

pi. add (new JLabel ("Monthly Payment")); 

pi. add (jtfMonthlyPayment) ; 

pi. add (new JLabel ("Total Payment")); 

pi. add (jtfTotal Payment) ; 

pi. set Border (new 

Ti tl edBorder("Enter loan amount, interest rate, and year")); 

// Panel p2 to hold the button 

JPanel p2 = new JPanel (new FlowLayout(FlowLayout. RIGHT)) ; 
p2.add(jbtComputeLoan) ; 

// Add the panels to the frame 
add(pl, BorderLayout. CENTER) ; 
add(p2, BorderLayout. SOUTH) ; 

// Register listener 

jbtComputeLoan . addActi on Li stener(new Button Li stenerO) ; 

} 

/** Handle the Compute Payment button */ 
private class ButtonLi stener implements Acti onLi stener { 
public void acti onPerformed(Acti onEvent e) { 
// Get values from text fields 
double interest = 

Doubl e . parseDoubl e (jtfAnnual InterestRate . getText () ) ; 
int year = 

Integer . parselnt(jtf NumberOfYears . getTextO) ; 
double loanAmount = 

Doubl e . parseDoubl e (jtf LoanAmount . getText () ) ; 



// Create a loan object 

Loan loan = new Loan (interest, 



year, loanAmount); 



// Display monthly payment and total payment 
j tfMonthl yPayment . setText (Stri ng . f ormat ("%. 2f " , 

loan.getMonthlyPayment())) ; 
j tf Total Payment . setText (St ri ng . f o rmat ("% . 2f " , 

loan . getTotal PaymentO)) ; 
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68 public static void main(String[] args) { 

69 LoanCal cul ator frame = new LoanCal cul ator () ; 

70 frame . pack() ; 

71 frame. setTitle("LoanCalculator") ; 

72 frame. setLocationRelativeTo(null) ; // Center the frame 

73 frame . setDef aul tCl oseOperati on (D Frame . EXIT_0N_CL0SE) ; 

74 frame.setVisible(true) ; 

75 } 

76 } 

The user interface is created in the constructor (lines 18-44). The button is the source of the 
event. A listener is created and registered with the button (line 43). 

The listener class (lines 47-66) implements the actionPerf ormed method. When the button 
is clicked, the actionPerformed method is invoked to get the interest rate (line 51), number of 
years (line 53), and loan amount (line 55). Invoking jtf Annual InterestRate.getTextO 
returns the string text in the jtf Annual InterestRate text field. The loan is used for comput- 
ing the loan payments. This class was introduced in Listing 10.2, Loan.java. Invoking 
loan.getMonthlyPaymentO returns the monthly payment for the loan. The 
String, format method uses the printf like syntax to format a number into a desirable for- 
mat. Invoking the setText method on a text field sets a string value in the text field (line 61). 

16.8 Window Events 

The preceding sections used action events. Other events can be processed similarly. This sec- 
tion gives an example of handling WindowEvent. Any subclass of the Window class can fire 
the following window events: window opened, closing, closed, activated, deactivated, iconi- 
fied, and deiconified. The program in Listing 16.7 creates a frame, listens to the window 
events, and displays a message to indicate the occurring event. Figure 16.10 shows a sample 
run of the program. 
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Figure 16.10 The window events are displayed on the console when you run the program 
from the command prompt. 

Listing 16.7 TestWindowEvent. java 

1 import java.awt. event.*; 

2 import javax. swing. J Frame; 
3 

4 public class TestWindowEvent extends JFrame { 

5 public static void main(String[] args) { 

6 TestWindowEvent frame = new TestWi ndowEventO ; 

7 frame. setSize (220, 80); 

8 frame. setLocationRelativeTo(null) ; // Center the frame 

9 frame . setDef aul tCl oseOperati on (D Frame . EXIT_0N_CL0SE) ; 

10 frame. setTi tie ("TestWindowEvent") ; 

11 frame.setVisible(true) ; 

12 } 
13 

14 public TestWi ndowEventO { 

15 addWindowListener(new Wi ndowLi stenerO { 

16 /** 

17 * Handler for wi ndow-dei com' f i ed event 
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* Invoked when a window is changed from a minimized 

* to a normal state. 

*/ 

public void windowDeiconified(WindowEvent event) { 
System. out. println("Window deiconified") ; 

} 

/** 

* Handler for wi ndow-i coni fi ed event 

* Invoked when a window is changed from a normal to a 

* minimized state. For many platforms, a minimized window 

* is displayed as the icon specified in the window's 

* iconlmage property. 
-7 

public void windowIconified(WindowEvent event) { 
System. out. println("Window iconified") ; 

} 



* Handler for window-activated event 

* Invoked when the window is set to be the user's 

* active window, which means the window (or one of its 

* subcomponents) will receive keyboard events. 

*/ 

public void wi ndowActi vated(Wi ndowEvent event) { 
System. out. println("Window activated") ; 

} 



* Handler for window-deactivated event 

* Invoked when a window is no longer the user's active 

* window, which means that keyboard events will no longer 

* be delivered to the window or its subcomponents. 

*/ 

public void wi ndowDeacti vated(Wi ndowEvent event) { 
System. out. println("Window deactivated") ; 

} 



/* 



Handler for window-opened event 

Invoked the first time a window is made visible. 



*/ 

public void wi ndow0pened(Wi ndowEvent event) { 
System. out. println("Window opened") ; 

} 

/** 

* Handler for window-closing event 

* Invoked when the user attempts to close the window 

* from the window's system menu. If the program does not 

* explicitly hide or dispose the window while processing 

* this event, the window-closing operation will be cancell 

*/ 

public void wi ndowCl osi ng(Wi ndowEvent event) { 
System. out. println("Window closing") ; 

} 



/* 



Handler for window-closed event 

Invoked when a window has been closed as the result 
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78 * of calling dispose on the window. 

79 

80 public void windowClosed(WindowEvent event) { implement handler 

81 System. out. println("Window closed"); 

82 } 

83 }); 

84 } 

85 } 

The Window/Event can be fired by the Window class or by any subclass of Window. Since 
JFrame is a subclass of Window, it can fire WindowEvent. 

TestWindowEvent extends JFrame and implements WindowListener. The 
WindowListener interface defines several abstract methods (windowActivated, 
windowClosed, windowClosing, windowDeactivated, windowDeiconified, 
windowlconif ied, wi ndowOpened) for handling window events when the window is acti- 
vated, closed, closing, deactivated, deiconified, iconified, or opened. 

When a window event, such as activation, occurs, the windowActivated method is 
invoked. Implement the wi ndowActi vated method with a concrete response if you want the 
event to be processed. 



1 6.9 Listener Interface Adapters 



Because the methods in the WindowListener interface are abstract, you must implement all 
of them even if your program does not care about some of the events. For convenience, Java 
provides support classes, called convenience adapters, which provide default implementations 
for all the methods in the listener interface. The default implementation is simply an empty 
body. Java provides convenience listener adapters for every AWT listener interface with multi- 
ple handlers. A convenience listener adapter is named XAdapter for ^Listener. For example, 
WindowAdapter is a convenience listener adapter for WindowListener. Table 16.3 lists the 
convenience adapters. 

Table 16.3 Convenience Adapters 



Adapter 



Interface 



WindowAdapter 
MouseAdapter 
MouseMoti onAdapter 
KeyAdapter 
Contai nerAdapter 
Component Adapter 
FocusAdapter 



WindowListener 
MouseListener 
MouseMotionListener 
KeyListener 
Contai ner Li stener 
ComponentLi stener 
FocusLi stener 



convenience adapter 



Using Wi ndowAdapter, the preceding example can be simplified as shown in Listing 16.8, 
if you are interested only in the window-activated event. The Wi ndowAdapter class is used to 
create an anonymous listener instead of WindowListener (line 15). The windowActivated 
handler is implemented in line 16. 



Listing 16.8 AdapterDemo. java 

1 import java.awt. event.*; 

2 import javax.swing.D Frame; 
3 

4 public class AdapterDemo extends JFrame { 
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5 public static void main(String[] args) { 

6 AdapterDemo frame = new AdapterDemoO ; 

7 frame. setSize(220, 80); 

8 frame. setLocationRelativeTo(null) ; // Center the frame 

9 frame . setDef aul tCl oseOperati on (D Frame . EXIT_0N_CL0SE) ; 

10 frame. setTi tie ("AdapterDemo") ; 

11 frame . setVi si bl e(true) ; 

12 } 
13 

14 public AdapterDemoO { 

register listener 15 addWi ndowLi stener(new Wi ndowAdapterO { 

implement handler 16 public void wi ndowActi vated (Wi ndowEvent event) { 

17 System. out. println("Window activated"); 

18 } 

19 }); 

20 } 

21 } 



16.10 Mouse Events 

A mouse event is fired whenever a mouse is pressed, released, clicked, moved, or dragged on 
a component. The MouseEvent object captures the event, such as the number of clicks asso- 
ciated with it or the location (x- and y-coordinates) of the mouse, as shown in Figure 16.11. 

Since the MouseEvent class inherits InputEvent, you can use the methods defined in 
the InputEvent class on a MouseEvent object. 
Point class The java.awt . Point class represents a point on a component. The class contains two 

public variables, x and y, for coordinates. To create a Point, use the following constructor: 

Point (int x, int y) 

This constructs a Point object with the specified x- and y-coordinates. Normally, the data 
fields in a class should be private, but this class has two public data fields. 

Java provides two listener interfaces, MouseListener and MouseMotionListener, to 
handle mouse events, as shown in Figure 16.12. Implement the MouseListener interface to 



java. awt. event.InputEvent 



+getWhen(): long 
+i sAl tDown() : boolean 
+isControlDown() : boolean 
+i sMetaDown () : bool ean 
+i sShi f tDown () : bool ean 



java.awt.event.MouseEvent 



+getButton() : int 
+getCl i ckCountO : int 
+getPoint(): java. awt. Point 
+getX(): int 
+getY(): int 



Returns the timestamp when this event occurred. 
Returns true if the Al t key is pressed on this event. 
Returns true if the Control key is pressed on this event. 
Returns true if the Meta mouse button is pressed on this event. 
Returns true if the Shi ft key is pressed on this event. 



Indicates which mouse button has been clicked. 

Returns the number of mouse clicks associated with this event. 

Returns a Poi nt object containing the x- and v-coordinates. 

Returns the x-coordinate of the mouse point. 

Returns the y-coordinate of the mouse point. 



Figure 16.1 1 The MouseEvent class encapsulates information for mouse events. 
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«interface» 
java. awt. event. MouseListener 



+mousePressed(e: MouseEvent) : void 
+mouseRel eased (e: MouseEvent): void 
+mouseClicked(e: MouseEvent) : void 
+mouseEntered(e: MouseEvent): void 
+mouseExited(e: MouseEvent) : void 



«interface» 
java,awt.event.MouseMotionListener 



+mouseDragged(e: MouseEvent): void 
+mouseMoved(e: MouseEvent) : void 



Invoked after the mouse button has been pressed on the source 
component. 

Invoked after the mouse button has been released on the 
source component. 

Invoked after the mouse button has been clicked (pressed and 
released) on the source component. 

Invoked after the mouse enters the source component. 
Invoked after the mouse exits the source component. 



Invoked after a mouse button is moved with a button pressed. 
Invoked after a mouse button is moved without a button pressed. 



Figure 16.12 The MouseListener interface handles mouse pressed, released, clicked, entered, and exited events. The 
MouseMotionListener interface handles mouse dragged and moved events. 



listen for such actions as pressing, releasing, entering, exiting, or clicking the mouse, and 
implement the MouseMotionListener interface to listen for such actions as dragging or 
moving the mouse. 



1 6. 1 0. 1 Example: Moving a Message on a Panel Using a Mouse 

This example writes a program that displays a message in a panel, as shown in Listing 16.9. 
You can use the mouse to move the message. The message moves as the mouse drags and is 
always displayed at the mouse point. A sample run of the program is shown in Figure 16.13. 



Vb]uurn« Lu Java 



Figure 16.13 You can move the message by dragging the mouse. 



Listing 16.9 MoveMessageDemo. java 

1 import java. awt.*; 

2 import java. awt . event .* ; 

3 import javax. swi ng . * ; Video Note 

4 Move message using the 

5 public class MoveMessageDemo extends JFrame { mouse 

6 public MoveMessageDemoO { 

7 // Create a Movabl eMessagePanel instance for moving a message 

8 Movabl eMessagePanel p = new Movabl eMessagePanel create a panel 

9 ("Welcome to Java"); 
10 

11 // Place the message panel in the frame 

12 setLayout(new BorderLayoutO) ; 

13 add(p); 

14 } 
15 
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16 


/** Main method */ 




17 


public static void main(Stnng[] args) { 




18 


MoveMessageDemo frame = new MoveMessageDemoO ; 




19 


f . t " . ~i fit ha mm r% 1 1 "\ 

frame . setTi tl e( MoveMessageDemo ) ; 




20 


frame . setSi ze(200 , 100); 




21 


frame. setLocationRelativeTo(null) ; // Center the frame 




22 


frame . setDef aul tCT oseOpe rati on (J Frame . EXIT_0N_CL0SE) ; 




23 


frame . setVi si bl e (true) ; 




24 


} 




25 






26 


// Inner class: Movabl eMessagePanel draws a message 


inner class 


27 


static class Movabl eMessagePanel extends JPanel { 




28 


■ ■ c _i_ ■ 111 IT . —* it 

private String message = Welcome to Java ; 




-> n 

zy 


private int x = 20; 




30 


private int y = 20; 




31 






32 


/** Construct a panel to draw string s */ 




33 


public Movabl eMessagePanel (Stri ng s) { 


set a new message 


34 


message = s; 


anonymous listener 


35 


addMouseMoti onLi stener(new MouseMotionAdapterO { 




ib 


Handle mouse-dragged event */ 


override handler 


T -7 

3 / 


public void mouseDragged(MouseEvent e) { 




38 


// Get the new location and repaint the screen 


new location 


39 


x = e.getXO ; 




40 


y = e.getYO ; 


repaint 


41 


repaint () ; 




42 


} 




A 1 

4i 


i ) , 




A A 

44 


} 




45 






46 


/** Paint the component */ 




47 


protected void pai ntComponent(Graphi cs g) { 




48 


super . pai ntComponent (g) ; 


paint message 


49 


g.drawString(message, x, y) ; 




50 


} " 




51 


} 




52 } 





The Movabl eMessagePanel class extends JPanel to draw a message (line 27). Addition- 
ally, it handles redisplaying the message when the mouse is dragged. This class is defined 
as an inner class inside the main class because it is used only in this class. Furthermore, the 
inner class is defined static because it does not reference any instance members of the main 
class. 

The MouseMotionListener interface contains two handlers, mouseMoved and 
mouseDragged, for handling mouse-motion events. When you move the mouse with the but- 
ton pressed, the mouseDragged method is invoked to repaint the viewing area and display 
the message at the mouse point. When you move the mouse without pressing the button, the 
mouseMoved method is invoked. 

Because the listener is interested only in the mouse-dragged event, the anonymous inner- 
class listener extends MouseMotionAdapter to override the mouseDragged method. If the 
inner class implemented the MouseMotionListener interface, you would have to imple- 
ment all of the handlers, even if your listener did not care about some of the events. 

The mouseDragged method is invoked when you move the mouse with a button pressed. 
This method obtains the mouse location using getX and getY methods (lines 39-40) in the 
MouseEvent class. This becomes the new location for the message. Invoking the repaint () 
method (line 41) causes pai ntComponent to be invoked (line 47), which displays the mes- 
sage in a new location. 
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16.1 1 Key Events 

Key events enable the use of the keys to control and perform actions or get input from the key- 
board. A key event is fired whenever a key is pressed, released, or typed on a component. The 
KeyEvent object describes the nature of the event (namely, that a key has been pressed, 
released, or typed) and the value of the key, as shown in Figure 16.14. Java provides the 
KeyListener interface to handle key events, as shown in Figure 16.15. 



java. awt. event.InputEvent 
java.awt.event.KeyEvent 



+getKeyChar() : char 
+getKeyCode() : int 



Returns the character associated with the key in this event. 
Returns the integer key code associated with the key in this event. 



Figure 16.14 The KeyEvent class encapsulates information about key events. 



«interface» 
java. awt. event.KeyListener 



+keyPressed(e: KeyEvent): void 
+keyRel eased (e: KeyEvent): void 
+keyTyped(e: KeyEvent): void 



Invoked after a key is pressed on the source component. 
Invoked after a key is released on the source component. 
Invoked after a key is pressed and then released on the source component. 



Figure 16.15 The KeyListener interface handles key pressed, released, and typed events. 



The keyPressed handler is invoked when a key is pressed, the keyRel eased handler is 
invoked when a key is released, and the keyTyped handler is invoked when a Unicode char- 
acter is entered. If a key does not have a Unicode (e.g., function keys, modifier keys, action 
keys, and control keys), the keyTyped handler will be not be invoked. 

Every key event has an associated key character or key code that is returned by the 
getKeyCharO or getKeyCodeO method in KeyEvent. The key codes are constants defined 
in Table 16.4. For a key of the Unicode character, the key code is the same as the Unicode value. 



Table 16.4 Key Constants 



Constant 


Description 


Constant 


Description 


VK_HOME 


The Home key 


VK_SHIFT 


The Shift key 


VK.END 


The End key 


VK^BACK_SPACE 


The Backspace key 


VK_PCUP 


The Page Up key 


VK_CAPS„LOCK 


The Caps Lock key 


VK_PCDN 


The Page Down key 


VK_NUM„LOCK 


The Num Lock key 


VKJJP 


The up-arrow key 


VK„ENTER 


The Enter key 


VKJJOWN 


The down- arrow key 


VKJJNDEFINED 


The keyCode unknown 


VK_LEFT 


The left-arrow key 


VKJF1 to VK_F12 


The function keys 


VK_RIGHT 


The right-arrow key 




from Fl to F12 


VK_ESCAPE 


The Esc key 


VK_0 to VK_9 


The number keys from to 9 


VK_TAB 


The Tab key 


VK_A to VK_Z 


The letter keys from A to Z 


VK_CONTROL 


The Control key 
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For the key-pressed and key-released events, getKeyCodeO returns the value as defined in the 
table. For the key-typed event, getKeyCode () returns VK_UNDEFINED, while getKeyChar () 
returns the character entered. 

The program in Listing 16.10 displays a user-input character. The user can move the char- 
acter up, down, left, and right, using the arrow keys VK_UP, VK_DOWN, VK_LEFT, and 
VK_RIGHT. Figure 16.16 contains a sample run of the program. 



I KeyEventDemo 



JnJiiJ 



Figure 16.16 The program responds to key events by displaying a character and moving it 
up, down, left, or right. 



Listing 16.10 KeyEventDemo. java 



create a panel 



focusable 



inner class 



register listener 
override handler 



get the key pressed 



1 

2 
3 
4 
5 
6 
7 
8 
9 
10 
11 
12 
13 
14 
15 
16 
17 
18 
19 
20 
21 
22 
23 
24 
25 
26 
27 
28 
29 
30 
31 
32 
33 
34 
35 
36 
37 
38 
39 
40 
41 
42 



import java.awt.*; 
import java. awt . event .* ; 
import javax. swi ng . * ; 

public class KeyEventDemo extends J Frame { 

private KeyboardPanel keyboardPanel = new KeyboardPanel () ; 

/** Initialize UI */ 
public KeyEventDemoO { 

// Add the keyboard panel to accept and display user input 

add(keyboardPanel ) ; 

// Set focus 

keyboardPanel . setFocusabl e(true) ; 

} 

/** Main method */ 

public static void main(String[] args) { 
KeyEventDemo frame = new KeyEventDemoO; 
frame . setTi tl e ("KeyEventDemo") ; 
frame. setSize(300, 300); 

frame. setLocationRelativeTo(null) ; // Center the frame 
frame . setDef aul tCl oseOpe rati on (1 Frame . EXIT_0N_CL0SE) ; 
frame.setVisible(true) ; 

} 

// Inner class: KeyboardPanel for receiving key input 
static class KeyboardPanel extends IPanel { 

private int x = 100; 

private int y = 100; 

private char keyChar = 'A'; // Default key 

public KeyboardPanel () { 

addKeyLi stener(new KeyAdapterO { 
public void keyPressed(KeyEvent e) { 
switch (e.getKeyCodeO) { 

case Key Event. VK_D0WN: y += 10; break; 
case KeyEvent.VKJJP: y -= 10; break; 
case KeyEvent . VK_LEFT: x -= 10; break; 
case KeyEvent. VK_RIGHT: x += 10; break; 



} 



default: keyChar = e . getKeyCharQ ; 
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43 

44 repaintO; repaint 

45 } 

46 }); 

47 } 
48 

49 /•'•"•• Draw the character */ 

50 protected void pai ntComponent(Graphi cs g) { 

51 super . pai ntComponent(g) ; 
52 

53 g. setFont (new Font ("TimesRoman" , Font. PLAIN, 24)); 

54 g.drawString(String.valueOf (keyChar) , x, y) ; redraw character 

55 } " 



56 } 

57 } 

The KeyboardPanel class extends JPanel to display a character (line 28). This class is 
defined as an inner class inside the main class, because it is used only in this class. Further- 
more, the inner class is defined static, because it does not reference any instance members of 
the main class. 

Because the program gets input from the keyboard, it listens for KeyEvent and extends 
KeyAdapter to handle key input (line 34). 

When a key is pressed, the keyPressed handler is invoked. The program uses 
e.getKeyCodeO to obtain the key code and e . getKeyChar () to get the character for the 
key. When a nonarrow key is pressed, the character is displayed (line 41). When an arrow key 
is pressed, the character moves in the direction indicated by the arrow key (lines 37-40). 

Only a focused component can receive KeyEvent. To make a component focusable, set its focusable 
isFocusable property to true (line 14). 

Every time the component is repainted, a new font is created for the Graphics object in 
line 53. This is not efficient. It is better to create the font once as a data field. efficient? 

16.12 Animation Using the Timer Class 

Not all source objects are GUI components. The javax. swing. Timer class is a source 
component that fires an ActionEvent at a predefined rate. Figure 16.17 lists some of the 
methods in the class. 



j a vax.s wing.Timer 



+Ti mer (del ay: int, listener: 
ActionListener) 

+addActionl_i stener(l i stener : 
ActionListener): void 

+start(): void 

+stop(): void 

+setDelay(delay: int): void 



Creates a Ti me r object with a specified delay in milliseconds and an 
ActionListener. 

Adds an ActionLi stener to the timer. 



Starts this timer. 
Stops this timer. 

Sets a new delay value for this timer. 



Figure 16.1 7 A Timer object fires an ActionEvent at a fixed rate. 



A Timer object serves as the source of an ActionEvent. The listeners must be instances 
of ActionListener and registered with a Timer object. You create a Timer object using its 
sole constructor with a delay and a listener, where del ay specifies the number of milliseconds 
between two action events. You can add additional listeners using the addActionLi stener 
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method and adjust the delay using the setDelay method. To start the timer, invoke the 
start () method. To stop the timer, invoke the stopO method. 

The Timer class can be used to control animations. For example, you can use it to display 
a moving message, as shown in Figure 16.18, with the code in Listing 16.11. 



I Animation 



message moving? 



message moving? 



message moving? 



Figure 1 6.1 8 A message moves in the panel. 



Listing 16.11 AnimationDemo. java 



create panel 



set message 



create timer 
start timer 



reset x-coordinate 



move message 



1 
2 
3 
4 
5 
6 
7 
8 
9 
10 
11 
12 
13 
14 
15 
16 
17 
18 
19 
20 
21 
22 
23 
24 
25 
26 
27 
28 
29 
30 
31 
32 
33 
34 
35 
36 
37 
38 
39 
40 
41 
42 
43 
44 



import java.awt.*; 
import java. awt . event .* ; 
import javax. swing.*; 

public class AnimationDemo extends DFrame { 
public AnimationDemoO { 

// Create a Movi ngMessagePanel for displaying a moving message 
add(new Movi ngMessagePanel ("message moving?")); 

} 

/** Main method */ 

public static void main(String[] args) { 
AnimationDemo frame = new AnimationDemoO; 
frame . setTi tl e ("AnimationDemo") ; 
frame.setSize(280, 100); 

frame. setLocationRelativeTo(null) ; // Center the frame 
frame . setDef aul tCl oseOperati on (1 Frame . EXIT_0N_CL0SE) ; 
frame . setVi si bl e(true) ; 

} 

// Inner class: Displaying a moving message 
static class Movi ngMessagePanel extends JPanel { 

private String message = "Welcome to Java"; 

private int xCoordinate = 0; 

private int yCoordinate = 20; 

public Movi ngMessagePanel (Stri ng message) { 
this. message = message; 

// Create a timer 

Timer timer = new Timer(1000, new TimerListenerO) ; 
timer. start() ; 

} 

/** Paint message */ 

protected void pai ntComponent(Graphi cs g) { 
super . pai ntComponent (g) ; 

if (xCoordinate > getWidthO) { 
xCoordinate = -20; 

} 

xCoordinate += 5; 

g.drawString(message, xCoordinate, yCoordinate); 
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45 

46 class TimerLi stener implements Acti onLi stener { listener class 

47 /** Handle Acti onEvent */ 

48 public void acti on Performed (Acti on Event e) { event handler 

49 repaintO; repaint 

50 } 

51 } 



52 } 

53 } 

The MovingMessagePanel class extends J Panel to display a message (line 22). This class 
is defined as an inner class inside the main class, because it is used only in this class. Further- 
more, the inner class is defined static, because it does not reference any instance members of 
the main class. 

An inner class listener is defined in line 46 to listen for Acti onEvent. Line 31 creates a 
Timer for the listener. The timer is started in line 32. The timer fires an ActionEvent 
every second, and the listener responds in line 49 to repaint the panel. When a panel is 
painted, its x-coordinate is increased (line 42), so the message is displayed to the right. 
When the x-coordinate exceeds the bound of the panel, it is reset to -20 (line 40), so the 
message continues moving from left to right. 

In §15.12, "Case Study: The Still Clock Class," you drew a Still Clock to show the 
current time. The clock does not tick after it is displayed. What can you do to make the clock 
display a new current time every second? The key to making the clock tick is to repaint it 
every second with a new current time. You can use a timer to control the repainting of the 
clock with the code in Listing 16.12. 

Listing 16.12 ClockAnimation. java 

1 import java.awt. event.*; 

2 import javax. swi ng . * ; 

3 

4 public class ClockAnimation extends JFrame { 

5 private StillClock clock = new StillClockO; 
6 

7 public ClockAnimationO { 

8 add(clock); 
9 

10 // Create a timer with delay 1000 ms 

11 Timer timer = new Timer(1000, new TimerLi stenerO) ; 

12 timer. start() ; 

13 } 
14 

15 private class Ti merLi stener implements ActionLi stener { 

16 /** Handle the action event */ 

17 public void acti onPerformed(Acti onEvent e) { 

18 // Set new time and repaint the clock to display current time 

19 clock. setCurrentTimeO ; 

20 clock. repaintO ; 

21 } 

22 } 
23 

24 /** Main method */ 

25 public static void main(String[] args) { 

26 JFrame frame = new ClockAnimationO; 

27 frame. setTi tie ("ClockAnimation") ; 

28 frame. setSize(200, 200); 

29 frame. setLocationRelativeTo(null) ; // Center the frame 

30 frame . setDef aul tCl oseOpe rati on (1 Frame . EXIT_0N_CL0SE) ; 




Video Note 

Animate a clock 

create a clock 



create a timer 
start timer 

listener class 

implement handler 

set new time 
repaint 
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31 frame.setVisible(true) ; 

32 } 

33 } 

The program displays a running clock, as shown in Figure 16.19. ClockAnimation creates a 
Still Clock (line 5). Line 11 creates a Timer for a ClockAnimation. The timer is started 
in line 12. The timer fires an ActionEvent every second, and the listener responds to set a 
new time (line 19) and repaint the clock (line 20). The setCurrentTimeO method defined 
in Sti 1 1 CI ock sets the current time in the clock. 



1 '3 ClockAnimation [~~ f 


HI 3 ClockAnimation 


-In|x| 




-In|x| 


















9 X 


3 







Figure 1 6.1 9 A live clock is displayed in the panel. 
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Chapter Summary 





1. The root class of the event classes is java.util . EventObject. The subclasses of 
EventObject deal with special types of events, such as action events, window events, 
component events, mouse events, and key events. You can identify the source object of 
an event using the getSourceO instance method in the EventObject class. If a com- 
ponent can fire an event, any subclass of the component can fire the same type of event. 

2. The listener object's class must implement the corresponding event-listener interface. Java 
provides a listener interface for every event class. The listener interface is usually named 
^Listener for XEvent, with the exception of MouseMotionListener. For example, 
the corresponding listener interface for ActionEvent is ActionListener; each listener 
for ActionEvent should implement the ActionListener interface. The listener inter- 
face contains the method(s), known as the handler(s), which process the events. 

3. The listener object must be registered by the source object. Registration methods 
depend on the event type. For ActionEvent, the method is addActionListener. In 
general, the method is named addXLi stener for XEvent. 

4- An inner class, or nested class, is defined within the scope of another class. An inner 
class can reference the data and methods defined in the outer class in which it nests, so 
you need not pass the reference of the outer class to the constructor of the inner class. 
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5 . Convenience adapters are support classes that provide default implementations for all 
the methods in the listener interface. Java provides convenience listener adapters for 
every AWT listener interface with multiple handlers. A convenience listener adapter is 
named XAdapter for XListener. 

6. A source object may fire several types of events. For each event, the source object 
maintains a list of registered listeners and notifies them by invoking the handler on the 
listener object to process the event. 

7. A mouse event is fired whenever a mouse is clicked, released, moved, or dragged on a 
component. The mouse-event object captures the event, such as the number of clicks 
associated with it or the location (x- and y-coordinates) of the mouse point. 

8. Java provides two listener interfaces, MouseListener and MouseMotionListener, 
to handle mouse events, implement the MouseListener interface to listen for such 
actions as mouse pressed, released, clicked, entered, or exited, and implement the 
MouseMotionListener interface to listen for such actions as mouse dragged or 
moved. 

9. A KeyEvent object describes the nature of the event (namely, that a key has been 
pressed, released, or typed) and the value of the key. 

1 0. The keyPressed handler is invoked when a key is pressed, the keyRel eased han- 
dler is invoked when a key is released, and the key Typed handler is invoked when a 
Unicode character key is entered. If a key does not have a Unicode (e.g., function 
keys, modifier keys, action keys, and control keys), the key Typed handler will be not 
be invoked. 

I I. You can use the Timer class to control Java animations. A timer fires an 
ActionEvent at a fixed rate. The listener updates the painting to simulate an 
animation. 

Review Questions 

Sections 16.2-16.3 

16.1 Can a button fire a Wi ndowEvent? Can a button fire a MouseEvent? Can a button 
fire an ActionEvent? 

1 6.2 Why must a listener be an instance of an appropriate listener interface? Explain 
how to register a listener object and how to implement a listener interface. 

16.3 Can a source have multiple listeners? Can a listener listen on multiple sources? 
Can a source be a listener for itself? 

I 6.4 How do you implement a method defined in the listener interface? Do you need to 
implement all the methods defined in the listener interface? 

Sections 16.4-16.9 

I 6.5 Can an inner class be used in a class other than the class in which it nests? 

1 6.6 Can the modifiers publ ic, private, and static be used on inner classes? 

I 6.7 If class A is an inner class in class B, what is the .class file for A? If class B con- 
tains two anonymous inner classes, what are the .class file names for these two 
classes? 

16.8 What is wrong in the following code? 



562 Chapter 16 Event-Driven Programming 



import java. swing. *; 
import java.awt.*; 

public class Test extends JFrame { 
public Test() { 

DButton jbtOK = new JButton("OK") ; 
add(jbtOK) ; 

} 

private class Listener 

implements ActionListener { 
public void actionPerform 
(ActionEvent e) { 
System, out. print"! n 

( j btOK . getActi onCommand () ) ; 

} 

} 

/** Main method omitted */ 

} 



(a) 



import java.awt. event."-; 
import javax. swing." ; 

public class Test extends J Frame { 
public TestfJ { 

JButton jbtOK = new 3Button("0K") ; 
add(jbtOK) ; 

jbtOK. addActionLi stener( 
new ActionLi stener() { 

public void actionPerformed 
(ActionEvent e) { 
System . out . pri ntl n 

( j btOK . getActi onCommand () ) ; 

} 

} // Something missing here 

} 

/** Main method omitted */ 

} 



(h) 



I 6.9 What is the difference between the setSize(width , height) method and the 
pack() method in JFrame? 

Sections 16.10-16.1 1 

16.10 What method do you use to get the source of an event? What method do you use to 
get the timestamp for an action event, a mouse event, or a key event? What method 
do you use to get the mouse-point position for a mouse event? What method do 
you use to get the key character for a key event? 

16.1 I What is the listener interface for mouse pressed, released, clicked, entered, and 
exited? What is the listener interface for mouse moved and dragged? 

16.12 Does every key in the keyboard have a Unicode? Is a key code in the KeyEvent 
class equivalent to a Unicode? 

1 6.1 3 Is the keyPressed handler invoked after a key is pressed? Is the keyRel eased 
handler invoked after a key is released? Is the keyTyped handler invoked after any 
key is typed? 

Section 16.12 

16.14 How do you create a timer? How do you start a timer? How do you stop a timer? 

16.15 Does the Ti mer class have a no-arg constructor? Can you add multiple listeners to 
a timer? 

Programming Exercises 



Sections 16.2-16.9 

16.1 (Finding which button has been clicked on the console) Add the code to Exercise 
12.1 that will display a message on the console indicating which button has been 
clicked. 

I 6.2 (Using ComponentEvent) Any GUI component can fire a ComponentEvent. 
The ComponentListener defines the componentMoved, componentResized, 
componentShown, and componentHidden methods for processing component 
events. Write a test program to demonstrate ComponentEvent. 
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16.3* (Moving the ball) Write a program that moves the ball in a panel. You should 
define a panel class for displaying the ball and provide the methods for moving 
the button left, right, up, and down, as shown in Figure 16.20(a). 



I Exercisel6_3 



Left 


Right 


U|) 


Down 



[ExerciselS 4 
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Numher 1 4 5 Number 2 


3 Result 


7.5 




Add 


Subtract 


Multiply 


Divide 





Panel with FlowLayout 
Panel with FlowLayout 



(a) 



(b) 



Figure 1 6.20 (a) Exercise 16.3 displays which button is clicked on a message panel, (b) The program performs 
addition, subtraction, multiplication, and division on double numbers. 



I 6.4* (Creating a simple calculator) Write a program to perform add, subtract, multi- 
ply, and divide operations (see Figure 16.20(b)). 

16.5* (Creating an investment-value calculator) Write a program that calculates the 
future value of an investment at a given interest rate for a specified number of 
years. The formula for the calculation is as follows: 

futureValue = i nvestmentAmount * (1 + month! yInterestRate) years * 12 

Use text fields for interest rate, investment amount, and years. Display the future 
amount in a text field when the user clicks the Calculate button, as shown in 
Figure 16.21(a). 
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(a) 



(b) 




Figure 1 6.2 1 (a) The user enters the investment amount, years, and interest rate to com- 
pute future value, (b) Exercise 16.8 displays the mouse position, (c) Exercise 16.9 uses the 
arrow keys to draw the lines. 



Section 16.10 

I 6.6** (Alternating two messages) Write a program to rotate with a mouse click two 
messages displayed on a panel, "Java is fun" and "Java is powerful". 

16.7* (Setting background color using a mouse) Write a program that displays the 
background color of a panel as black when the mouse is pressed and as white 
when the mouse is released. 

I 6.8* (Displaying the mouse position) Write two programs, such that one displays the 
mouse position when the mouse is clicked (see Figure 16.21(b)) and the other 
displays the mouse position when the mouse is pressed and ceases to display it 
when the mouse is released. 

Section 16.1 1 

I 6.9* (Drawing lines using the arrow keys) Write a program that draws line segments 
using the arrow keys. The line starts from the center of the frame and draws 
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toward east, north, west, or south when the right-arrow key, up-arrow key, left- 
arrow key, or down-arrow key is clicked, as shown in Figure 16.21(c). 

1 6.1 0** (Entering and displaying a string) Write a program that receives a string from 
the keyboard and displays it on a panel. The Enter key signals the end of a 
string. Whenever a new string is entered, it is displayed on the panel. 

16.1 I * (Displaying a character) Write a program to get a character input from the key- 
board and display the character where the mouse points. 

Section 16.12 

I 6.12** (Displaying a running fan) Listing 15.4, Draw Arc s.java, displays a motionless 
fan. Write a program that displays a running fan. 

1 6.1 3** (Slide show) Twenty-five slides are stored as image files (slide0.jpg, slidel.jpg, 
. . . , slide24.jpg) in the image directory downloadable along with the source 
code in the book. The size of each image is 800 X 600. Write a Java application 
that automatically displays the slides repeatedly. Each slide is shown for a sec- 
ond. The slides are displayed in order. When the last slide finishes, the first slide 
is redisplayed, and so on. 

(Hint: Place a label in the frame and set a slide as an image icon in the label.) 

I 6.14** (Raising flag) Write a Java program that animates raising a flag, as shown in 
Figure 16.1. (See §15.11, "Displaying Images," on how to display images.) 

1 6.1 5** (Racing car) Write a Java program that simulates car racing, as shown in Figure 

Video Note 16.22(a). The car moves from left to right. When it hits the right end, it restarts 

Animate a rising flag ° c 

from the left and continues the same process. You can use a timer to control ani- 
mation. Redraw the car with a new base coordinates (x, y), as shown in Figure 
16.22(b). 
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(a) (b) 
Figure 16.22 (a) Exercise 16.15 displays a moving car. (b) You can redraw a car with a new base point. 



16.16* (Displaying a flashing label) Write a program that displays a flashing label. 

(Hint: To make the label flash, you need to repaint the panel alternately with the 
label and without it (blank screen) at a fixed rate. Use a bool ean variable to 
control the alternation.) 

16.17* (Controlling a moving label) Modify Listing 16.11, AnimationDemo.java, to 
control a moving label using the mouse. The label freezes when the mouse is 
pressed, and moves again when the button is released. 

Comprehensive 

16.18* (Moving a circle using keys) Write a program that moves a circle up, down, left, 
or right using the arrow keys. 
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I 6. 1 9** (Geometry: inside a circle?) Write a program that draws a fixed circle cen- 
tered at (100, 60) with radius 50. Whenever a mouse is moved, display the 
message indicating whether the mouse point is inside the circle, as shown in 
Figure 16.23(a). 
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(a) (b) (c) 

Figure 1 6.23 Detect whether a point is inside a circle, a rectangle, or a triangle. 

I 6.20** (Geometry: inside a rectangle?) Write a program that draws a fixed rectangle 
centered at (100, 60) with width 100 and height 40. Whenever a mouse is 
moved, display the message indicating whether the mouse point is inside the 
rectangle, as shown in Figure 16.23(b). To detect whether a point is inside a 
rectangle, use the MyRectangl e2D class defined in Exercise 10.12. 

16.21** (Geometry: inside a triangle?) Write a program that draws a fixed triangle 
with three vertices at (20, 20), (100, 100), and (140, 40). Whenever a mouse 
is moved, display the message indicating whether the mouse point is inside the 
triangle, as shown in Figure 16.23(c). To detect whether a point is inside a tri- 
angle, use the Triangle2D class defined in Exercise 10.13. 

1 6.22*** (Game: bean-machine animation) Write a program that animates a bean 
machine introduced in Exercise 15.24. The animation terminates after ten balls 
are dropped, as shown in Figure 16.24. 
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Figure 1 6.24 The balls are dropped to the bean machine. 



1 6.23*** (Geometry: closest pair of points) Write a program that lets the user click on 
the panel to dynamically create points. Initially, the panel is empty. When a 
panel has two or more points, highlight the pair of closest points. Whenever a 
new point is created, a new pair of closest points is highlighted. Display the 
points using small circles and highlight the points using filled circles, as shown 
in Figure 16.25(a)-(c). 

(Hint: store the points in an ArrayList.) 

16.24* (Controlling a clock) Modify Listing 16.12 ClockAnimation.java to add two 
methods startQ and stopQ to start and stop the clock. Write a program 
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Figure 16.25 Exercise 16.23 allows the user to create new points with a mouse click and highlights the pair of the clos- 
est points. Exercise 16.24 allows the user to start and stop a clock. 



that lets the user control the clock with the Start and Stop buttons, as shown in 
Figure 16.25(d). 

I 6.25*** (Game: hitting balloons) Write a program that displays a balloon in a random 
position in a panel (Figure 16.26(a)). Use the left- and right-arrow keys to 
point the gun left or right to aim at the balloon (Figure 16.26(b)). Press the up- 
arrow key to fire a small ball from the gun (Figure 16.26(c)). Once the ball hits 
the balloon, the debris is displayed (Figure 16.26(e)) and a new balloon is dis- 
played in a random location (Figure 16.26(f)). If the ball misses the balloon, 
the ball disappears once it hits the boundary of the panel. You can then press 
the up-arrow key to fire another ball. Whenever you press the left- or the right- 
arrow key, the gun turns 5 degrees left or right. (Instructors may modify the 
game as follows: 1. display the number of the balloons destroyed; 2. display a 
countdown timer (e.g., 60 seconds) and terminate the game once the time 
expires; 3. allow the balloon to rise dynamically.) 
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Figure 1 6.26 (a) A balloon is displayed in a random location, (b) Press the left-/right- 
arrow keys to aim the balloon, (c) Press the up-arrow key to fire a ball, (d) The ball moves 
straight toward the balloon, (e) The ball hits the balloon, (f) A new balloon is displayed in a 
random position. 

16.26** (Moving a circle using mouse) Write a program that displays a circle with 
radius 10 pixels. You can point the mouse inside the circle and drag (i.e., 
move with mouse pressed) the circle wherever the mouse goes, as shown in 
Figure 16.27(a)-(b). 

1 6.27*** (Game: eye-hand coordination) Write a program that displays a circle of radius 
10 pixels filled with a random color at a random location on a panel, as shown in 
Figure 16.27(c). When you click the circle, it is gone and a new random-color 
circle is displayed at another random location. After twenty circles are clicked, 
display the time spent in the panel, as shown in Figure 16.27(d). 
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(a) (b) (c) (d) 

Figure 1 6.27 (a)-(b) You can point, drag, and move the circle, (c) When you click a circle, a new circle is displayed at 
a random location, (d) After 20 circles are clicked, the time spent in the panel is displayed. 



I 6.28*** (Simulation: self-avoiding random walk) A self-avoiding walk in a lattice is a 
path from one point to another which does not visit the same point twice. Self- 
avoiding walks have applications in physics, chemistry, and mathematics. 
They can be used to model chainlike entities such as solvents and polymers. 
Write a program that displays a random path that starts from the center and 
ends at a point on the boundary, as shown in Figure 16.28(a), or ends at a dead- 
end point (i.e., surrounded by four points that are already visited), as shown in 
Figure 16.28(b). Assume the size of the lattice is 16 by 16. 
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Figure 16.28 (a) A path ends at a boundary point, (b) A path ends at dead-end point, (c)-(d) Animation shows the 
progress of a path step by step. 



I 6.29*** (Animation: self-avoiding random walk) Revise the preceding exercise to dis- 
play the walk step by step in an animation, as shown in Figure 16.28(c)-(d). 

I 6.30** (Simulation: self-avoiding random walk) Write a simulation program to show 
that the chance of getting dead-end paths increases as the grid size increases. 
Your program simulates lattices with size from 10 to 80. For each lattice size, 
simulate a self-avoiding random walk 10000 times and display the probability 
of the dead-end paths, as shown in the following sample output: 



For 


a 


1 atti ce 


of 


si ze 


10, 


the probability of dead 


-end 


paths 


i s 


10 


6% 


For 


a 


1 atti ce 


of 


si ze 


11, 


the probability of dead 


-end 


paths 


i s 


14 


0% 


For 


a 


1 atti ce 


of 


si ze 


80, 


the probability of dead 


-end 


paths 


i s 


99 


5% 



1 6.3 1 * (Geometry: displaying an n-sided regular polygon) Exercise 15.25 created the 
RegularPolygonPanel for displaying an n-sided regular polygon. Write a 
program that displays a regular polygon and uses two buttons named + 1 and — 1 
to increase or decrease the size of the polygon, as shown in Figure 16.29(a)-(b). 

16.32** (Geometry: adding and removing points) Write a program that lets the user 
click on the panel to dynamically create and remove points. When the user 
right-click the mouse, a point is created and displayed at the mouse point, and 
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Figure 16.29 Clicking the +1 or —1 button increases or decreases the number of sides of a 
regular polygon in Exercise 16.31. Exercise 16.32 allows the user to create/remove points 
dynamically. 

the user can remove a point by pointing to it and left-clicking the mouse, as 
shown in Figure 16.29(c). 

16.33** (Geometry: palindrome) Write a program that animates a palindrome swing, 
as shown in Figure 16.30. Press the up-arrow key to increase the speed and the 
down-arrow key to decrease it. Press the S key to stop animation and the R key 
to resume. 




mSBBSSTR -It xl 


i 






Figure 16.30 Exercise 16.33 animates a palindrome swing. 

I 6.34** (Game: hangman) Write a program that animates a hangman game swing, as 
shown in Figure 16.31. Press the up-arrow key to increase the speed and the 
down-arrow key to decrease it. Press the S key to stop animation and the R key 
to resume. 
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Figure 1 6.3 1 Exercise 16.34 animates a hangman game. 



I 6.35*** (Game: hangman) Exercise 9.31 presents a console version of the popular hang- 
man game. Write a GUI program that lets a user play the game. The user guesses 
a word by entering one letter at a time, as shown in Figure 16.32(a). If the user 
misses seven times, a hanging man swings, as shown in Figure 16.32(b)-(c). 
Once a word is finished, the user can press the Enter key to continue to guess 
another word. 
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lDl2L 



Gnosis si word: wr**c 
Missed letters: pajql 



Exerusel6 35 



InJxJ 




(a) (b) 
Figure 16.32 Exercise 16.35 develops a complete hangman game. 



The wnrd is: write 

To continue the game, press ENTER 




Tlie won! is: write 

To continue the game, press ENTER 



(c) 



I 6.36* (Flipping coins) Write a program that displays head (H) or tail (T) for each of 
nine coins, as shown in Figure 16.33. When a cell is clicked, the coin is 
flipped. A cell is a 3 Labi e. Write a custom cell class that extends 3 Labi e 
with the mouse listener for handling the clicks. When the program starts, all 
cells initially display H. 
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Figure 16.33 Exercise 16.36 enables the user to click a cell to flip a coin. 
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Chapter 



Creating Graphical User 
Interfaces 

Objectives 

■ To create graphical user interfaces with various user-interface components: 3 Button, 
JCheckBox, JRadioButton, J Label, JTextField, JTextArea, JComboBox, JList, 
JScrollBar, and JSlider (§§17.2-17.11). 

■ To create listeners for various types of events (§§17.2-17.11). 

■ To explore JButton (§17.2) 

■ To explore JCheckBox (§17.3) 

■ To explore JRadioButton (§17.4) 

■ To explore J Label (§17.5) 

■ To explore JTextFiel d (§17.6) 

■ To explore JTextArea (§17.7) 

■ To explore JComboBox (§17.8) 

■ To explore J List (§17.9) 

■ To explore JScroll Bar (§17.10) 

■ To explore JSlider (§17.11) 

■ To display multiple windows in an application (§17.12). 
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GUI 



17.1 Introduction 

A graphical user interface (GUI) makes a system user friendly and easy to use. Creating a 
GUI requires creativity and knowledge of how GUI components work. Since the GUI compo- 
nents in Java are very flexible and versatile, you can create a wide assortment of useful user 
interfaces. 

Many Java IDEs provide tools for visually designing and developing GUI interfaces. This 
enables you to rapidly assemble the elements of a user interface (UI) for a Java application or 
applet with minimum coding. Tools, however, cannot do everything. You have to modify the 
programs they produce. Consequently, before you begin to use the visual tools, you must 
understand the basic concepts of Java GUI programming. 

Previous chapters briefly introduced several GUI components. This chapter introduces the 
frequently used GUI components in detail (see Figure 17.1). (Since this chapter introduces no 
new concepts, instructors may assign it for students to study on their own.) 



Component | < — Container | < JComponent^ \ — r- AbstractButton | <l 



- JListl 
- JScrollBar| 
- J Slider] 

Figure 1 7.1 These Swing GUI components are frequently used to create user interfaces. 



-JButton 



J 



3 Label 



J 



- JTextComponent]^ — 
- JComboBox 



- JTogg1eButton| < — 
JTextArea | 



-JCheckBox 
- 3RadioButton| 



JTextFi el dj< — J PasswordFi el d 



naming convention for 
components 



Note 

Throughout this book, the prefixes jbt, jchk, jrb, jlbl, jtf, jpf, jta, jcbo, jlst, 
jscb, and jsld are used to name reference variables for JButton, JCheckBox, 
JRadioButton, JLabel, JTextField, JPasswordField, JTextArea, JComboBox, 
JList, JScrollBar, and JSIider. 



17.2 Buttons 

A button is a component that triggers an action event when clicked. Swing provides regular 
buttons, toggle buttons, check box buttons, and radio buttons. The common features of these 

AbstractButton buttons are defined in j avax . swi ng . AbstractButton, as shown in Figure 17.2. 

JButton This section introduces the regular buttons defined in the JButton class. JButton inherits 

AbstractButton and provides several constructors to create buttons, as shown in Figure 17.3. 

1 7.2.1 Icons, Pressed Icons, and Rollover Icons 

A regular button has a default icon, a pressed icon, and a rollover icon. Normally you use the 
default icon. The other icons are for special effects. A pressed icon is displayed when a button 
is pressed, and a rollover icon is displayed when the mouse is over the button but not pressed. 
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javax. swi ng . JComponent 



javax.swing. AbstractButton 



-actionCommand: String 
-text: String 
-icon: javax. swing. Icon 

-pressedlcon : javax . swi ng . Icon 
-rolloverlcon: javax. swing. Icon 
-mnemonic: int 

-horizontalAlignment: int 
-horizontalTextPosition: int 
-verti cal Al i gnment : int 
-verticalTextPosition: int 
-borderPai nted : boolean 



-iconTextCap: int 
-selectedQ: boolean 



The get and set methods for these data fields are provided 
in the class, but omitted in the UML diagram for brevity. 



The action command of this button. 

The button's text (i.e., the text label on the button). 

The button's default icon. This icon is also used as the "pressed" and 
"disabled" icon if there is no pressed icon set explicitly. 

The pressed icon (displayed when the button is pressed). 

The rollover icon (displayed when the mouse is over the button). 

The mnemonic key value of this button. You can select the button by 
pressing the ALT key and the mnemonic key at the same time. 

The horizontal alignment of the icon and text (default: CENTER). 

The horizontal text position relative to the icon (default: RIGHT). 

The vertical alignment of the icon and text (default: CENTER). 

The vertical text position relative to the icon (default: CENTER). 

Indicates whether the border of the button is painted. By default, a regular 

button's border is painted, but the borders for a check box and a radio 

button are not painted. 

The gap between the text and the icon on the button. 
The state of the button. True if the check box or radio button is selected, 
false if not. 



Figure 1 7.2 AbstractButton defines common features of different types of buttons. 



javax. swing. AbstractButton 



javax.swing.JButton 



+DButton() 

+3 Button (i con : j avax . swi ng . Icon) 

+D Button (text: String) 

+D Button (text: String, icon: Icon) 

+addActi on Li stener(l i stener : 
ActionListener) : void 



Creates a default button with no text and icon. 

Creates a button with an icon. 

Creates a button with text. 

Creates a button with text and an icon. 

Adds an Act i on Li stener for the button. 



Figure 1 7.3 JButton defines a regular push button. 



For example, Listing 17.1 displays the American flag as a regular icon, the Canadian flag as a 
pressed icon, and the British flag as a rollover icon, as shown in Figure 17.4. 

Listing 17.1 TestButtonlcons . java 

1 import javax.swing.*; 

2 

3 public class TestButtonlcons extends DFrame { 

4 public static void main(String[] args) { 

5 // Create a frame and set its properties 

6 JFrame frame = new TestButtonlconsO ; 

7 frame . setTi tl e("ButtonIcons") ; 

8 frame. setSize(200, 100); 

9 frame. setLocationRelativeTo(null) ; // Center the frame 
10 frame . setDef aul tCl oseOpe rati on (J Frame . EXIT_0N_CL0SE) ; 
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11 frame . setVi si bl e(true) ; 

12 } 
13 

14 public TestButtonlconsO { 

15 Imagelcon uslcon = new ImageIcon("image/usIcon.gif") 

16 Imagelcon calcon = new Imagelcon ("image/calcon.gif") 

17 Imagelcon uklcon = new ImageIcon("image/ukIcon.gif") 



regular icon 
pressed icon 
rollover icon 

add a button 




(a) Default icon (b) Pressed icon (c) Rollover icon 



Figure 1 7.4 A button can have several types of icons. 



17.2.2 Alignments 

horizontal alignment Horizontal alignment specifies how the icon and text are placed horizontally on a button. 

You can set the horizontal alignment using setHorizontal Al ignment(int) with one of 
the five constants LEADING, LEFT, CENTER, RIGHT, TRAILING, as shown in Figure 17.5. At 
present, LEADING and LEFT are the same, and TRAILING and RIGHT are the same. Future 
implementation may distinguish them. The default horizontal alignment is SwingCon- 
stants. CENTER. 



§ LEFT/LEADING 



jnjxj 



5 Denmark 



t 



# CENTER 



Denmark 



# RIGHT/TRAIL 



jnjxj 



Denmark 



Horizontally left Horizontally center 

Figure 1 7.5 You can specify how the icon and text are placed on a button horizontally. 



Horizontally right 



vertical alignment 



Vertical alignment specifies how the icon and text are placed vertically on a button. You 
can set the vertical alignment using setVertical Al ignment(int) with one of the three 
constants TOP, CENTER, BOTTOM, as shown in Figure 17.6. The default vertical alignment is 
Swi ngConstants . CENTER. 





£ Denmark 


> 









Denmark 



Denmark 



Vertically top Vertically center Vertically bottom 

Figure 1 7.6 You can specify how the icon and text are placed on a button vertically. 
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17.2.3 Text Positions 

Horizontal text position specifies the horizontal position of the text relative to the icon. You can horizontal text position 
set the horizontal text position using setHorizontalTextPosition(int) with one of the 
five constants LEADING, LEFT, CENTER, RIGHT, TRAILING, as shown in Figure 17.7. At present, 
LEADING and LEFT are the same, and TRAILING and RIGHT are the same. Future implementa- 
tion may distinguish them. The default horizontal text position is Swi ngConstants . RIGHT. 




EJlUi.LJM, _ I rix | 



Grapes 
A 



Text positioned left Text positioned center Text positioned right 

Figure 1 7.7 You can specify the horizontal position of the text relative to the icon. 



Vertical text position specifies the vertical position of the text relative to the icon. You can vertical text position 
set the vertical text position using setVerticalTextPosition(int) with one of the three 
constants TOP, CENTER, BOTTOM, as shown in Figure 17.8. The default vertical text position is 
Swi ngConstants . CENTER. 




Text positioned top Text positioned Text positioned bottom 

vertically center 

Figure 1 7.8 You can specify the vertical position of the text relative to the icon. 



t|| Note 

The constants LEFT, CENTER, RIGHT, LEADING, TRAILING, TOP, and BOTTOM used in 
AbstractButton are also used in many other Swing components. These constants are centrally 
defined in the javax. swing. Swi ngConstants interface. Since all Swing GUI components 

implement Swi ngConstants, you can reference the constants through Swi ngConstants or a SwingConstants 
GUI component. For example, SwingConstants .CENTER is the same as JButton. CENTER. 

JButton can fire many types of events, but often you need to add listeners to respond to an 
ActionEvent. When a button is pressed, it fires an ActionEvent. 



17.2.4 Using Buttons 

This section presents a program, shown in Listing 17.2, that displays a message on a panel 
and uses two buttons, <= and =>, to move the message on the panel to the left or right. The 
layout of the UI is shown in Figure 17.9. 
Here are the major steps in the program: 

1. Create the user interface. 

Create a MessagePanel object to display the message. The MessagePanel class was 
created in Listing 15.8, MessagePanel.java. Place it in the center of the frame. Create 
two buttons, <= and =>, on a panel. Place the panel in the south of the frame. 



Video Note 

Use buttons 
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2. Process the event. 

Create and register listeners for processing the action event to move the message left or 
right according to whether the left or right button was clicked. 



ButtonDemo 



Welcome to Java 



<= 



=> 



MessagePanel 



J Panel with 
FlowLayout 



Figure 1 7.9 Clicking the <= and => buttons causes the message on the panel to move to the 
left and right, respectively. 



Listing 17.2 ButtonDemo. java 



create frame 



create UI 



mnemonic 



1 
2 
3 
4 
5 
6 
7 
8 
9 
10 
11 
12 
13 
14 
15 
16 
17 
18 
19 
20 
21 
22 
23 
24 
25 
26 
27 
28 
29 
30 
31 
32 
33 
34 
35 
36 
37 
38 
39 
40 



import java. awt.*; 

import java . awt . event . Acti on Li stener ; 
import j ava . awt . event . Acti on Event ; 
import javax. swing.*; 

public class ButtonDemo extends JFrame { 

// Create a panel for displaying message 
protected MessagePanel messagePanel 
= new MessagePanel ("Wei come to Java"); 

// Declare two buttons to move the message left and 
private JButton jbtLeft = new JButton("<=") ; 
private JButton jbtRight = new JButton("=>") ; 



3 Frame 



ButtonDemo 



ri ght 



public static void main(String[] args) { 
ButtonDemo frame = new ButtonDemoO ; 
frame . setTi tl e ("ButtonDemo") ; 
frame.setSize(250, 100); 

frame. setLocationRelativeTo(null) ; // Center the frame 
frame . setDef aul tCl oseOpe rati on (1 Frame . EXIT_0N_CL0SE) ; 
frame.setVisible(true) ; 

} 

public ButtonDemoO { 

// Set the background color of messagePanel 
messagePanel .setBackground(Color. white) ; 



// 
// 
// 



// Create Panel jpButtons to hold two Buttons 
JPanel jpButtons = new JPanelO; 
jpButtons. add(jbtLeft) ; 
jpButtons .add(jbtRight) ; 

// Set keyboard mnemonics 
jbtLeft. setMnemonic('L') ; 
jbtRight. setMnemoni c (' R' ) ; 



// Set icons and remove text 

jbtLeft . setIcon(new Imagelcon ("image/1 eft .gi f ")) ; 
j btRi ght . setlcon (new Imagelcon ("i mage/ri ght . gi f ")) ; 
jbtLeft. setText(null) ; 



'<=" and "right =>' 
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41 
42 
43 
44 
45 
46 
47 
48 
49 
50 
51 
52 
53 
54 
55 
56 
57 
58 
59 
60 
61 
62 
63 
64 



// 



jbtRight. setText(null) ; 

// Set tool tip text on the buttons 

jbtLeft. setToolTipText("Move message to left"); 

jbtRight.setToolTipText("Move message to right"); 

// Place panels in the frame 
setLayout(new BorderLayoutO) ; 
add(messagePanel , BorderLayout. CENTER) ; 
add(jpButtons, BorderLayout . SOUTH) ; 

// Register listeners with the buttons 
jbtLeft. addActionListener(new ActionLi stener() { 
public void actionPerformed(ActionEvent e) { 
messagePanel .moveLeftO ; 

} 

}); 

jbtRight.addActionListener(new ActionLi stener() { 
public void actionPerformed(ActionEvent e) { 
messagePanel .moveRight() ; 

} 

}); 



tool tip 



register listener 



register listener 



} 



messagePanel (line 8) is deliberately declared protected so that it can be referenced by a 
subclass in future examples. 

You can set an icon image on the button by using the setlcon method. If you uncomment 
the following code in lines 38^-1: 

// jbtLeft. setlcon (new Imagelcon ("i mage/1 ef t. gi f ")) ; 
// jbtRight. setIcon(new ImageIcon("image/right.gif")) ; 
// jbtLeft. setText(null) ; 
// jbtRight. setText(null) ; 

the texts are replaced by the icons, as shown in Figure 17.10(a). "i mage/1 eft.gif" is 
located in "c : \book\i mage\l eft . gi f ". Note that the backslash is the Windows file-path 
notation. In Java, the forward slash should be used. 



LJ - ]lljjiLI,]JJi1 — Loi^i 



Welcome to Java 



Welcome to Java 



* Left 
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# ButtonDem 



Welcome to Java 



II 



| Move rnessag 
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ght Ait-R 



(a) (b) (c) 

Figure 1 7.10 You can set an icon on a JButton and access a button using its mnemonic key. 



You can set text and an icon on a button at the same time, if you wish, as shown in Figure 
17.10(b). By default, the text and icon are centered horizontally and vertically. 

The button can also be accessed by using the keyboard mnemonics. Pressing Alt+L is 
equivalent to clicking the <= button, since you set the mnemonic property to ' L 1 in the left but- 
ton (line 34). If you change the left button text to "Left" and the right button text to "Right", 
the L and R in the captions of these buttons will be underlined, as shown in Figure 17.10(b). 
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Each button has a tool tip text (lines 44-45), which appears when the mouse is set on the 
button without being clicked, as shown in Figure 17.10(c). 



locating MessagePanel 



Note 

Since MessagePanel is not in the Java API, you should place MessagePanel. java in the same 
directory with ButtonDemo.java. 



toggle button 



Video Note 

Use check boxes 



7.3 Check Boxes 



A toggle button is a two-state button like a light switch. JToggl eButton inherits 
AbstractButton and implements a toggle button. Often JToggl eButton's subclasses 
JCheckBox and JRadioButton are used to enable the user to toggle a choice on or off. This 
section introduces JCheckBox. JRadioButton will be introduced in the next section. 

JCheckBox inherits all the properties from AbstractButton, such as text, icon, 
mnemonic, verticalAl ignment, horizontalAl ignment, horizontalTextPosition, 
verticalTextPosition, and selected, and provides several constructors to create check 
boxes, as shown in Figure 17.11. 



javax. swi ng . AbstractButton 

2 F 

j avax . swi ng . JToggl eButton 
javax.swing.JCheckBox 



+DCheckBoxO 




+DCheckBox(text : 


Stri ng) 


+DCheckBox(text : 


String, selected: 


boolean) 




+DCheckBox(i con : 


Icon) 


+DCheckBox(text : 


String, icon: Icon) 


+DCheckBox(text : 


String, icon: Icon, 


selected: boolean) 


+addActionl_i stener(l i stener: 


ActionListener) 


: void 


+addlteml_i stener(l i stener : ItemLi stener) 


: void 





Creates a default check box button with no text and icon. 
Creates a check box with text. 

Creates a check box with text and specifies whether the check box is 

initially selected. 
Creates a checkbox with an icon. 
Creates a checkbox with text and an icon. 

Creates a check box with text and an icon, and specifies whether the check 

box is initially selected. 
Adds an Acti onLi stener for this object. 

Adds an ItemLi stener for this object. 



Figure 17.1 1 JCheckBox defines a check box button. 



Here is an example of a check box with text Student, foreground red, background white, 
mnemonic key ' S ' , and initially selected. 

JCheckBox jchk = new DCheckBox("Student" , true); 
jchk. setForeg round (Col or . RED) ; 

jchk. setBackgroundfColor. WHITE) ; ^ StJdent 

jchk.setMnemonic('S') ; 

When a check box is clicked (checked or unchecked), it fires an ItemEvent and then an 
ActionEvent. To see if a check box is selected, use the i sSel ectedO method. 

Listing 17.3 gives a program that adds three check boxes named Centered, Bold, and Italic 
to the preceding example to let the user specify whether the message is centered, bold, or 
italic, as shown in Figure 17.12. 
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Welcome to Java 
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E Bold -*- 
E Italic 


Left Right 







] Panel with 
Gri dLayout for 
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Figure 1 7.12 Three check boxes are added to specify how the message is displayed. 



There are at least two approaches to writing this program. The first is to revise the preced- 
ing ButtonDemo class to insert the code for adding the check boxes and processing their 
events. The second is to create a subclass that extends ButtonDemo. Please implement the 
first approach as an exercise. Listing 17.3 gives the code to implement the second approach. 

Listing 17.3 CheckBoxDemo. java 



1 

2 
3 
4 
5 
6 
7 
8 
9 
10 
11 
12 
13 
14 
15 
16 
17 
18 
19 
20 
21 
22 
23 
24 
25 
26 
27 
28 
29 
30 
31 
32 
33 
34 
35 
36 
37 
38 
39 
40 



import java.awt.*; 
import java. awt . event .* ; 
import javax. swing.*; 

public class CheckBoxDemo extends ButtonDemo { 

// Create three check boxes to control the display of message 
private JCheckBox jchkCentered = new JCheckBox("Centered") ; 
private JCheckBox jchkBold = new JCheckBox("Bol d") ; 
private JCheckBox jchkltalic = new JCheckBox("Ital ic") ; 

public static void main(String[] args) { 
CheckBoxDemo frame = new CheckBoxDemo () ; 
frame . setTi tl e ("CheckBoxDemo") ; 
frame. setSize(500, 200); 

frame. setLocationRelativeTo(null) ; // Center the frame 
frame . setDef aul tCl oseOpe rati on (J Frame . EXIT„0N„CL0SE) ; 
frame . setVi si bl e (true) ; 

} 

public CheckBoxDemoO { 

// Set mnemonic keys 
jchkCentered. setMnemonic('C') ; 
jchkBold. setMnemonic('B') ; 
jchkltalic.setMnemonic('I') ; 

// Create a new panel to hold check boxes 
JPanel jpCheckBoxes = new JPanel (); 
jpCheckBoxes . setLayout(new Gri dLayout(3 , 1)); 
jpCheckBoxes .add(jchkCentered) ; 
jpCheckBoxes .add(jchkBold) ; 
jpCheckBoxes . add(jchkltal i c) ; 
add(jpCheckBoxes , BorderLayout . EAST) ; 

// Register listeners with the check boxes 
jchkCentered. addActi onLi stener(new Acti onLi stener() { 
public void actionPerformed(ActionEvent e) { 

messagePanel . setCente red (jchkCentered . i sSel ected()) ; 

} 

}); 

jchkBold. addActi onLi stener(new Acti onLi stener() { 



3 Frame 



ButtonDemo 



CheckBoxDemo 



create frame 



create UI 



register listener 



register listener 
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41 public void actionPerformed(ActionEvent e) { 

42 setNewFontO ; 

43 } 

44 }); 

45 jchkItalic.addActionListener(new ActionLi stenerO { 

46 public void actionPerformed(ActionEvent e) { 

47 setNewFontO ; 

48 } 

49 }); 

50 } 
51 



set a new font 52 private void setNewFontO { 

53 // Determine a font style 



54 int fontStyle = Font. PLAIN; 

55 fontStyle += (jchkBold.isSelected() ? Font. BOLD : Font. PLAIN); 

56 fontStyle += (jchkltal i c . i sSel ectedfj ? Font. ITALIC : Font. PLAIN); 
57 

58 // Set font for the message 

59 Font font = messagePanel . getFontO ; 

60 messagePanel . setFont( 

61 new Font(font . getName() , fontStyle, font.getSizeO)) ; 

62 } 

63 } 

CheckBoxDemo extends ButtonDemo and adds three check boxes to control how the mes- 
sage is displayed. When a CheckBoxDemo is constructed (line 12), its superclass's no-arg 
constructor is invoked, so you don't have to rewrite the code that is already in the constructor 
of ButtonDemo. 

When a check box is checked or unchecked, the listener's actionPerformed method is 
invoked to process the event. When the Centered check box is checked or unchecked, the 
centered property of the MessagePanel class is set to true or fal se. 

The current font name and size used in MessagePanel are obtained from mes- 
sagePanel .getFontO using the getNameO and getSizeO methods. The font styles 
(Font . BOLD and Font . ITALIC) are specified in the check boxes. If no font style is selected, 
the font style is Font . PLAIN. Font styles are combined by adding together the selected inte- 
gers representing the fonts. 

The keyboard mnemonics C, B, and / are set on the check boxes Centered, Bold, and 
Italic, respectively (lines 22-24). You can use a mouse click or a shortcut key to select a 
check box. 

The setFont method (line 60) defined in the Component class is inherited in the 
MessagePanel class. This method automatically invokes the repaint method. Invoking 
setFont in messagePanel automatically repaints the message. 

A check box fires an ActionEvent and an ItemEvent when it is clicked. You could process 
either the Acti onEvent or the ItemEvent to redisplay the message. The example processes the 
ActionEvent. If you wish to process the ItemEvent, create a listener for ItemEvent and reg- 
ister it with a check box. The listener must implement the itemStateChanged handler to 
process an ItemEvent. For example, the following code registers an ItemListener with 
jchkCentered: 

// To listen for ItemEvent 

jchkCentered. addltemLi stener(new ItemLi stenerO { 

/** Handle ItemEvent */ 

public void i temStateChanged(ItemEvent e) { 

messagePanel . setCente red (jchkCentered . isSelectedO) ; 

} 

}); 
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1 7.4 Radio Buttons 



Radio buttons, also known as option buttons, enable you to choose a single item from a group 
of choices. In appearance radio buttons resemble check boxes, but check boxes display a 
square that is either checked or blank, whereas radio buttons display a circle that is either 
filled (if selected) or blank (if not selected). 

JRadioButton inherits AbstractButton and provides several constructors to create 
radio buttons, as shown in Figure 17.13. These constructors are similar to the constructors for 
JCheckBox. 



Video Note 

Use radio buttons 



javax. swing. AbstractButton 



j avax . swi ng . JToggl eButton 



T 



j avax.s wing. JRadioButton 



+JRadioButton() 
+DRadioButton(text: String) 

+JRadioButton(text: String, selected: 
bool ean) 

+DRadioButton(icon: Icon) 

+DRadioButton(text: String, icon: Icon) 

+DRadioButton(text: String, icon: Icon, 
selected: boolean) 

+addActi onEvent(l i stener : 
ActionLi stener) : void 

+addlteml_i stener (1 i stener : ItemLi stener) 
: void 



Creates a default radio button with no text and icon. 
Creates a radio button with text. 

Creates a radio button with text and specifies whether the radio button is 
initially selected. 

Creates a radio button with an icon. 

Creates a radio button with text and an icon. 

Creates a radio button with text and an icon, and specifies whether the 
radio button is initially selected. 

Adds an Acti onLi stener for this object. 
Adds an ItemLi stener for this object. 



Figure 17.13 JRadioButton defines a radio button. 



Here is an example of a radio button with text Student, red foreground, white back- 
ground, mnemonic key S, and initially selected. 

JRadioButton jrb = new JRadioButton("Student" , true); 
jrb.setForeground(Color.RED) ; 



jrb. setBackground(Color. WHITE) ; ® Student 

jrb.setMnemonic('S') ; 

To group radio buttons, you need to create an instance of java . swing . ButtonGroup and 
use the add method to add them to it, as follows: 

ButtonGroup group = new ButtonCroupO ; 
group. add(jrbl) ; 
group. add(jrb2) ; 



This code creates a radio-button group for radio buttons j rbl and j rb2 so that they are 
selected mutually exclusively. Without grouping, j rbl and jrb2 would be independent. 
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# Note 

GUI helper class ButtonGroup is not a subclass of java.awt. Component, so a ButtonCroup object can- 

not be added to a container. 

When a radio button is changed (selected or deselected), it fires an ItemEvent and then an 
ActionEvent. To see if a radio button is selected, use the isSelectedO method. 

Listing 17.4 gives a program that adds three radio buttons named Red, Green, and Blue 
to the preceding example to let the user choose the color of the message, as shown in 
Figure 17.14. 
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Figure 1 7.14 Three radio buttons are added to specify the color of the message. 



create frame 



create UI 



Again there are at least two approaches to writing this program. The first is to revise the 
preceding CheckBoxDemo class to insert the code for adding the radio buttons and processing 
their events. The second is to create a subclass that extends CheckBoxDemo. Listing 17.4 
gives the code to implement the second approach. 

Listing 17.4 RadioButtonDemo. java 



1 

2 
3 
4 
5 
6 
7 
8 
9 
10 
11 
12 
13 
14 
15 
16 
17 
18 
19 
20 
21 
22 
23 
24 



import java.awt.'-; 
import java. awt . event .* ; 
import javax. swing.*; 

public class RadioButtonDemo extends CheckBoxDemo { 

// Declare radio buttons 

private JRadioButton jrbRed, jrbGreen, jrbBlue; 



3 Frame 



ButtonDemo 



CheckBoxDemo 



public static void main(String[] args) { 

RadioButtonDemo frame = new Radi oButtonDemoO ; 
frame. setSize(500, 200); 
frame. setLocationRelativeTo(null) ; // Center the frame 
frame . setDef aul tCl oseOpe rati on (D Frame . EXIT_0N_CL0SE) ; 
frame . setTi tl e ("RadioButtonDemo") ; 
frame . setVi si bl e (true) ; 

} 

public RadioButtonDemoO { 

// Create a new panel to hold check boxes 
JPanel jpRadi oButtons = new DPanelQ; 
jpRadioButtons.setLayout(new Cri dLayout(3 , 1)); 
jpRadioButtons.add(jrbRed = new JRadioButton("Red")) ; 
jpRadioButtons.add(jrbCreen = new DRadioButton("Green")) ; 
jpRadioButtons.add(jrbBlue = new JRadioButton ("Blue")) ; 



RadioButtonDemo 
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25 adcKjpRadioButtons , BorderLayout.WEST) ; 
26 

27 // Create a radio-button group to group three buttons 

28 ButtonCroup group = new ButtonGroupO ; groupbuttons 

29 group . add(j rbRed) ; 

30 group . add(j rbCreen) ; 

31 group. add(jrbBlue) ; 
32 

33 // Set keyboard mnemonics 

34 jrbRed.setMnemonic('E') ; 

35 jrbCreen.setMnemonic('G') ; 

36 jrbBlue.setMnemonic('U') ; 
37 

38 // Register listeners for radio buttons 

39 j rbRed . addActi onLi stener(new Acti onLi stenerO { register listener 

40 public void actionPerformed(ActionEvent e) { 

41 messagePanel .setForeground(Color. red) ; 

42 } 

43 }); 

44 j rbCreen . addActi onLi stener(new ActionLi stenerO { register listener 

45 public void actionPerformed(ActionEvent e) { 

46 messagePanel .setForeground(Color. green) ; 

47 } 

48 }); 

49 jrbBlue.addActionListener(new ActionLi stenerO { register listener 

50 public void actionPerformed(ActionEvent e) { 

51 messagePanel .setForeground(Color.blue) ; 

52 } 

53 }); 
54 

55 // Set initial message color to blue 

56 jrbBlue.setSelected(true) ; 

57 messagePanel .setForeground(Color.blue) ; 



58 } 

59 } 

RadioButtonDemo extends CheckBoxDemo and adds three radio buttons to specify the mes- 
sage color. When a radio button is clicked, its action event listener sets the corresponding 
foreground color in messagePanel . 

The keyboard mnemonics ' R ' and ' B ' are already set for the Right button and Bold check 
box. To avoid conflict, the keyboard mnemonics ' E ' , ' G ' , and ' U ' are set on the radio but- 
tons Red, Green, and Blue, respectively (lines 34-36). 

The program creates a ButtonGroup and puts three JRadioButton instances (j rbRed, 
j rbGreen, and j rbBl ue) in the group (lines 28-31). 

A radio button fires an ActionEvent and an ItemEvent when it is selected or dese- 
lected. You could process either the ActionEvent or the ItemEvent to choose a color. The 
example processes the ActionEvent. Please rewrite the code using the ItemEvent as an 
exercise. 

17.5 Labels 

A label is a display area for a short text, an image, or both. It is often used to label other com- 
ponents (usually text fields). Figure 17.15 lists the constructors and methods in 3 Label . 

J Label inherits all the properties from ^Component and has many properties similar to the 
ones in JButton, such as text, icon, horizontalAl ignment, verticalAl ignment, 
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horizontalTextPosition, verticalTextPosition, and iconTextGap. For example, 
the following code displays a label with text and an icon: 



// Create an image icon from an image file 
Imagelcon icon = new Imagelcon ("i mage/grapes . gif ") ; 

// Create a label with a text, an icon, 

// with centered horizontal alignment ^^^^^^^^^^^^^^^^ 
JLabel jlbl = new JLabel ("Grapes" , icon, Swi ngConstants. CENTER) ; 




//Set label's text alignment and gap between te*t— ancM con 
jl bl . setHorizontalTextPosi tion(Swi ngConstants .CENTER) ; 
j 1 bl . setVerti cal TextPosi ti on (Swi ngConstants . BOTTOM) ; 
jl bl . set!conTextGap(5) ; 



javax. swing. JComponent 





javax.swing.JLabel 


-text: String 






-icon: javax. 


swi ng . Icon 




-horizontalAlignment: int 




-horizontalTextPosition: int 




-verti cal Al i gnment : int 




-verticalTextPosition: int 




-iconTextGap: 


i nt 




+JLabel () 






+J Label (icon: 


j avax . swi ng . Icon) 




+J Label (icon: 


Icon, hAli gnment: 


int) 


+J Label (text: 


Stri ng) 




+J Label (text: 


String, icon: Icon 




hAli gnment: 


int) 




+D Label (text: 


String, hAli gnment 


: int) 



The get and set methods for these data fields are provided 
in the class, but omitted in the UML diagram for brevity 



The label's text. 

The label's image icon. 

The horizontal alignment of the text and icon on the label. 
The horizontal text position relative to the icon on the label. 
The vertical alignment of the text and icon on the label. 
The vertical text position relative to the icon on the label. 
The gap between the text and the icon on the label. 

Creates a default label with no text and icon. 
Creates a label with an icon. 

Creates a label with an icon and the specified horizontal alignment. 
Creates a label with text. 

Creates a label with text, an icon, and the specified horizontal alignment. 
Creates a label with text and the specified horizontal alignment. 



Figure 1 7.1 5 JLabel displays text or an icon, or both. 



1 7.6 Text Fields 

A text field can be used to enter or display a string. JTextField is a subclass of 
JTextComponent. Figure 17.16 lists the constructors and methods in JTextField. 

JTextField inherits JTextComponent, which inherits JComponent. Here is an 
example of creating a text field with red foreground color and right horizontal 
alignment: 

JTextField jtfMessage = new JTextField("T-Strom") ; 
j tf Message . setForeg round (Col or . RED) ; 

jtfMessage . setHori zontal Al i gnment (Swi ngConstants . RIGHT) ; 

When you move the cursor in the text field and press the Enter key, it fires an ActionEvent. 

Listing 17.5 gives a program that adds a text field to the preceding example to let the user 
set a new message, as shown in Figure 17.17. 




Video Note 

Use labels and text fields 
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javax. swing. text. JTextComponent 



-text: String 
-editable: boolean 



javax.swing.JTextField 



-columns: int 
-horizontalAlignment: int 




+JTextField() 
+JTextFi el d(col umn : int) 
+JTextFi el d(text : String) 
+JTextFi el d(text : String, columns: int) 
+addActionEvent(listener: ActionListener) : 
void 



The get and set methods for these data fields are provided 
in the class, but omitted in the UML diagram for brevity 



The text contained in this text component. 
Indicates whether this text component is editable (default: true). 



The number of columns in this text field. 
The horizontal alignment of this text field (default: LEFT). 
Creates a default empty text field with number of columns set to 0. 
Creates an empty text field with a specified number of columns. 
Creates a text field initialized with the specified text. 
Creates a text field initialized with the specified text and columns. 
Adds an Acti onLi stener for this object. 



Figure 1 7. 1 6 JTextFi el d enables you to enter or display a string. 
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Figure 1 7. 1 7 A label and a text field are added to set a new message. 



Listing 17.5 TextFieldDemo. java 



1 

2 
3 
4 
5 
6 
7 
8 
9 
10 
11 
12 
13 
14 
15 
16 
17 
18 
19 
20 
21 



import java.awt.*; 
import java. awt . event .* ; 
import javax. swing.*; 

public class TextFieldDemo extends RadioButtonDemo { 
private JTextField jtfMessage = new JTextFi eld (10) ; 

/** Main method */ 

public static void main(String[] args) { 
TextFieldDemo frame = new TextFi el dDemo() ; 
frame . pack() ; 

frame . setTi tl e ("TextFiel dDemo") ; 

frame. setLocationRelativeTo(null) ; // Center the frame 
frame . setDef aul tCl oseOperati on (J Frame . EXIT„0N„CL0SE) ; 
frame . setVi si bl e (true) ; 

} 

public TextFi el dDemo() { 

// Create a new panel to hold label and text field 
J Panel jpTextField = new DPanelO; 
jpTextField.setLayout(new BorderLayout(5 , 0)); 
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create frame 
pack frame 



create UI 
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listener 



packO 

requestFocuslnWindow() 



jpTextField.add( 

new JLabel ("Enter a new message"), BorderLayout .WEST) ; 
j pText Fi el d . add ( j tf Message , Borde rLayout . CENTER) ; 
add(jpTextField, BorderLayout . NORTH) ; 

jtf Message . setHori zontal Al ignment(XTextFi eld . RIGHT) ; 

// Register listener 

jtfMessage . addActionLi stener(new ActionLi stenerO { 

/** Handle ActionEvent */ 

public void actionPerformed(ActionEvent e) { 
messagePanel . setMessage(jtfMessage . getTextO) ; 
jtfMessage . requestFocusInWi ndow() ; 

} 

}); 



22 
23 
24 
25 
26 
27 
28 
29 
30 
31 
32 
33 
34 
35 
36 

37 } 

38 } 

TextFiel dDemo extends RadioButtonDemo and adds a label and a text field to let the user 
enter a new message. After you set a new message in the text field and press the Enter key, a 
new message is displayed. Pressing the Enter key on the text field triggers an action event. 
The listener sets a new message in messagePanel (line 33). 

The pack() method (line 11) automatically sizes the frame according to the size of the 
components placed in it. 

The requestFocusInWi ndow() method (line 34) defined in the Component class requests 
the component to receive input focus. Thus, jtfMessage. requestFocusInWi ndow() 
requests the input focus on jtfMessage. You will see the cursor on jtfMessage after the 
actionPerformed method is invoked. 



IP Note 

JPasswordField [f a text field is used for entering a password, use JPasswordField to replace JTextField. 

JPasswordField extends JTextField and hides the input text with echo characters (e.g., 
*****«). By default, the echo character is *. You can specify a new echo character using the 
setEchoChar(char) method. 



1 7.7 Text Areas 

If you want to let the user enter multiple lines of text, you have to create several instances of 
JTextFiel d. A better alternative is to use JTextArea, which enables the user to enter mul- 
tiple lines of text. Figure 17.18 lists the constructors and methods in JTextArea. 

Like JTextField, JTextArea inherits JTextComponent, which contains the methods 
getText, setText, i sEdi tabl e, and setEdi tabl e. Here is an example of creating a text 
area with 5 rows and 20 columns, line-wrapped on words, red foreground color, and 
Courier font, bold, 20 pixels. 

DTextArea jtaNote = new JTextArea("This is a text area", 5, 20); 
wrap line jtaNote . setLi neWrap(true) ; 

wrap word jtaNote . setWrapStyl eWord (true) ; 

jtaNote. setForeground(Color. red) ; 

jtaNote. setFont(new Font("Courier" , Font. BOLD, 20)); 

JTextArea does not handle scrolling, but you can create a JScrol 1 Pane object to hold an 
instance of JTextArea and let JScrollPane handle scrolling for JTextArea, as follows: 

// Create a scroll pane to hold text area 

DScrollPane scrollPane = new J Sc roll Pane (jta = new JTextAreaO) ; 
add(scroll Pane, BorderLayout. CENTER) ; 
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Listing 17.7 gives a program that displays an image and a text in a label, and a text in a text 
area, as shown in Figure 17.19. 



javax. swing. text . JTextComponent 





javax.swing.JTextArea 


-columns: int 




-rows: int 




-tabSize: int 




-lineWrap: boolean 




-wrapStyleWord: boolean 




+JTextArea() 




+]TextArea(rows : int, columns: 


int) 


+]TextArea(text: String) 




+]TextArea(text: String, rows: 


int, columns: int) 


+append(s: String): void 




+insert(s: String, pos: int): 


void 


+replaceRange(s: String, start 


: int, end: int): 


void 




+getLi neCount() : int 





The get and set methods for these data fields are provided 
in the class, but omitted in the UML diagram for brevity. 



The number of columns in this text area. 

The number of rows in this text area. 

The number of characters used to expand tabs (default: 8). 

Indicates whether the line in the text area is automatically 

wrapped (default: false). 
Indicates whether the line is wrapped on words or characters (default: false). 

Creates a default empty text area. 

Creates an empty text area with the specified number of rows and columns. 
Creates a new text area with the specified text displayed. 

Creates a new text area with the specified text and number of rows and columns. 

Appends the string to text in the text area. 

Inserts string s in the specified position in the text area. 

Replaces partial text in the range from position start to end with string s. 

Returns the actual number of lines contained in the text area. 



Figure 1 7. 1 8 JTextArea enables you to enter or display multiple lines of characters. 
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Figure 1 7. 1 9 The program displays an image in a label, a title in a label, and a text in the text area. 
Here are the major steps in the program: 

1. Create a class named DescriptionPanel that extends JPanel, as shown in Listing 
17.6. This class contains a text area inside a scroll pane, and a label for displaying an 
image icon and a title. This class is used in the present example and will be reused in 
later examples. 

2. Create a class named TextAreaDemo that extends J Frame, as shown in Listing 17.7. 
Create an instance of DescriptionPanel and add it to the center of the frame. The rela- 
tionship between DescriptionPanel and TextAreaDemo is shown in Figure 17.20. 

Listing 17.6 DescriptionPanel .java 



import javax. swi ng . * ; 
import java.awt.*; 

public class DescriptionPanel extends DPanel { 

/** Label for displaying an image icon and a text */ 
private JLabel jlbllmageTitle = new DLabelQ; 



label 



588 Chapter 17 Creating Graphical User Interfaces 



label properties 



wrap line 
wrap word 
read only 



scroll pane 
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27 
28 
29 
30 
31 
32 
33 
34 
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36 
37 
38 
39 
40 
41 
42 
43 
44 
45 
46 
47 
48 

49 } 



/** Text area for displaying text */ 

private JTextArea jtaDescri ption = new DTextAreaO ; 

public Descri pti onPanel () { 

// Center the icon and text and place the text under the icon 
j 1 bl ImageTi tl e . setHori zontal Al i gnment ( J Label . CENTER) ; 
j 1 bl ImageTi tl e . setHori zontal TextPosi ti on (J Label . CENTER) ; 
j 1 bl ImageTi tl e . setVerti cal TextPosi ti on (3 Label . BOTTOM) ; 

// Set the font in the label and the text field 

jlbl ImageTi tle.setFont (new Font("SansSerif" , Font. BOLD, 16)); 

jtaDescri ption . setFont(new Font("Seri f" , Font. PLAIN, 14)); 

// Set lineWrap and wrapStyl eWord true for the text area 
jtaDescri ption . setLi neWrap(true) ; 
jtaDescri ption . setWrapStyl eWord(true) ; 
jtaDescri ption . setEdi tab! e(fal se) ; 



// Create a scroll pane 
JScrollPane scroll Pane = 



to hold the text area 
new JScrol 1 Pane(jtaDescri ption) ; 



// Set BorderLayout for the panel, add label and scrollpane 
setLayout(new BorderLayout(5 , 5)); 
add(scrol 1 Pane , BorderLayout . CENTER) ; 
add (jlbl ImageTi tie, BorderLayout. WEST) ; 



} 



/** Set the title */ 
public void setTitle(String title) { 
jlbl ImageTi tl e . setText (ti tl e) ; 

} 

/** Set the image icon */ 
public void setImageIcon(ImageIcon icon) { 
jlbl ImageTi tl e . setlcon (i con) ; 

} 

/** Set the text description */ 
public void setDescription(String text) { 
jtaDescri ption . setText(text) ; 

} 



javax. swi ng . 3 Panel | 



j avax . swi ng . 1 Frame 
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+setTitle(title: String): void 
+setDescription(text: String): void 



Figure 17.20 TextAreaDemo uses DescriptionPanel to display an image, title, and 
text description of a national flag. 
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The text area is inside a JScroll Pane (line 27), which provides scrolling functions for the 
text area. Scroll bars automatically appear if there is more text than the physical size of the 
text area, and disappear if the text is deleted and the remaining text does not exceed the text 
area size. 

The 1 ineWrap property is set to true (line 22) so that the line is automatically wrapped 
when the text cannot fit in one line. The wrapStyl eWord property is set to true (line 23) so 
that the line is wrapped on words rather than characters. The text area is set nonedi table (line 
24), so you cannot edit the description in the text area. 

It is not necessary to create a separate class for Descri ptionPanel in this example. Nev- 
ertheless, this class was created for reuse in the next section, where you will use it to display 
a description panel for various images. 

Listing 17.7 TextAreaDemo. java 

1 import java.awt.*; 

2 import javax. swing.*; 
3 

4 public class TextAreaDemo extends J Frame { 



5 // Declare and create a description panel 

6 private Descri ptionPanel descri ptionPanel = new Descri pti onPanel () ; create decriptionPanel 
7 

8 public static void main(String[] args) { 

9 TextAreaDemo frame = new TextAreaDemo () ; create frame 

10 frame . pack() ; 

11 frame. setLocationRelativeTo(null) ; // Center the frame 

12 frame . setDef aul tCl oseOperati on (1 Frame . EXIT_0N_CL0SE) ; 

13 frame. setTi tie ("TextAreaDemo") ; 

14 frame.setVisible(true) ; 

15 } 
16 

17 public TextAreaDemoO { 

18 // Set title, text and image in the description panel create Ul 

19 descri ptionPanel . setTi tl e("Canada") ; 

20 String description = "The Maple Leaf flag \n\n" + 

21 "The Canadian National Flag was adopted by the Canadian " + 

22 "Parliament on October 22, 1964 and was proclaimed into law " + 

23 "by Her Majesty Queen Elizabeth II (the Queen of Canada) on " + 

24 "February 15, 1965. The Canadian Flag (colloquially known " + 
2 5 "as The Maple Leaf Flag) is a red flag of the proportions " + 

26 "two by length and one by width, containing in its center a " + 

27 "white square, with a single red stylized eleven-point " + 

28 "maple leaf centered in the white square."; 

29 descri ptionPanel .setDescription(description) ; 

30 descri ptionPanel . setImageIcon(new ImageIcon("image/ca.gif")) ; 
31 

32 // Add the description panel to the frame 

33 setLayout(new BorderLayoutO) ; 

34 add(descriptionPanel , BorderLayout . CENTER) ; add decriptionPanel 

35 } 



36 } 

TextAreaDemo simply creates an instance of DescriptionPanel (line 6) and sets the title 
(line 19), image (line 30), and text in the description panel (line 29). DescriptionPanel is 
a subclass of JPanel . DescriptionPanel contains a label for displaying an image icon and 
a text title, and a text area for displaying a description of the image. 
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1 7.8 Combo Boxes 

A combo box, also known as a choice list or drop-down list, contains a list of items from 
which the user can choose. It is useful in limiting a user's range of choices and avoids the 
cumbersome validation of data input. Figure 17.21 lists several frequently used constructors 
and methods in JComboBox. 



javax. swi ng . JComponent 

javax.swing.JComboBox 

+JComboBox() 

+JComboBox(i terns : Object []) 

+addltem(item: Object): void 

+getItemAt(i ndex : int): Object 

+getItemCount() : int 

+getSel ectedlndex() : int 

+setSelectedIndex(index: int): void 

+getSel ectedltem() : Object 

+setSelectedItem(item: Object): void 

+removeltem(an0bject : Object): void 

+removeItemAt(anIndex: int): void 

+removeAl 1 Items() : void 

+addActionEvent(l i stener: 
ActionListener) : void 

+addlteml_i stener (1 i stener : 
ItemLi stener) : void 



Figure 1 7.2 1 JComboBox enables you to select an item from a set of items. 

The following statements create a combo box with four items, red foreground, white back- 
ground, and the second item selected. 

JComboBox jcb = new JComboBox (new 0bject[] 

{"Item 1", "Item 2", "Item 3", "Item 4"}); 
jcb.setForeground(Color. red) ; 
jcb. setBackground(Color. white) ; 
jcb.setSelectedItem("Item 2"); 

JComboBox can fire ActionEvent and ItemEvent, among many other events. Whenever an 
item is selected, an ActionEvent is fired. Whenever a new item is selected, JComboBox fires 
ItemEvent twice, once for deselecting the previously selected item, and the other for selecting 
the currently selected item. Note that no ItemEvent is fired if the current item is reselected. To 
respond to an ItemEvent, you need to implement the itemStateChanged (ItemEvent e) 
handler for processing a choice. To get data from a JComboBox menu, you can use 
getSel ectedltemO to return the currently selected item, or e . getltemO method to get the 
item from the i temStateChanged (ItemEvent e) handler. 

Listing 17.8 gives a program that lets users view an image and a description of a country's 
flag by selecting the country from a combo box, as shown in Figure 17.22. 

Here are the major steps in the program: 

1 . Create the user interface. 

Create a combo box with country names as its selection values. Create a Descrip- 
tionPanel object. The DescriptionPanel class was introduced in the preceding 




Creates a default empty combo box. 

Creates a combo box that contains the elements in the specified array. 

Adds an item to the combo box. 

Returns the item at the specified index. 

Returns the number of items in the combo box. 

Returns the index of the selected item. 

Sets the selected index in the combo box. 

Returns the selected item. 

Sets the selected item in the combo box. 

Removes an item from the item list. 

Removes the item at the specified index in the combo box. 
Removes all the items in the combo box. 
Adds an Action Li stener for this object. 

Adds an ItemLi stener for this object. 



Item 2 




Item 1 


Item 2 


Item 3 




Item 4 
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, ComboBoKDemo 



Canada 



Canada 



,_\n 




The Maple Leaf flag 

The Canadian National Flag was| 
adopted by the Canadian 
Parliament on October 22, 1964 
and was proclaimed into law by 



Combo box 



DescriptionPanel 



Figure 1 7.22 A country's info, including a flag image and a description of the flag, is dis- 
played when the country is selected in the combo box. 



example. Place the combo box in the north of the frame and the description panel in the 
center of the frame. 

2. Process the event. 

Create a listener to implement the itemStateChanged handler to set the flag title, 
image, and text in the description panel for the selected country name. 

Listing 17.8 ComboBoxDemo. java 



i 

2 
3 
4 
5 
6 
7 
8 
9 
10 
11 
12 
13 
14 
15 
16 
17 
18 
19 
20 
21 
22 
23 
24 
25 
26 
27 
28 
29 
30 
31 
32 
33 
34 



import java.awt.*; 
import java. awt . event .* ; 
import javax. swi ng . * ; 

public class ComboBoxDemo extends J Frame { 

// Declare an array of Strings for flag titles 

private String[] flagTitles = {"Canada", "China", "Denmark", 

"France", "Germany", "India", "Norway", "United Kingdom", 

"United States of America"}; 

// Declare an Imagelcon array for the national flags of 9 countries 
private Imagelcon [] flaglmage = { 

new Imagelcon ("image/ca. gi f ") , 

new Imagelcon ("image/china. gif") , 

new ImageIcon("image/denmark.gif") , 

new Imagelcon ("image/fr .gif") , 

new ImagelconC'image/germany.gif") , 

new ImagelconC'image/india.gif") , 

new ImagelconC'image/norway.gif") , 

new ImageIcon("image/uk.gif") , 

new Imagelcon ("image/us. gif") 

}; 

// Declare an array of strings for flag descriptions 
private String[] flagDescri ption = new String[9]; 



country 



image icon 



description 



// Declare and create a description panel 
private DescriptionPanel descri pti onPanel 



new Descri pti onPanel () ; 



// Create a combo box for selecting countries 
private JComboBox jcbo = new DComboBox (flagTitles) ; 

public static void main(String[] args) { 
ComboBoxDemo frame = new ComboBoxDemo () ; 



combo box 
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create UI 



listener 



35 
36 
37 
38 
39 
40 
41 
42 
43 
44 
45 
46 
47 
48 
49 
50 
51 
52 
53 
54 
55 
56 
57 
58 
59 
60 
61 
62 
63 
64 
65 
66 
67 
68 
69 
70 
71 
72 
73 
74 
75 
76 
77 
78 
79 
80 
81 
82 
83 

84 } 



frame . pack() ; 

frame . setTi tl e("ComboBoxDemo") ; 

frame. setLocationRelativeTo(null) ; // Center the frame 
frame . setDef aul tCl oseOpe rati on (D Frame . EXIT_0N_CL0SE) ; 
frame . setVi si bl e (true) ; 

} 

public ComboBoxDemoO { 

// Set text description 

fl agDescri pti on [0] = "The Maple Leaf flag \n\n" + 

"The Canadian National Flag was adopted by the Canadian " + 
"Parliament on October 22, 1964 and was proclaimed into law 
"by Her Majesty Queen Elizabeth II (the Queen of Canada) on 
"February 15, 1965. The Canadian Flag (colloquially known " 
"as The Maple Leaf Flag) is a red flag of the proportions " 
"two by length and one by width, containing in its center a 
"white square, with a single red stylized eleven-point " + 
"maple leaf centered in the white square."; 

f 1 agDescri pti on [1] = "Description for China ... "; 

f 1 agDescri pti on [2] = "Description for Denmark ... "; 

fl agDescri pti on [3] = "Description for France ... "; 

fl agDescri pti on [4] = "Description for Germany ... "; 

fl agDescri pti on [5] = "Description for India ... "; 

fl agDescri pti on [6] = "Description for Norway ... "; 

fl agDescri pti on [7] = "Description for UK . . . "; 

fl agDescri pti on [8] = "Description for US ... "; 

// Set the first country (Canada) for display 
setDisplay(O) ; 

// Add combo box and description panel to the list 
add(jcbo, BorderLayout . NORTH) ; 
add(descriptionPanel , BorderLayout . CENTER) ; 

// Register listener 

jcbo.addItemListener(new ItemLi stener() { 
/** Handle item selection */ 
public void i temStateChanged(ItemEvent e) { 
setDi spl ay(jcbo . getSel ectedlndexO) ; 

} 

}); 

} 

/** Set display information on the description panel */ 
public void setDi spl ay(int index) { 

descri ptionPanel . setTitle(flagTi ties [index]) ; 

descri pti onPanel . setlmagelcon (f 1 aglmage [i ndex] ) ; 

descri ptionPanel . setDescri pti on(f 1 agDescri pti on [i ndex] ) ; 

} 



The listener listens to ItemEvent from the combo box and implements ItemLi stener 
(lines 70-75). Instead of using ItemEvent, you may rewrite the program to use 
ActionEvent for handling combo-box item selection. 

The program stores the flag information in three arrays: flagTitles, fl aglmage, and 
flagDescription (lines 7-25). The array flagTitles contains the names of nine coun- 
tries, the array fl aglmage contains images of the nine countries' flags, and the array 
flagDescription contains descriptions of the flags. 
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The program creates an instance of DescriptionPanel (line 28), which was presented in 
Listing 17.6, DescriptionPanel.java. The program creates a combo box with initial values 
from flagTitles (line 31). When the user selects an item in the combo box, the 
i temStateChanged handler is executed, finds the selected index, and sets its corresponding 
flag title, flag image, and flag description on the panel. 



17.9 Lists 

A list is a component that basically performs the same function as a combo box but enables 
the user to choose a single value or multiple values. The Swing J List is very versatile. 
Figure 17.23 lists several frequently used constructors and methods in JList. 



j avax . swi ng . JComponent 



T 



j avax.s wing. .1 list 

-sel ectedlndex : int 
-sel ectedlndi ces : int[] 
-sel ectedVal ue : Object 
-vi si bl eRowCount : int 

-selectionBackground: Color 
-selectionForeground: Color 
-selectionMode: int 



+JList() 

+J Li st (items: Object[]) 

+addl_i stSel ecti on Li stener(l i stener : 
Li stSel ectionLi stener) : void 



The get and set methods for these data fields are provided 
in the class, but omitted in the UML diagram for brevity. 



The index of the first selected item. 

An array of all of the selected indices in increasing order. 

The first selected item in the list. 

The number of visible rows displayed without a scrollbar 
(default: 8). 

The background color of the selected cells. 
The foreground color of the selected cells. 
The selection mode for the list. 

Creates a default empty list. 

Creates a list that contains the elements in the specified array. 
Adds a Li stSel ecti onLi stener to this object. 



Figure 1 7.23 JLi st enables you to select multiple items from a set of items. 



selectionMode is one of the three values (SINGLE_SELECTION, SINGLE_INTERVAL 
.SELECTION, MULTIPLE_INTERVAL_SELECTION) defined in j avax. swing . Li stSe- 
lectionModel that indicate whether a single item, single-interval item, or multiple-interval 
item can be selected. Single selection allows only one item to be selected. Single-interval 
selection allows multiple selections, but the selected items must be contiguous. Multiple- 
interval selection allows selections of multiple contiguous items without restrictions, as 
shown in Figure 17.24. The default value is MULTIPLE_INTERVAL_SELECTION. 



Canada 




China 




Denmark 




France 




Germany 




India 




Norway 




United Kingdom 





(a) Single selection 



Canada 




China 




Denmark 




France 




Germany 




ndia 




Norway 




United Kingdom 





(b) Single-interval 
selection 



Canada 




China 




Denmark 




France 




Germany 




India 




Norway 




United Kingdom 





(c) Multiple-interval 
selection 



Figure 17.24 JList has three selection modes: single selection, single-interval selection, 
and multiple-interval selection. 
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The following statements create a list with six items, red foreground, white background, 
pink selection foreground, bl ack selection background, and visible row count 4. 

DList jlst = new JList(new Object[] 

{"Item 1", "Item 2", "Item 3", "Item 4", "Item 5", "Item 6"}); 
jl st . setForeg round (Col or . RED) ; 
jlst.setBackg round (Col or. WHITE) ; 
jl st . setSel ecti onForeg round (Col or . PINK) ; 
jlst . setSel ecti onBackg round (Color. BLACK) ; 
jlst.setVisibleRowCount(4) ; 

Lists do not scroll automatically. To make a list scrollable, create a scroll pane and add the list 
to it. 

JList fires javax. swing. event. ListSelectionEvent to notify the listeners of 
the selections. The listener must implement the val ueChanged handler in the 
javax. swing. event . Li stSel ectionListener interface to process the event. 

Listing 17.9 gives a program that lets users select countries in a list and display the flags of 
the selected countries in the labels. Figure 17.25 shows a sample run of the program. 



] Li st inside 
a scroll 
pane 




] Panel with 
Gri dLayout 



An image is 
displayed on a 
Jlabel 



Figure 1 7.25 When the countries in the list are selected, corresponding images of their flags are displayed in the labels. 



Here are the major steps in the program: 

1. Create the user interface. 

Create a list with nine country names as selection values, and place the list inside a 
scroll pane. Place the scroll pane in the west of the frame. Create nine labels to be used 
to display the countries' flag images. Place the labels in the panel, and place the panel 
in the center of the frame. 

2. Process the event. 

Create a listener to implement the val ueChanged method in the Li stSel ection- 

Li stener interface to set the selected countries' flag images in the labels. 

Listing 17.9 Li stDemo. java 

1 import java.awt.*; 

2 import javax. swi ng . * ; 

3 import javax. swi ng . event .* ; 
4 

5 public class ListDemo extends JFrame { 

6 final int NUMBER_OF_FLAGS = 9; 
7 

8 // Declare an array of Strings for flag titles 

9 private String[] flagTitles = {"Canada", "China", "Denmark", 
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10 "France", "Germany", "India", "Norway", "United Kingdom", 

11 "United States of America"}; 
12 

13 // The list for selecting countries 

14 private J List jlst = new JList(flagTitles) ; 
15 

16 // Declare an Imagelcon array for the national flags of 9 countries 

17 private ImageIcon[] imagelcons = { 

18 new Imagelcon ("image/ca. gi f ") , 

19 new Imagelcon ("image/chi na. gi f ") , 

20 new ImageIcon("image/denmark.gif") , 

21 new ImageIcon("image/fr .gif") , 

22 new ImageIcon("image/germany.gif") , 

23 new ImageIcon("image/india.gif") , 

24 new Imagelcon ("image/norway. gi f ") , 

25 new ImageIcon("image/uk.gif") , 

26 new ImageIcon("image/us.gif") 

27 }; 
28 

29 // Arrays of labels for displaying images 

30 private JLabel[] jlbllmageViewer = new D Label [NUMBER_OF_FLACS] ; 
31 

32 public static void main(String[] args) { 

33 ListDemo frame = new ListDemoO; create frame 

34 frame. setSize(650, 500); 

35 frame. setTitle("ListDemo") ; 

36 frame. setLocationRelativeTo(null) ; // Center the frame 

37 frame . setDef aul tCl oseOperati on (D Frame . EXIT_0N_CL0SE) ; 

38 frame.setVisible(true) ; 

39 } 
40 

41 public ListDemoO { 

42 // Create a panel to hold nine labels 

43 JPanel p = new JPanel(new Gri dLayout(3 , 3, 5, 5)); create UI 
44 

45 for (int i = 0; i < NUMBER_OF_FLAGS ; i++) { 

46 p.add(jlblImageViewer[i] = new JLabelO); 

47 jlblImageViewer[i] .setHorizontalAlignment 

48 (Swi ngConstants. CENTER) ; 

49 } 
50 

51 // Add p and the list to the frame 

52 add(p, BorderLayout . CENTER) ; 

53 add(new DScroll Pane(jl st) , BorderLayout. WEST) ; 
54 

55 // Register listeners 

56 jlst.addListSelectionListener(new Li stSel ecti onLi stener() { 

57 /** Handle list selection */ 

58 public void valueChanged(ListSelectionEvent e) { event handler 

59 // Get selected indices 

60 int[] indices = jlst.getSelectedlndicesO ; 
61 

62 int i ; 

63 // Set icons in the labels 

64 for (i =0; i < i ndi ces . 1 ength ; i++) { 

65 jlblImageViewer[i] . setIcon(imageIcons[indices[i]]) ; 

66 } 
67 

68 // Remove icons from the rest of the labels 

69 for (; i < NUMBER_0F_FLAGS ; i++) { 
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70 j"lb~IImageViewer[i] .setlcon(null) ; 

71 } 

72 } 

73 }); 

74 } 

75 } 

The anonymous inner-class listener listens to Li stSel ectionEvent for handling the selec- 
tion of country names in the list (lines 56-73). ListSelectionEvent and ListSelec- 
tionListener are defined in the javax. swing. event package, so this package is 
imported in the program (line 3). 

The program creates an array of nine labels for displaying flag images for nine countries. 
The program loads the images of the nine countries into an image array (lines 17-27) and cre- 
ates a list of the nine countries in the same order as in the image array (lines 9-11). Thus the 
index of the image array corresponds to the first country in the list. 

The list is placed in a scroll pane (line 53) so that it can be scrolled when the number of 
items in the list extends beyond the viewing area. 

By default, the selection mode of the list is multiple-interval, which allows the user to 
select multiple items from different blocks in the list. When the user selects countries in the 
list, the val ueChanged handler (lines 58-73) is executed, which gets the indices of the 
selected item and sets their corresponding image icons in the label to display the flags. 

17.10 Scroll Bars 

JScrol 1 Bar is a component that enables the user to select from a range of values, as shown 
in Figure 17.26. 

Minimum value Maximum value 




T A T 



Bubble 

Unit decrement Unit increment 

Figure 1 7.26 A scroll bar represents a range of values graphically. 



Normally, the user changes the value of the scroll bar by making a gesture with the mouse. 
For example, the user can drag the scroll bar's bubble up and down, or click in the scroll bar's 
unit-increment or block-increment areas. Keyboard gestures can also be mapped to the scroll 
bar. By convention, the Page Up and Page Down keys are equivalent to clicking in the scroll 
bar's block-increment and block-decrement areas. 

|p Note 

The width of the scroll bar's track corresponds to maximum + visibleAmount. When a scroll 
bar is set to its maximum value, the left side of the bubble is at maximum, and the right side is at 
maximum + visibleAmount. 

JScrol 1 Bar has the following properties, as shown in Figure 17.27. 

When the user changes the value of the scroll bar, the scroll bar fires an instance of 
AdjustmentEvent, which is passed to every registered listener. An object that wishes to be 
notified of changes to the scroll bar's value must implement the adjustmentVal ueChanged 
method in the java.awt .event .Adjustment Listener interface. 
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javax. swing. JComponent 



javax.swing.JScrollBar 



-orientation: mt 
-maximum: int 



-minimum: int 

-visibleAmount: int 

-value: int 
-blocklncrement: int 

-unitlncrement: int 



+DScrollBar() 

+DScrollBar(orientation: int) 

+DScrollBar(orientation: int, value: 
int, extent: int, min: int, max: int) 

+addAdjustmentl_i stener(l i stener: 
AdjustmentLi stener) : void 



The get and set methods for these data fields are provided 
in the class, but omitted in the UML diagram for brevity. 



Specifies horizontal or vertical style, default is horizontal. 

Specifies the maximum value the scroll bar represents when the bubble 
reaches the right end of the scroll bar for horizontal style or the 
bottom of the scroll bar for vertical style. 

Specifies the minimum value the scroll bar represents when the bubble 
reaches the left end of the scroll bar for horizontal style or the top of 
the scroll bar for vertical style. 

Specifies the relative width of the scroll bar's bubble. The actual width 
appearing on the screen is determined by the maximum value and the 
value of vi si bl eAmount. 

Represents the current value of the scroll bar. 

Specifies value added (subtracted) when the user activates the block- 
increment (decrement) area of the scroll bar, as shown in Figure 
17.26. 

Specifies the value added (subtracted) when the user activates the unit- 
increment (decrement) area of the scroll bar, as shown in Figure 
17.26. 

Creates a default vertical scroll bar. 

Creates a scroll bar with the specified orientation. 

Creates a scroll bar with the specified orientation, value, extent, 
minimum, and maximum. 

Adds an AdjustmentLi stener to this object. 



Figure 1 7.27 JScrol 1 Bar enables you to select from a range of values. 



Listing 17.10 gives a program that uses horizontal and vertical scroll bars to control a mes- 
sage displayed on a panel. The horizontal scroll bar is used to move the message to the left or 
the right, and the vertical scroll bar to move it up and down. A sample run of the program is 
shown in Figure 17.28. 



Message panel 
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Welcome to Java 










hi 





Vertical scroll bar 



Horizontal scroll bar 



Figure 1 7.28 The scroll bars move the message on a panel horizontally and vertically. 



Here are the major steps in the program: 

1. Create the user interface. 

Create a MessagePanel object and place it in the center of the frame. Create a vertical 
scroll bar and place it in the east of the frame. Create a horizontal scroll bar and place it 
in the south of the frame. 

2. Process the event. 

Create listeners to implement the adjustmentVal ueChanged handler to move the 
message according to the bar movement in the scroll bars. 
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Listing 17.10 Scrol 1 BarDemo. java 



horizontal scroll bar 
vertical scroll bar 



create frame 



create UI 
add scroll bar 

adjustment listener 



adjustment listener 



1 

2 
3 
4 
5 
6 
7 
8 
9 
10 
11 
12 
13 
14 
15 
16 
17 
18 
19 
20 
21 
22 
23 
24 
25 
26 
27 
28 
29 
30 
31 
32 
33 
34 
35 
36 
37 
38 
39 
40 
41 
42 
43 
44 
45 
46 
47 
48 
49 
50 
51 
52 
53 
54 
55 
56 



import java.awt.*; 
import java. awt . event .* ; 
import javax. swi ng . * ; 

public class Scroll BarDemo extends DFrame { 

// Create horizontal and vertical scroll bars 
private JScrollBar jscbHort = 

new JScroll Bar (JScroll Bar. HORIZONTAL) ; 
private JScrollBar jscbVert = 

new JScrol 1 Bar(DScrol 1 Bar .VERTICAL) ; 

// Create a MessagePanel 
private MessagePanel messagePanel = 
new MessagePanel ("Welcome to Java"); 

public static void main(String[] args) { 
Scrol 1 BarDemo frame = new Scrol 1 BarDemoO ; 
frame . setTi tl e ("Scrol 1 BarDemo") ; 

frame. setLocationRelativeTo(null) ; // Center the frame 
frame . setDef aul tCl oseOpe rati on (J Frame . EXIT„0N_CL0SE) ; 
frame . pack() ; 
frame . setVi si bl e (true) ; 

} 

public Scroll BarDemoO { 

// Add scroll bars and message panel to the frame 
setLayout(new BorderLayoutO) ; 
add(messagePanel , BorderLayout. CENTER) ; 
add (jscbVert , BorderLayout . EAST) ; 
add(jscbHort, BorderLayout . SOUTH) ; 

// Register listener for the scroll bars 
jscbHort. addAdjustmentListener(new AdjustmentLi stener() { 
public void adjustmentValueChanged(AdjustmentEvent e) { 

// getValue() and getMaximumValue() return int, but for better 

// precision, use double 

double value = jscbHort. getValue() ; 

double maximumValue = jscbHort . getMaxi mum() ; 

double newX = (value * messagePanel .getWidth() / 
maxi mumVal ue) ; 

messagePanel .setXCoordinate((int)newX) ; 

} 

}); 

jscbVert. addAdjustmentListener(new AdjustmentLi stener() { 
public void adjustmentValueChanged(AdjustmentEvent e) { 

// getValue() and getMaxi mumValue() return int, but for better 

// precision, use double 

double value = jscbVert. getValue() ; 

double maximumValue = jscbVert. getMaximum() ; 

double newY = (value * messagePanel .getHeight() / 

maxi mumVal ue) ; 
messagePanel .setYCoordinate((int)newY) ; 

} 

}); 
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The program creates two scroll bars (jscbVert and jscbHort) (lines 7-10) and an instance 
of MessagePanel (messagePanel ) (lines 13-14). messagePanel is placed in the center of 
the frame; jscbVert and jscbHort are placed in the east and south sections of the frame 
(lines 29-30), respectively. 

You can specify the orientation of the scroll bar in the constructor or use the setOrien- 
tation method. By default, the property value is 100 for maximum, for minimum, 10 for 
blocklncrement, and 10 for visibleAmount. 

When the user drags the bubble, or clicks the increment or decrement unit, the value of the 
scroll bar changes. An instance of AdjustmentEvent is fired and passed to the listener by 
invoking the adjustmentVal ueChanged handler. The listener for the vertical scroll bar 
moves the message up and down (lines 33-43), and the listener for the horizontal bar moves 
the message to right and left (lines 44-54). 

The maximum value of the vertical scroll bar corresponds to the height of the panel, and the 
maximum value of the horizontal scroll bar corresponds to the width of the panel. The ratio 
between the current and maximum values of the horizontal scroll bar is the same as the ratio 
between the x value and the width of the message panel. Similarly, the ratio between the 
current and maximum values of the vertical scroll bar is the same as the ratio between the y 
value and the height of the message panel. The x-coordinate and y-coordinate are set in 
response to the scroll bar adjustments (lines 39, 50). 

17.1 1 Sliders 

JSlider is similar to JScrollBar, but JSlider has more properties and can appear in 
many forms. Figure 17.29 shows two sliders. 



MessagePanel 




Vertical slider 



Horizontal slider 



Figure 1 7.29 The sliders move the message on a panel horizontally and vertically. 



3 SI ider lets the user graphically select a value by sliding a knob within a bounded inter- 
val. The slider can show both major tick marks and minor tick marks between them. The num- 
ber of pixels between the tick marks is controlled by the majorTickSpacing and 
minorTickSpacing properties. Sliders can be displayed horizontally or vertically, with or 
without ticks, and with or without labels. The frequently used constructors and properties in 
JS1 ider are shown in Figure 17.30. 

§ Note 

The values of a vertical scroll bar increase from top to bottom, but the values of a vertical slider 
decrease from top to bottom by default. 

§ Note 

All the properties listed in Figure 1 7.30 have the associated get and set methods, which are omit- 
ted for brevity. By convention, the get method for a Boolean property is named 
is<PropertyName>(). In the JSlider class, the get methods for paintLabels, 
paintTicks, paintTrack, and inverted are getPai nt Label s(), getPaintTicksO, 
getPaintTrackQ, and getlnvertedQ, which violate the naming convention. 
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javax . swi ng . JComponent 



javax.swing.JSlider 



-maximum: int 
-minimum: int 
-value: int 
-orientation: int 
-pai ntLabel s : boolean 
-paintTicks: boolean 
-paintTrack: boolean 
-majorTickSpacing: int 
-minorTickSpacing: int 
-inverted: boolean 




+JSlider() 

+JS1 i der(mi n : int, max: int) 

+JS1 i der(mi n : int, max: int, value: int) 

+JSlider(orientation: int) 

+JSlider(orientation: int, min: int, max: 
int, value: int) 

+addChangel_i stener(l i stener : 
ChangeLi stener) :void 



The get and set methods for these data fields are provided 
in the class, but omitted in the UML diagram for brevity. 



The maximum value represented by the slider (default: 100). 

The minimum value represented by the slider (default: 0). 

The current value represented by the slider. 

The orientation of the slider (default: JSlider. HORIZONTAL). 

True if the labels are painted at tick marks (default: false). 

True if the ticks are painted on the slider (default: false). 

True if the track is painted on the slider (default: true). 

The number of units between major ticks (default: 0). 

The number of units between minor ticks (default: 0). 

True to reverse the value range, and false to put the value range in the 
normal order (default: false). 

Creates a default horizontal slider. 

Creates a horizontal slider with the specified min and max. 
Creates a horizontal slider with the specified min, max, and value. 
Creates a slider with the specified orientation. 
Creates a slider with the specified orientation, min, max, and value. 

Adds a ChangeLi stener to this object. 



Figure 1 7.30 JS1 ider enables you to select from a range of values. 



When the user changes the value of the slider, the slider fires an instance of 
javax. swing. event. ChangeEvent, which is passed to any registered listeners. Any 
object that wishes to be notified of changes to the slider's value must implement the 
stateChanged method in the ChangeLi stener interface defined in the package 
javax . swi ng . event. 

Listing 17.11 writes a program that uses the sliders to control a message displayed on a 
panel, as shown in Figure 17.29. Here are the major steps in the program: 

1. Create the user interface. 

Create a MessagePanel object and place it in the center of the frame. Create a vertical 
slider and place it in the east of the frame. Create a horizontal slider and place it in the 
south of the frame. 

2. Process the event. 

Create listeners to implement the stateChanged handler in the ChangeLi stener 

interface to move the message according to the knot movement in the slider. 

Listing 17.11 SliderDemo. java 





1 


import 


j ava . 


awt . * ; 






2 


import 


j avax 


. swi ng . * ; 






3 
4 


import 


j avax 


. swi ng . event . * 






5 


publ ic 


class 


SliderDemo extends JFrame { 




6 


// c 


reate 


Horizontal and 


vertical sliders 


horizontal slider 


7 


private JSlider jsldHort 


= new 1S1 i der(JSl i der 


vertical slider 


8 
9 


private JSlider jsldVert 


= new 1S1 i der(JSl i der 
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10 // Create a MessagePanel 

11 private MessagePanel messagePanel = 

12 new MessagePanel ("Welcome to Java"); 
13 

14 public static void main(String[] args) { 

15 SliderDemo frame = new SI i derDemoO ; create frame 

16 frame. setTitle("SliderDemo") ; 

17 frame. setLocationRelativeTo(null) ; // Center the frame 

18 frame . setDef aul tCl oseOperati on (J Frame . EXIT„0N_CL0SE) ; 

19 frame . pack() ; 

20 frame.setVisible(true) ; 

21 } 
22 

23 public SI i derDemoO { create UI 

24 // Add sliders and message panel to the frame 

25 setLayout(new BorderLayout(5 , 5)); 

26 add(messagePanel , BorderLayout. CENTER) ; 

27 add(jsldVert, BorderLayout . EAST) ; 

28 add(jsldHort, BorderLayout . SOUTH) ; 
29 

30 // Set properties for sliders 

31 jsldHort.setMaximum(50) ; slider properties 

32 jsldHort.setPaintLabels(true) ; 

33 jsldHort.setPaintTicks(true) ; 

34 jsldHort.setMajorTickSpacing(lO) ; 

35 jsldHort.setMinorTickSpacing(l) ; 

36 jsldHort.setPaintTrack(false) ; 

37 jsldVert.setlnverted(true) ; 

38 jsldVert.setMaximum(lO) ; 

39 jsldVert.setPaintLabels(true) ; 

40 jsldVert.setPaintTicks(true) ; 

41 jsldVert.setMajorTickSpacing(lO) ; 

42 jsldVert.setMinorTickSpacing(l) ; 
43 

44 // Register listener for the sliders 

45 jsldHort.addChangeListener(new ChangeLi stenerO { listener 

46 /** Handle scroll -bar adjustment actions */ 

47 public void stateChanged(ChangeEvent e) { 

48 // getValueO and getMaximumValueO return int, but for better 

49 // precision, use double 

50 double value = jsldHort.getValue() ; 

51 double maximumValue = jsldHort.getMaximumO ; 

52 double newX = (value * messagePanel .getWidthO / 

53 maximumValue); 

54 messagePanel . setXCoordinate((int)newX) ; 

55 } 

56 }); 

57 jsldVert.addChangeListener(new ChangeLi stenerO { listener 

58 /** Handle scroll -bar adjustment actions */ 

59 public void stateChanged(ChangeEvent e) { 

60 // getValueO and getMaximumValueO return int, but for better 

61 // precision, use double 

62 double value = j si dVert. getValueO ; 

63 double maximumValue = jsl dVert . getMaxi mum() ; 

64 double newY = (value * messagePanel .getHeight() / 

65 maximumValue); 

66 messagePanel .setYCoordinate((int) newY) ; 

67 } 

68 }); 

69 } 



70 } 
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JS1 ider is similar to JScrol 1 Bar but has more features. As shown in this example, you can 
specify maximum, labels, major ticks, and minor ticks on a JS1 ider (lines 31-35). You can 
also choose to hide the track (line 36). Since the values of a vertical slider decrease from top 
to bottom, the setlnverted method reverses the order (line 37). 

JS1 ider fires ChangeEvent when the slider is changed. The listener needs to implement 
the stateChanged handler in ChangeLi stener (lines 45-68). Note that JScrol 1 Bar fires 
AdjustmentEvent when the scroll bar is adjusted. 

1 7. 1 2 Creating Multiple Windows 

Occasionally, you may want to create multiple windows in an application. The application 
opens a new window to perform a specified task. The new windows are called subwindows, 
and the main frame is called the main window. 

To create a subwindow from an application, you need to define a subclass of J Frame 
that specifies the task and tells the new window what to do. You can then create an instance 
of this subclass in the application and launch the new window by setting the frame instance 
to be visible. 

Listing 17.12 gives a program that creates a main window with a text area in the scroll pane 
and a button named Show Histogram. When the user clicks the button, a new window appears 
that displays a histogram to show the occurrences of the letters in the text area. Figure 17.31 
contains a sample run of the program. 



> MultipleWindowsDemo 



i/Vrite a program that creates a main window 
with a text area in the scroll pane and a button 
named "Show Histogram". When the user 
clicks the button, a new window appears that 
displays a histogram to show the occurrence 
of the letters in the text area. Figure 1 3.31 
contains a sample run of the program. 



Show Histogram 



I Histogram 



nl 



He 



ABCDEFGHI J KLMNOPQRSTLWKYZ 



Figure 1 7.3 1 The histogram is displayed in a separate frame. 



Here are the major steps in the program: 

1. Create a main class for the frame named Mul tipleWindowsDemo in Listing 17.12. 
Add a text area inside a scroll pane, and place the scroll pane in the center of the frame. 
Create a button Show Histogram and place it in the south of the frame. 

2. Create a subclass of JPanel named Histogram in Listing 17.13. The class contains a 
data field named count of the int[] type, which counts the occurrences of 26 letters. 
The values in count are displayed in the histogram. 

3. Implement the actionPerformed handler in Mul tipleWindowsDemo, as follows: 

a. Create an instance of Histogram. Count the letters in the text area and pass the 
count to the Hi s tog ram object. 

b. Create a new frame and place the Hi stogram object in the center of frame. Display 
the frame. 
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Listing 17.12 MultipleWindowsDemo. java 

1 import java.awt.*; 

2 import java.awt. event.*; 

3 import javax. swi ng . * ; 
4 

5 public class MultipleWindowsDemo extends 1 Frame { 



6 
7 


private JTextArea jta; 

private JButton jbtShowHi stogram = new 3Button("Show Histogram"); 




8 


private Histogram histogram = new HistogramO; 




9 
10 


// Create a new frame to hold the histogram panel 




11 


private JFrame hi stogramFrame = new DFrameO; 


create subframe 


12 
13 


public MultipleWindowsDemoQ { 


create UI 



14 // Store text area in a scroll pane 

15 JScrollPane scroll Pane = new JScroll Pane(jta = new JTextAreaO) ; 

16 scroll Pane . setPref erredSi ze(new Dimension(300, 200)); 

17 jta.setWrapStyleWord(true) ; 

18 jta. setLi neWrap(true) ; 
19 

20 // Place scroll pane and button in the frame 

21 add(scroll Pane, BorderLayout . CENTER) ; 

22 add (jbtShowHi stogram, BorderLayout . SOUTH) ; 
23 

24 // Register listener 

25 jbtShowHistogram.addActionListener(new ActionLi stener() { 

26 /** Handle the button action */ 

27 public void actionPerformed(ActionEvent e) { 

28 // Count the letters in the text area 

29 int[] count = countLettersO ; 
30 

31 // Set the letter count to histogram for display 

32 hi stogram . showHi stogram(count) ; 
33 

34 // Show the frame 

35 hi stogramFrame . setVi si bl e(true) ; display subframe 

36 } 

37 }); 
38 

39 // Create a new frame to hold the histogram panel 

40 hi stogramFrame . add (hi stogram) ; 

41 hi stogramFrame . pack() ; 

42 histogramFrame.setTitle("Histogram") ; 

43 } 
44 

45 /** Count the letters in the text area */ 

46 private int[] countLettersO { 

47 // Count for 26 letters 

48 int[] count = new int[26]; 
49 

50 // Get contents from the text area 

51 String text = jta. getText() ; 
52 

53 // Count occurrences of each letter (case insensitive) 

54 for (int i = 0; i < text.length() ; i++) { 

55 char character = text . charAt(i ) ; 
56 



604 Chapter 17 Creating Graphical User Interfaces 



57 if ((character >= 'A') && (character <= 'Z')) { 

58 count [character - 'A']++; 

59 } 

60 else if ((character >= 'a') && (character <= 'z')) { 

61 count [character - 'a']++; 

62 } 

63 } 
64 

65 return count; // Return the count array 

66 } 
67 

68 public static void mai n (Stri ng [] args) { 
create main frame 69 Mul ti pi eWi ndowsDemo frame = new Mul ti pi eWi ndowsDemoO ; 

70 frame. setLocationRelativeTo(null) ; // Center the frame 

71 frame . setDef aul tCl oseOperati on (J Frame . EXIT_0N_CL0SE) ; 

72 frame. setTi tie ("Mul ti pi eWi ndowsDemo") ; 

73 frame . pack() ; 

74 frame.setVisible(true) ; 

75 } 

76 } 



Listing 17.13 Hi stogram. java 



1 import javax. swing.*; 

2 import java.awt.*; 
3 

4 public class Histogram extends J Panel { 

5 // Count the occurrences of 26 letters 

6 private int[] count; 
7 

8 /** Set the count and display histogram */ 

9 public void showHi stogram(int [] count) { 

10 this. count = count; 

11 repaintO; 

12 } 
13 

14 /** Paint the histogram */ 

paint histogram 15 protected void pai ntComponent(Graphi cs g) { 

16 if (count == null) return; // No display if count is null 
17 

18 super . pai ntComponent(g) ; 
19 

20 // Find the panel size and bar width and interval dynamically 

21 int width = getWidth(); 

22 int height = getHeight(); 

23 int interval = (width - 40) / count . 1 ength ; 

24 int individualWidth = (int) (((width - 40) / 24) * 0.60); 
25 

26 // Find the maximum count. The maximum count has the highest bar 

27 int maxCount = 0; 

28 for (int i = 0; i < count . 1 ength ; i++) { 

29 if (maxCount < count [i]) 

30 maxCount = count [i]; 

31 } 
32 

33 // x is the start position for the first bar in the histogram 

34 int x = 30; 
35 

36 // Draw a horizontal base line 
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37 
38 
39 
40 
41 
42 
43 
44 
45 
46 
47 
48 
49 
50 
51 
52 
53 
54 
55 
56 
57 
58 

59 } 



g.drawLine(10, height - 45, width - 10, height - 45); 
for (int i = 0; i < count . 1 ength ; i++) { 

// Find the bar height 

int barHeight = 

(i nt)(( (double) count [i] / (doubl e)maxCount) * (height 

// Display a bar (i.e. rectangle) 

g . drawRect(x , height - 45 - barHeight, individualWidth, 
barHei ght) ; 



55)); 



// Display a letter under the base line 

g . drawStri ng((char) (65 + i) + "", x, height 

// Move x for displaying the next character 
x += i nterval ; 



30); 



} 



/** Override getPreferredSi ze */ 
public Dimension getPreferredSize() { 
return new Dimension (300, 300); 

} 



preferredSize 



The program contains two classes: Mul ti pi eWi ndowsDemo and Hi stogram. Their relation- 
ship is shown in Figure 17.32. 



j avax . swi ng . 1 Panel 

f 

Histogram 



-count: int[] 



+showHi stogram(count : int[]): void 
#pai ntComponent(g : Graphics): void 



javax. swing .3 Frame | 

T 

Multiple WindowsDemo 



-jta: JTextArea 
-histogram: Histogram 
-jbtShowHistogram: JButton 



-countl_etters() : int[] 
+main(args: String[]): void 



Figure 17.32 Mul t i pi eWi ndowsDemo uses Histogram to display a histogram of the 
occurrences of the letters in a text area in the frame. 



Mul ti pi eWi ndowsDemo is a frame that holds a text area in a scroll pane and a button. 
Histogram is a subclass of J Panel that displays a histogram for the occurrences of letters in 
the text area. 

When the user clicks the Show Histogram button, the handler counts the occurrences of 
letters in the text area. Letters are counted regardless of their case. Nonletter characters are not 
counted. The count is stored in an int array of 26 elements. The first element in the array 
stores the count for letter ' a 1 or ' A ' , and the last element stores the count for letter ' z' or 
' Z' . The count array is passed to the histogram for display. 

The Mul ti pi eWi ndowsDemo class contains a mai n method. The mai n method creates an 
instance of Mul ti pi eWi ndowsDemo and displays the frame. The Mul ti pi eWi ndowsDemo 
class also contains an instance of JFrame, named histogramFrame, which holds an 
instance of Hi stogram. When the user clicks the Show Histogram button, hi stogramFrame 
is set visible to display the histogram. 

The height and width of the bars in the histogram are determined dynamically according to 
the window size of the histogram. 
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You cannot add an instance of JFrame to a container. For example, adding hi stogramFrame 
to the main frame would cause a runtime exception. However, you can create a frame instance 
and set it visible to launch a new window. 

Chapter Summary 

1 . You learned how to create graphical user interfaces using Swing GUI components 
JButton, JCheckBox, JRadioButton, JLabel, JTextField, JTextArea, 
JComboBox, JList, JScrollBar, and JSlider. You also learned how to handle 
events on these components. 

2. You can display a text and icon on buttons (JButton, JCheckBox, JRadioButton) 
and labels (J Label). 

Review Questions 

Sections 1 7.2- 1 7.4 

I 7. 1 How do you create a button labeled OK? How do you change text on a button? 
How do you set an icon, a pressed icon, and a rollover icon in a button? 

I 7.2 Given a JButton object jbtOK, write statements to set the button's foreground to 
red, background to yel 1 ow, mnemonic to ' K 1 , tool tip text to "CI i ck OK to 
proceed", horizontal alignment to RIGHT, vertical alignment to BOTTOM, hori- 
zontal text position to LEFT, vertical text position to TOP, and icon text gap to 5. 

I 7.3 How do you create a check box? How do you create a check box with the box 
checked initially? How do you determine whether a check box is selected? 

I 7.4 How do you create a radio button? How do you create a radio button with the but- 
ton selected initially? How do you group the radio buttons together? How do you 
determine whether a radio button is selected? 

I 7.5 List at least five properties defined in the AbstractButton class. 
Sections 17.5-17.9 

I 7.6 How do you create a label named "Address"? How do you change the name on a 
label? How do you set an icon in a label? 

I 7.7 Given a J Label object j 1 bl Map, write statements to set the label's foreground to 
red, background to yellow, mnemonic to 'K', tool tip text to "Map image", 
horizontal alignment to RIGHT, vertical alignment to BOTTOM, horizontal text 
position to LEFT, vertical text position to TOP, and icon text gap to 5. 

I 7.8 How do you create a text field with 10 columns and the default text "Wei come to 
Java"? How do you write the code to check whether a text field is empty? 

I 7.9 How do you create a text area with ten rows and 20 columns? How do you insert 
three lines into the text area? How do you create a scrollable text area? 

I 7. 1 How do you create a combo box, add three items to it, and retrieve a selected item? 

I 7. 1 I How do you create a list with an array of strings? 

Sections 17.10-17.12 

I 7. 1 2 How do you create a horizontal scroll bar? What event can a scroll bar fire? 
I 7. 1 3 How do you create a vertical slider? What event can a slider fire? 
I 7. 1 4 Explain how to create and show multiple frames in an application. 



Programming Exercises 



Programming Exercises 607 



Pedagogical Note 

Instructors may assign the exercises from the next chapter as exercises for this chapter. 
Instead of writing Java applets, ask students to write Java applications. 

Sections 17.2-17.5 

I 7. 1 * (Revising Listing 1 7.2, ButtonDemo.java) Rewrite Listing 17.2 to add a group of 
radio buttons to select background colors. The available colors are red, yellow, 
white, gray, and green (see Figure 17.33). 



additional exercises 



Jn|_*l 



Select Messaga Panel Background 
ORed C Yellow • White O Cray O Gteen 

Welcome 1o Java 



Figure 1 7.33 The <= and => buttons move the message on the panel, and you can also 
set the background color for the message. 

I 7.2* (Selecting geometric figures) Write a program that draws various figures, as 
shown in Figure 17.34. The user selects a figure from a radio button and specifies 
whether it is filled in a check box. (Hint: Use the Fi gurePanel class introduced 
in Listing 15.3 to display a figure.) 




FigurePanel 



Panel with 
FlowLayout 



Figure 1 7.34 The program displays lines, rectangles, and ovals when you select a shape 
type. 



I 7.3** (Traffic lights) Write a program that simulates a traffic light. The program lets 
the user select one of three lights: red, yellow, or green. When a radio button is 
selected, the light is turned on, and only one light can be on at a time (see Figure 
17.35). No light is on when the program starts. 











o 






o 










Unci O Yellow (• Green -< 



Traffic light 
panel 



Panel with 
Fl owLayout 



Figure 1 7.35 The radio buttons are grouped to let you select only one color in the group to 
control a traffic light. 
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Sections 17.6-17.10 

I 7.4** (Text Viewer) Write a program that displays a text file in a text area, as shown in 
Figure 17.36. The user enters a file name in a text field and clicks the View but- 
ton; the file is then displayed in a text area. 



JdJjlJ 



If This application program prints welcome lo Java! 
)ubiic class Welcome { 
public static: void ma in (String] args) ( 
Kyste m, out pri mi nf we I com e to Javarj ; 
J 



Filename f:tonrilrtWelcr>rnfi java 



(a) 
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n 


n 
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i 
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Text Hlejc:'iti ookftVe ico m 9java| 



(b) 



Figure 1 7.36 (a) The program displays the text from a file to a text area, (b) The program 
displays a histogram that shows the occurrences of each letter in the file. 



I 7.5** (Creating a histogram for occurrences of letters) In Listing 17.12, Multiple Win- 
dowsDemo.java, you developed a program that displays a histogram to show the 
occurrences of each letter in a text area. Reuse the Histogram class created in 
Listing 17.12 to write a program that will display a histogram on a panel. The 
histogram should show the occurrences of each letter in a text file, as shown in 
Figure 17.36(b). Assume that the letters are not case sensitive. 

■ Place a panel that will display the histogram in the center of the frame. 

■ Place a label and a text field in a panel, and put the panel in the south side of 
the frame. The text file will be entered from this text field. 

■ Pressing the Enter key on the text field causes the program to count the occur- 
rences of each letter and display the count in a histogram. 

I 7.6* (Creating a miles/kilometers converter) Write a program that converts miles and 
kilometers, as shown in Figure 17.37. If you enter a value in the Mile text field 
and press the Enter key, the corresponding kilometer is displayed in the Kilome- 
ter text field. Likewise, if you enter a value in the Kilometer text field and press 
the Enter key, the corresponding mile is displayed in the Mile text field. 



Panel with Cri dLayout 
for two labels 



Kile 
I Kilometer 



il 



1.602307322544464 



Panel with BorderLayout 

Panel with Cri dLayout for 
two text fields 



Figure 17.37 The program converts miles to kilometers, and vice versa. 



17.7" 



17.8" 



(Setting clock time) Write a program that displays a clock time and sets it with 
the input from three text fields, as shown in Figure 17.38. Use the Still Clock 
in Listing 15.10. 

(Selecting a font) Write a program that can dynamically change the font of a 
message to be displayed on a panel. The message can be displayed in bold and 
italic at the same time, or can be displayed in the center of the panel. You can select 
the font name or font size from combo boxes, as shown in Figure 17.39. The avail- 
able font names can be obtained using getAvailableFontFamilyNamesO in 
GraphicsEnvi ronment (§12.8, "The Font Class"). The combo box for font size 
is initialized with numbers from 1 to 100. 
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45 Second 



Still Clock 



Panel with Fl owLayout 



Figure 1 7.38 The program displays the time specified in the text fields. 



Panel with BorderLayout 
Panel with BorderLayout - 



Font Name SansSerif 



Font Size 



18 



Java is Cool 

Centered Bold □ Italic 



Panel with 
BorderLayout 



Figure 1 7.39 You can dynamically set the font for the message. 

I 7.9** (Demonstrating JLabel properties) Write a program to let the user dynamically 
set the properties horizontal Al ignment. vertical Al ignment. horizon- 
tal TextAl ignment, and vertical TextAl ignment, as shown in Figure 
17.40. 



Panel with BorderLayout 

Panel with 
GridLayout 




Horizontal Alignment 



Text Position 
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Vertical 


LEFT 
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Horizontal 
Vertical 
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TOP t 



Panel with Cri dLayout 
Panel with BorderLayout 

Panel with Gri dLayout 
for two combo boxes 



Panel with GridLayout Panel with GridLayout 
for two combo boxes for two labels 



Figure 1 7.40 You can set the alignment and text-position properties of a button dynamically. 



I 7. 1 0* (Adding new features into Listing 17.2, ButtonDemo.java, incrementally) Improve 
Listing 17.2 incrementally, as follows (see Figure 17.41): 

1. Add a text field labeled "Enter a new message" in the same panel with the 
buttons. When you type a new message in the text field and press the Enter 
key, the new message is displayed in the message panel. 

2. Add a combo box labeled "Select an interval " in the same panel with 
the buttons. The combo box enables the user to select a new interval for mov- 
ing the message. The selection values range from 5 to 100 with interval 5. 
The user can also type a new interval in the combo box. 

3. Add three radio buttons that enable the user to select the foreground color for 
the message as Red, Green, and Blue. The radio buttons are grouped in a 
panel, and the panel is placed in the north of the frame's content pane. 
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4. Add three check boxes that enable the user to center the message and display it 
in italic or bold. Place the check boxes in the same panel with the radio buttons. 

5. Add a border titled "Message Panel" on the message panel, add a border 
titled "South Panel 11 on the panel for buttons, and add a border titled 
"North Panel " on the panel for radio buttons and check boxes. 
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®Red O Green O Blue Center Bold| □italic 
Message Panel 



GUI Demo 



Soirth Panel 
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Panel with Fl owLayout 

MessagePanel 

Panel with Fl owLayout 



Figure 1 7.4 1 The program uses buttons, labels, text fields, combo boxes, radio buttons, 
check boxes, and borders. 

I 7. 1 I * (Demonstrating JTextField properties) Write a program that sets the horizon- 
tal-alignment and column-size properties of a text field dynamically, as shown in 
Figure 17.42. 
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Figure 1 7.42 You can set the horizontal-alignment and column-size properties of a text 
field dynamically. 



I 7. 1 2* (Demonstrating JTextArea properties) Write a program that demonstrates the 
wrapping styles of the text area. The program uses a check box to indicate whether 
the text area is wrapped. In the case where the text area is wrapped, you need to 
specify whether it is wrapped by characters or by words, as shown in Figure 17.43. 
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Figure 1 7.43 You can set the options to wrap a text area by characters or by words 
dynamically. 

17.13* (Comparing loans with various interest rates) Rewrite Exercise 4.21 to create a 
user interface, as shown in Figure 17.44. Your program should let the user enter 
the loan amount and loan period in number of years from a text field, and should 
display the monthly and total payments for each interest rate starting from 5 per- 
cent to 8 percent, with increments of one-eighth, in a text area. 




Video Note 

Use text areas 
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Exercisel7 13 



Loan Amount 1 0000 



Number of Years 5 



Show Table 



Interest Rate 

5.0 

5.125 

5.25 

5.375 

5.5 

5.625 



Monthly Payment 

188.71 

189.28 

189.85 

190.43 

191.01 

191.58 



Total Payment 
1 1 322.74 
1 1 357.1 3 
11391.59 
1 1 426.11 
1 1 460.69 
1 1 495.34 



Panel with 
Flow/Layout 



JTextArea inside 
a scroll pane 



Figure 1 7.44 The program displays a table for monthly payments and total payments on a 
given loan based on various interest rates. 

I 7.14* (Using JComboBox and JList) Write a program that demonstrates selecting 
items in a list. The program uses a combo box to specify a selection mode, as 
shown in Figure 17.45. When you select items, they are displayed in a label 
below the list. 
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DComboBox 



1 Li st inside a 
scroll pane 



■3 Label 



Figure 1 7.45 You can choose single selection, single-interval selection, or multiple-interval 
selection in a list. 



Sections 17.1 1-17.13 

I 7. 1 5** (Using JScrol 7 Bar) Write a program that uses scroll bars to select the fore- 
ground color for a label, as shown in Figure 17.46. Three horizontal scroll bars 
are used for selecting the red, green, and blue components of the color. Use a 
title border on the panel that holds the scroll bars. 



Panel with 
Cri dLayout 

for three labels 
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Show Colors 



Choose colors 



Reel 

Green 

Blue 



Panel with BorderLayout 



Panel with Cri dLayout 
for three scroll bars 



Figure 1 7.46 The foreground color changes in the label as you adjust the scroll bars. 



I 7. 1 6** (Using JS7 ider) Revise the preceding exercise using sliders. 

I 7. 1 7*** (Displaying a calendar) Write a program that displays the calendar for the cur- 
rent month, as shown in Figure 17.47. Use labels, and set texts on the labels to 
display the calendar. Use the GregorianCalendar class in §14.3, "Example: 
Calendar and GregorianCalendar," to obtain the information about 
month, year, first day of the month, and number of days in the month. 
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Figure 1 7.47 The program displays the calendar for the current month. 



I 7. 1 8* (Revising Listing 1 7. 12, MultipleWindowsDemo.java) Instead of displaying the 
occurrences of the letters using the Histogram component in Listing 17.12, 
use a bar chart, so that the display is as shown in Figure 17.48. 



Exercisel7 



graphical user interface (GUI) 
makes a system user-friendly and 
easy to use. Creating a GUI 
requires creativity and knowledge o 
how GUI components work. Since 
th e G U I c omponents in Java are 



Show Histogram 



[Bar Chart 



1 1 i 



F G 



I I 



JnJ_xj 



R S 



V W, 



Figure 1 7.48 The number of occurrences of each letter is displayed in a bar chart. 



17.19** (Displaying country flag and flag description) Listing 17.8, Com- 
boBoxDemo.java, gives a program that lets users view a country's flag image 
and description by selecting the country from a combo box. The description is 
a string coded in the program. Rewrite the program to read the text description 
from a file. Suppose that the descriptions are stored in the file description0.txt, 
. . . , and description8.txt under the text directory for the nine countries 
Canada, China, Denmark, France, Germany, India, Norway, the United King- 
dom, and the United States, in this order. 

17.20** (Slide show) Exercise 16.13 developed a slide show using images. Rewrite 
Exercise 16.13 to develop a slide show using text files. Suppose ten text files 
named slide0.txt, slidel.txt, and slide9.txt are stored in the 
text directory. Each slide displays the text from one file. Each slide is shown 
for a second. The slides are displayed in order. When the last slide finishes, the 
first slide is redisplayed, and so on. Use a text area to display the slide. 



Chapter 



Applets and Multimedia 

Objectives 

■ To convert GUI applications to applets (§18.2). 

■ To embed applets in Web pages (§18.3). 

■ To run applets from Web browsers and from the appletviewer (§§18.3.1-18.3.2). 

■ To understand the applet security sandbox model (§18.4). 

■ To write a Java program that can run both as an application 
and as an applet (§18.5). 

■ To override the applet life-cycle methods i ni t, start, 
stop, and destroy (§18.6). 

■ To pass string values to applets from HTML (§18.7). 

■ To develop an animation for a bouncing ball (§18.8). 

■ To develop an applet for the TicTacToe game (§18.9). 

■ To locate resources (images and audio) using 
the URL class (§18.10). 

■ To play audio in any Java program (§18.11). 





614 Chapter 18 Applets and Multimedia 



18.1 Introduction 

When browsing the Web, often the graphical user interface and animation you see are devel- 
oped by the use of Java. The programs used are called Java applets. Suppose you want to 
develop a Java applet for the Sudoku game, as shown in Figure 18.1. How do you write this 
program? 
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Figure 1 8. 1 The Sudoku game is displayed in a Web browser. 



Video Note 



In this chapter, you will learn how to write Java applets, explore the relationship between 
applets and the Web browser, and discover the similarities and differences between applica- 
tions and applets. You will also learn how to create multimedia Java applications and applets 
with images and audio. 



8.2 Developing Applets 



So far, you have used only Java applications. Everything you have learned about writing 
applications, however, applies also to writing applets. Applications and applets share many 
First applet common programming features, although they differ slightly in some aspects. For example, 

every application must have a main method, which is invoked by the Java interpreter. Java 
applets, on the other hand, do not need a main method. They run in the Web browser envi- 
ronment. Because applets are invoked from a Web page, Java provides special features that 
enable applets to run from a Web browser. 

The Appl et class provides the essential framework that enables applets to be run from a 
Web browser. While every Java application has a main method that is executed when the 
application starts, applets do not have a main method. Instead they depend on the browser to 
run. Every applet is a subclass of java . appl et . Appl et. The Appl et class is an AWT class 
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and is not designed to work with Swing components. To use Swing components in Java 
applets, you need to create a Java applet that extends javax. swing. JApplet, which is a 
subclass of j ava . appl et . Appl et. 

Every Java GUI program you have developed can be converted into an applet by replacing 
JFrame with JApplet and deleting the main method. Figure 18.2(a) shows a Java GUI 
application program, which can be converted into a Java applet as shown in Figure 18.2(b). 



import javax. swing.-; 

public class Di spl ayLabel extends 3 Frame { 
public Di spl ayLabel () { 

add (new J Label ("Great ! " , J Label .CENTER)) ; 

} 

public static void main(String[] args) { 
J Frame frame = new Di spl ayLabel () ; 
frame . setTi tl e("Di spl ayLabel ") ; 
frame. setSize(200, 100); 
frame . setLocati onRel ati veTo(nul 1 ) ; 
frame . setDef aul tCl oseOperati on ( 

J Frame . EXIT_0N_CL0SE) ; 
frame.setVisible(true) ; 

} 

} 



import javax. swing.-; 

DApplet 

public class Di spl ayLabel extends 3 Frame { 
public Di spl ayLabel () { 

add (new J Label ("Great ! " , J Label .CENTER)) ; 

} 

— public static void main(String[] args) — [ 

3 Frame frame - now Di spl ayLabol () ; 

frame . setTi tl o("Disp! ayLabol ") ; 

frame .sotSizo(200, 100); 



— > 

} 



frame . setLocati onRel ati voTo(nul 1 ) 
frame . sotDof aul tCl oseOperati on( 

3 Frame = EXIT_0N_CL0SE) ; 
f ramo.sotVisiblo(truo) ; 



(a) GUI application 

Figure 18.2 You can convert a GUI application into an applet. 



(b) Applet 



Listing 18.1 gives the complete code for the applet. 

Listing 1 8. 1 DisplayLabel . java 

1 import javax. swing.*; 
2 

3 public class DisplayLabel extends DApplet { extend JAppl et 

4 public Di spl ayLabel () { 

5 add (new 1 Label ("Great!", JLabel .CENTER)) ; 

6 } 

7 } 

Like J Frame, JApplet is a container that can contain other GUI components (see the GUI 
class diagrams in Figure 14.1). 

18.3 The HTML File and the <applet> Tag 

To run an applet from a browser, you need to create an HTML file with the <applet> tag. 

HTML is a markup language that presents static documents on the Web. It uses tags to 
instruct the Web browser how to render a Web page and contains a tag called <appl et> that 
incorporates applets into a Web page. 

The HTML file in Listing 18.2 invokes the DisplayLabel.class: 

Listing 18.2 Displayl_abel.html 

<html > 
<head> 

<title>3ava Applet Demo</title> 
</head> 
<body> 
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opplet 

appletclass code = "Displ ayLabel . cl ass" 

width = 250 
height = 50> 
</appl et> 
</body> 
</html> 

A tag is an instruction to the Web browser. The browser interprets the tag and decides how to 
display or otherwise treat the subsequent contents of the HTML document. Tags are enclosed 
inside brackets. The first word in a tag, called the tag name, describes tag functions. A tag can 
have additional attributes, sometimes with values after an equals sign, which further define 
the tag's action. For example, in the preceding HTML file, <appl et> is the tag name, and 
code, width, and height are attributes. The width and height attributes specify the rec- 
tangular viewing area of the applet. 

Most tags have a start tag and a corresponding end tag. The tag has a specific effect on the 
region between the start tag and the end tag. For example, opplet. . .>. . .</applet> 
tells the browser to display an applet. An end tag is always the start tag's name preceded by a 
slash. 

An HTML document begins with the <html > tag, which declares that the document is 
written in HTML. Each document has two parts, a head and a body, defined by <head> and 
<body> tags, respectively. The head part contains the document title, including the <ti tl e> 
tag and other information the browser can use when rendering the document, and the body 
part holds the actual contents of the document. The header is optional. For more information, 
refer to Supplement V.A, "HTML and XHTML Tutorial." 
The complete syntax of the <appl et> tag is as follows: 

<app1 et 

[codebase = applet_url1 
code = class filename. class 
width = applet_viewing_width_in_pixels 
height = applet_viewing_height_in_pixels 
[archive = archivefi lei 
[vspace = vertical_margin1 
[hspace = horizontal _margin] 
[align = applet_alignment] 
[alt = alternati ve_text] 

> 

<param>tag <param name = param_namel value = param_val uel> 

<param name = param_name2 value = param_val ue2> 

<param name = param_name3 value = param_val ue3> 
</applet> 

The code, width, and height attributes are required; all the others are optional. The 
<param> tag will be introduced in §18.7, "Passing Strings to Applets." The other attributes 
are explained below. 

codebase attribute ■ codebase specifies a base where your classes are loaded. If this attribute is not used, 

the Web browser loads the applet from the directory in which the HTML page is 
located. If your applet is located in a different directory from the HTML page, you 
must specify the applet_url for the browser to load the applet. This attribute 
enables you to load the class from anywhere on the Internet. The classes used by the 
applet are dynamically loaded when needed. 



HTML tag 



<applet> tag 



archive attribute 



■ archive instructs the browser to load an archive file that contains all the class files 
needed to run the applet. Archiving allows the Web browser to load all the classes 
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from a single compressed file at one time, thus reducing loading time and improving 
performance. To create archives, see Supplement III.Q, "Packaging and Deploying 
Java Projects." 

■ vspace and hspace specify the size, in pixels, of the blank margin to pad around the 
applet vertically and horizontally. 

■ al ign specifies how the applet will be aligned in the browser. One of nine values is 
used: left, right, top, texttop, middle, absmiddle, baseline, bottom, or 
absbottom. 

■ al t specifies the text to be displayed in case the browser cannot run Java. 

18.3.1 Viewing Applets from a Web Browser 

To display an applet from a Web browser, open the applet's HTML file (e.g., DisplayLabel.html). 
Its output is shown in Figure 18.3(a). 
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Figure 1 8.3 The DisplayLabel program is loaded from a local host in (a) and from a Web 
server in (b). 



To make your applet accessible on the Web, you need to store the DisplayLabel. class and 
DisplayLabel.html on a Web server, as shown in Figure 18.4. You can view the applet from 
an appropriate URL. For example, I have uploaded these two files on Web server 
www.cs.armstrong.edu/. As shown in Figure 18.3(b), you can access the applet from 
www.cs.armstrong.edu/liang/intro8e/book/DisplayLabel.html. 







Web Server 

The .html file and applet's .class files 
are stored in the Web server. 


Web Browser 


http://wvm.webserver.com/appropriatepath/DisplayLabel .html 




HTML Page 





Figure 1 8.4 A Web browser requests an HTML page from a Web server. 



1 8.3.2 Viewing Applets Using the Applet Viewer Utility 

You can test the applet using the applet viewer utility, which can be invoked from the DOS 

prompt using the appletviewer command from c:\book, as shown in Figure 18.5(a). Its out- appletviewer 

put is shown in Figure 18.5(b). 

The applet viewer functions as a browser. It is convenient for testing applets during devel- 
opment without launching a Web browser. 
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Command Prompt 



C:\book>dir Display Label . * 
Uolume in driue C has no label. 
Uolume Serial Number is 48F3-18BE 



Directory of C:\book 

04/1 9/20D9 03:19 PH 
01/19/2009 03:27 PH 
01/19/2009 03:19 PM 

3 File(s) 
Dir(s) 



419 DisplayLabel .class 
138 DisplayLabel.html 
152 DisplayLabel . jaua 
769 bytes 
7,041 ,310, 720 bytes free 



C : \book>appletuiewer DisplayLabel .html 



1 
2AA 



(a) 



| Applet Viewer: Display La bel.c 



Applet 



n x 



Applet started. 



(b) 



Figure 1 8.5 The appletviewer command runs a Java applet in the applet viewer utility. 



1 8.4 Applet Security Restrictions 

Java uses the so-called "sandbox security model" for executing applets to prevent destructive pro- 
grams from damaging the system on which the browser is running. Applets are not allowed to use 
resources outside the "sandbox." Specifically, the sandbox restricts the following activities: 

■ Applets are not allowed to read from, or write to, the file system of the computer. 
Otherwise, they could damage the files and spread viruses. 

■ Applets are not allowed to run programs on the browser's computer. Otherwise, they 
might call destructive local programs and damage the local system on the user's computer. 

■ Applets are not allowed to establish connections between the user's computer and 
any other computer, except for the server where the applets are stored. This restric- 
tion prevents the applet from connecting the user's computer to another computer 
without the user's knowledge. 

^ Note 

signed applet You can create signed applets to circumvent the security restrictions. See java.sun.com/ 

developer/onlineTraining/Programming/JDCBook/signed.html for detailed instructions on how to 
create signed applets. 

1 8.5 Enabling Applets to Run as Applications 

Despite some differences, the JFrame class and the JApplet class have a lot in common. 
Since they both are subclasses of the Container class, all their user-interface components, 
layout managers, and event-handling features are the same. Applications, however, are 
invoked from the static main method by the Java interpreter, and applets are run by the Web 
browser. The Web browser creates an instance of the applet using the applet's no-arg con- 
structor and controls and executes the applet. 

In general, an applet can be converted to an application without loss of functionality. An 
application can be converted to an applet as long as it does not violate the security restrictions 
imposed on applets. You can implement a main method in an applet to enable the applet to 
run as an application. This feature has both theoretical and practical implications. Theoreti- 
cally, it blurs the difference between applets and applications. You can write a class that is 
both an applet and an application. From the standpoint of practicality, it is convenient to be 
able to run a program in two ways. 




Video Note 

Run applets standalone 
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How do you write such program? Suppose you have an applet named MyApplet. To 
enable it to run as an application, you need only add a main method in the applet with the 
implementation, as follows: 

public static void mai n(Stri ng [] args) { 

// Create a frame 

JFrame frame = new J Frame ("Applet is in the frame"); create frame 

// Create an instance of the applet 

MyApplet applet = new MyAppletO; create applet 

// Add the applet to the frame 

frame, add (applet, BorderLayout . CENTER) ; addapplet 

// Display the frame 
frame. setSize(300, 300); 

frame. setLocationRelativeTo(null) ; // Center the frame 
frame . setDef aul tCl oseOperati on (1 Frame . EXIT_0N_CL0SE) ; 

frame.setVisible(true) ; show frame 



You can revise the DisplayLabel class in Listing 18.1 to enable it to run standalone by 
adding a main method in Listing 18.3. 

Listing 18.3 New DisplayLabel . java with a main Method 

1 import javax. swing.*; 
2 

3 public class DisplayLabel extends lApplet { 

4 public Di spl ayLabel () { 

5 add (new 1 Label ("Great!", JLabel .CENTER)) ; 

6 } 
7 

8 public static void mai n (Stri ng [] args) { new main method 

9 // Create a frame 

10 JFrame frame = new JFrame("Applet is in the frame"); 



} 



11 
12 
13 
14 
15 
16 
17 
18 
19 
20 
21 
22 
23 

24 } 



} 



// Create an instance of the applet 
DisplayLabel applet = new Di spl ayLabel () ; 



// Add the applet to the frame 
frame . add (appl et) ; 



// Display the frame 
frame.setSize(300, 100); 

frame. setLocationRelativeTo(null) ; // Center the frame 
frame . setDef aul tCl oseOpe rati on (3 Frame . EXIT_0N_CL0SE) ; 
frame . setVi si bl e (true) ; 



When the applet is run from a Web browser, the browser creates an instance of the applet and 
displays it. When the applet is run standalone, the main method is invoked to create a frame 
(line 10) to hold the applet. The applet is created (line 13) and added to the frame (line 16). 
The frame is displayed in line 22. 
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18.6 Applet Life-Cycle Methods 

applet container Applets are actually run from the applet container, which is a plug-in of a Web browser. The 

Applet class contains the init(), start(), stopO, and destroyO methods, known as 
the life-cycle methods. These methods are called by the applet container to control the execu- 
tion of an applet. They are implemented with an empty body in the Appl et class. So, they do 
nothing by default. You may override them in a subclass of Appl et to perform desired oper- 
ations. Figure 18.6 shows how the applet container calls these methods. 



Applet container Applet container Applet container Applet container 

creates the applet invokes i ni t() invokes start () invokes stop () 



Loaded 



Created 



Initialized 



Started 



Stopped 



Applet container 
invokes start () 



Applet container 
loads the applet 



Applet container 
invokes destroyedQ 



Destroyed 



Figure 18.6 The applet container uses the init, start, stop, and destroy methods to control the applet. 



18.6.1 The init Method 

initO The init method is invoked after the applet is created. If a subclass of Applet has an initia- 

lization to perform, it should override this method. The functions usually implemented in this 
method include getting string parameter values from the <appl et> tag in the HTML page. 

18.6.2 The start Method 

startO The start method is invoked after the init method. It is also called when the user returns to 

the Web page containing the applet after surfing other pages. 

A subclass of Appl et overrides this method if it has any operation that needs to be per- 
formed whenever the Web page containing the applet is visited. An applet with animation, for 
example, might start the timer to resume animation. 

18.6.3 The stop Method 

stopO The stop method is the opposite of the start method. The start method is called when the 

user moves back to the page that contains the applet. The stop method is invoked when the 
user leaves the page. 

A subclass of Appl et overrides this method if it has any operation to be performed each 
time the Web page containing the applet is no longer visible. An applet with animation, for 
example, might stop the timer to pause animation. 

1 8.6.4 The destroy Method 

destroyO The destroy method is invoked when the browser exits normally to inform the applet that it 

is no longer needed and should release any resources it has allocated. The stop method is 
always called before the destroy method. 

A subclass of Appl et overrides this method if it has any operation to be performed before 
it is destroyed. Usually, you won't need to override this method unless you wish to release 
specific resources that the applet created. 



1 8.7 Passing Strings to Applets 

In §9.5, "Command-Line Arguments," you learned how to pass strings to Java applications 
from a command line. Strings are passed to the mai n method as an array of strings. When the 
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application starts, the main method can use these strings. There is no main method in an 
applet, however, and applets are not run from the command line by the Java interpreter. 

How, then, can applets accept arguments? In this section, you will learn how to pass strings 
to Java applets. To be passed to an applet, a parameter must be declared in the HTML file and 
must be read by the applet when it is initialized. Parameters are declared using the <param> 
tag. The <param> tag must be embedded in the <appl et> tag and has no end tag. Its syntax 
is given below: 

<param name = parametername value = stringvalue /> 
This tag specifies a parameter and its corresponding string value. 

§ Note 

No comma separates the parameter name from the parameter value in the HTML code. The 
HTML parameter names are not case sensitive. 

Suppose you want to write an applet to display a message. The message is passed as a 
parameter. In addition, you want the message to be displayed at a specific location with x- 
coordinate and y-coordinate, which are passed as two parameters. The parameters and their 
values are listed in Table 18.1. 

Table 18.1 Parameter Names and Values for the 
Di spl ayMessage Applet 

Parameter Name Parameter Value 

MESSAGE "Welcome to Java" 

X 20 
Y 30 

The HTML source file is given in Listing 18.4. 

Listing 18.4 DisplayMessage.html 

<html > 
<head> 

<title>Passi ng Strings to Java Applets</title> 
</head> 
<body> 

<p>This applet gets a message from the HTML 

page and displays it.</p> 
<applet 

code = "Di spl ayMessage. class" 
width = 200 
height = 50 

alt = "You must have a Java 2 -enabled browser to view the applet" 

> 

<param name = MESSAGE value = "Welcome to Java" /> 



<param name 


= X 


value = 


20 /> 


<param name 


= Y 


value = 


30 /> 



</appl et> 



</body> 
</html> 

To read the parameter from the applet, use the following method defined in the Appl et class: 
public String getParameter(Stri ng parametername); 
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This returns the value of the specified parameter. 

The applet is given in Listing 18.5. A sample run of the applet is shown in Figure 18.7. 



I Applet Viewer: DisplayMessag 



Applet 

Welcome to Java 
Applet started. 



Figure 18.7 The applet displays the message Wei come to Java passed from the 
HTML page. 



Listing 18.5 Di splayMessage. java 



1 import javax. swing.*; 
2 

3 public class Di spl ayMessage extends JApplet { 

4 /** Initialize the applet */ 

5 public void init() { 

6 // Get parameter values from the HTML file 
getParameter 7 String message = getParameter("MESSAGE") ; 

8 int x = Integer. parseInt(getParameter("X")) ; 

9 int y = Integer . parseInt(getParameter("Y")) ; 
10 

11 // Create a message panel 

12 MessagePanel messagePanel = new MessagePanel (message) ; 

13 messagePanel . setXCoordi nate(x) ; 

14 messagePanel . setYCoordi nate(y) ; 
15 

16 // Add the message panel to the applet 
add to applet 17 add (messagePanel ) ; 

18 } 

19 } 



The program gets the parameter values from the HTML in the i ni t method. The values 
are strings obtained using the getParameter method (lines 7-9). Because x and y are 
int, the program uses Integer . parselnt (string) to parse a digital string into an int 
value. 

If you change Welcome to Java in the HTML file to Welcome to HTML, and reload the 
HTML file in the Web browser, you should see Welcome to HTML displayed. Similarly, the 
x and y values can be changed to display the message in a desired location. 

tj| Caution 

The Applet's getParameter method can be invoked only after an instance of the applet is 
created. Therefore, this method cannot be invoked in the constructor of the applet class. You 
should invoke it from the init method. 

You can add a main method to enable this applet to run standalone. The applet takes 
the parameters from the HTML file when it runs as an applet and takes the parameters 
from the command line when it runs standalone. The program, as shown in Listing 18.6, 
is identical to Di spl ayMessage except for the addition of a new main method and of a 
variable named i sStandal one to indicate whether it is running as an applet or as an 
application. 
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Listing 18.6 DisplayMessageApp. java 

1 import javax. swing.*; 

2 import java. awt . Font ; 

3 import java. awt. BorderLayout ; 
4 

5 public class DisplayMessageApp extends JApplet { 



6 private String message = "A default message"; // Message to display 

7 private int x = 20; // Default x-coordi nate 

8 private int y = 20; // Default y-coordinate 
9 

10 /** Determine whether it is an application */ 

11 private boolean isStandalone = false; isStandalone 

12 

13 /** Initialize the applet */ 

14 public void init() { 

15 if (! isStandalone) { 

16 // Get parameter values from the HTML file 

17 message = getParameter("MESSACE") ; applet params 

18 x = Integer. parseInt(getParameter("X")) ; 

19 y = Integer. parseInt(getParameter("Y")) ; 

20 } 
21 

22 // Create a message panel 

23 MessagePanel messagePanel = new MessagePanel (message) ; 

24 messagePanel . setFont(new Font("SansSeri f " , Font. BOLD, 20)); 

25 messagePanel . setXCoordi nate(x) ; 

26 messagePanel . setYCoordi nate(y) ; 
27 

28 // Add the message panel to the applet 

29 add(messagePanel) ; 

30 } 
31 

32 /** Main method to display a message 

33 ©param args[0] x-coordi nate 

34 Oparam args[l] y-coordinate 

35 @param args[2] message 

36 V 

37 public static void main(String[] args) { 

38 // Create a frame 

39 JFrame frame = new JFrame("DisplayMessageApp") ; 
40 

41 // Create an instance of the applet 

42 DisplayMessageApp applet = new DisplayMessageAppO ; 
43 

44 // It runs as an application 

45 applet. isStandalone = true; standalone 
46 

47 // Get parameters from the command line 

48 applet. getCommandLi neParameters(args) ; command params 
49 

50 // Add the applet instance to the frame 

51 frame . add(appl et , BorderLayout. CENTER) ; 
52 

53 // Invoke applet's init method 

54 applet. init() ; 

55 appl et . start() ; 
56 

57 // Display the frame 

58 frame. setSize(300, 300); 
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59 frame. setLocationRelativeTo(null) ; // Center the frame 

60 frame . setDef aul tCl oseOperati on (D Frame . EXIT„ON_CLOSE) ; 

61 frame.setVisible(true) ; 

62 } 
63 

64 /** Get command-line parameters */ 

65 private void getCommandLineParameters(String[] args) { 

66 // Check usage and get x, y and message 

67 if (args. length != 3) { 

68 System. out. println( 

69 "Usage: java DisplayMessageApp x y message"); 

70 System. exit(0) ; 

71 } 

72 else { 

73 x = Integer. parselnt(args[0]) ; 

74 y = Integer. parselnt(args[l]) ; 

75 message = args[2]; 

76 } 

77 } 



78 } 

When you run the program as an applet, the mai n method is ignored. When you run it as an 
application, the mai n method is invoked. Sample runs of the program as an application and as 
an applet are shown in Figure 18.8. 



I Applet Viewer: DtsplayMessai 



Applet 

It is an applet 

Applet tl^ile J 
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I DisplayMessageApp 



It is an application 
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Figure 18.8 The DisplayMessageApp class can run as an application and as an applet. 



The mai n method creates a J Frame object frame and creates a J Appl et object appl et, 
then places the applet appl et into the frame frame and invokes its i ni t method. The appli- 
cation runs just like an applet. 

The main method sets isStandalone true (line 45) so that it does not attempt to 
retrieve HTML parameters when the i ni t method is invoked. 

The setVisible(true) method (line 61) is invoked after the components are added to 
the applet, and the applet is added to the frame to ensure that the components will be visible. 
Otherwise, the components are not shown when the frame starts. 

Important Pedagogical Note 

From now on, all the GUI examples will be created as applets with a main method. Thus you will 
be able to run the program either as an applet or as an application. For brevity, the main method 
is not listed in the text. 



omitting main method 



18.8 Case Study: Bouncing Ball 

This section presents an applet that displays a ball bouncing in a panel. Use two buttons to 
suspend and resume the movement, and use a scroll bar to control the bouncing speed, as 
shown in Figure 18.9. 

Here are the major steps to complete this example: 

1. Create a subclass of J Panel named Ball to display a ball bouncing, as shown in 
Listing 18.7. 
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Figure 18.9 The ball's movement is controlled by the Suspend and Resume buttons and the 
scroll bar. 



2. Create a subclass of JPanel named Bal 1 Control to contain the ball with a scroll bar 
and two control buttons Suspend and Resume, as shown in Listing 18.8. 

3. Create an applet named BounceBal 1 App to contain an instance of Bal 1 Control and 
enable the applet to run standalone, as shown in Listing 18.9. 

The relationship among these classes is shown in Figure 18.10. 



j avax . swi ng . J Panel 



Ball 



-x: int 
-y: int 
-dx: int 
-dy: int 
-radius: int 
-delay: int 
-timer: Timer 



+Ball () 

+suspend(): void 
+resume(): void 
+setDelay(delay: int): void 



1 1 



♦ 



j avax . swi ng . J Panel 



javax . swi ng . DAppl et 



BallControl 



-ball: Ball 

-jsbDelay: DScrollBar 
-jbtResume: JButton 
-jbtSuspend: DButton 



nBallControl () 



1 1 



♦ 



BounceBallApp 



+BounceBal 1 App() 
+main(args: Strinq[]): void 



Figure 18.10 BounceBallApp contains BallControl, and BallControl contains Ball. 



Listing 18.7 Ball . java 

1 import javax. swing. Timer; 

2 import java.awt.*; 

3 import javax. swi ng . * ; 

4 import java.awt. event.*; 
5 

6 public class Ball extends J Panel { 

7 private int delay = 10; timer delay 
8 

9 // Create a timer with delay 1000 ms 
10 private Timer timer = new Timer(delay, new TimerLi stenerO) ; create timer 

11 

12 private int x = 0; private int y = 0; // Current ball position 

13 private int radius = 5; // Ball radius 

14 private int dx = 2; // Increment on ball's x-coordinate 

15 private int dy = 2; // Increment on ball's y-coordinate 
16 
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timer listener 



repaint ball 



paint ball 
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55 
56 

57 } 



public Ball () { 
timer. start() ; 

} 

private class Ti merLi stener implements ActionLi stener { 

/** Handle the action event */ 
public void acti onPerformed(Acti onEvent e) { 
repai nt() ; 

} 

} 

protected void pai ntComponent(Graphi cs g) { 
super . pai ntComponent(g) ; 

g . setColor(Col or . red) ; 

// Check boundaries 

if (x < radius) dx = Math.abs(dx) ; 

if (x > getWidthO - radius) dx = -Math . abs(dx) ; 

if (y < radius) dy = Math.abs(dy) ; 

if (y > getHeight() - radius) dy = -Math . abs (dy) ; 

// Adjust ball position 
x += dx; 
y += dy; 

g.fillOval(x - radius, y - radius, radius * 2, radius * 2); 

} " 

public void suspend() { 

timer. stop () ; // Suspend timer 

} 

public void resume() { 

timer. start() ; // Resume timer 

} 

public void setDelay(int delay) { 
this. del ay = delay; 
timer.setDelay(delay) ; 

} 



The use of Timer to control animation was introduced in §16.12, "Animation Using the 
Timer Class." Bal 1 extends J Panel to display a moving ball. The timer listener implements 
ActionLi stener to listen for Acti onEvent (line 21). Line 10 creates a Timer for a Ball . 
The timer is started in line 18 when a Bal 1 is constructed. The timer fires an ActionEvent 
at a fixed rate. The listener responds in line 24 to repaint the ball to animate ball movement. 
The center of the ball is at (x, y), which changes to (x + dx, y + dy) on the next display 
(lines 40-41). The suspend and resume methods (lines 45-51) can be used to stop and start 
the timer. The setDelay(int) method (lines 53-56) sets a new delay. 



Listing 18.8 Ball Control . java 

1 import javax. swi ng . * ; 

2 import java.awt. event.*; 

3 import java.awt.'-; 
4 

5 public class BallControl extends JPanel { 
button 6 private Ball ball = new Ball () ; 
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7 private JButton jbtSuspend = new DButton("Suspend") ; 

8 private JButton jbtResume = new JButton("Resume") ; scrollbar 

9 private JScrollBar jsbDelay = new JScroll Bar() ; 
10 

11 public BallControl { create UI 

12 // Croup buttons in a panel 

13 1 Panel panel = new JPanelO; 

14 panel . add( jbtSuspend) ; 

15 panel . add( jbtResume) ; 
16 

17 // Add ball and buttons to the panel 

18 bal 1 . setBorder(new javax. swi ng . border . Li neBorder(Col or . red)) ; 

19 j sbDel ay . setOri entati on (J Scrol 1 Bar . HORIZONTAL) ; 

20 ball .setDelay(jsbDelay.getMaximumO) ; 

21 setLayout(new BorderLayoutO) ; 

22 add(jsbDelay , BorderLayout . NORTH) ; 

23 add(ball, BorderLayout . CENTER) ; 

24 add(panel, BorderLayout . SOUTH) ; 
25 

26 // Register listeners 

27 jbtSuspend . addActionLi stener(new ActionLi stenerO { register listener 

28 public void actionPerformed(ActionEvent e) { 

29 ball . suspend () ; suspend 

30 } 

31 }); 

32 jbtResume. addActi onLi stener(new Acti onLi stenerO { register listener 

33 public void actionPerformed(ActionEvent e) { 

34 ball . resumeO ; resume 

35 } 

36 }); 

37 jsbDelay. addAdjustmentListener(new AdjustmentLi stenerO { register listener 

38 public void adjustmentValueChanged(AdjustmentEvent e) { 

39 bal 1 . setDel ay ( j sbDel ay . getMaxi mwnO - e . getVa.1 ue O ) I new delay 

40 } 

41 }); 

42 } 



43 } 

The BallControl class extends JPanel to display the ball with a scroll bar and two control 
buttons. When the Suspend button is clicked, the ball's suspend () method is invoked to sus- 
pend the ball movement (line 29). When the Resume button is clicked, the ball's resume () 
method is invoked to resume the ball movement (line 34). The bouncing speed can be 
changed using the scroll bar. 

Listing 18.9 BounceBallApp. java 

1 import java.awt.*; 

2 import javax. swing.*; 
3 

4 public class BounceBallApp extends lApplet { 



5 public BounceBall App() { 

6 add (new BallControl ()) ; add BallControl 

7 } 

8 } main method omitted 



The BounceBallApp class simply places an instance of BallControl in the applet. The 
man n method is provided in the applet (not displayed in the listing for brevity) so that you can 
also run it standalone. 
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Video Note 

TicTacToe 



8.9 Case Study: TicTacToe 



From the many examples in this and earlier chapters you have learned about objects, classes, 
arrays, class inheritance, GUI, event-driven programming, and applets. Now it is time to put 
what you have learned to work in developing comprehensive projects. In this section, you will 
develop a Java applet with which to play the popular game of TicTacToe. 

Two players take turns marking an available cell in a 3 X 3 grid with their respective 
tokens (either X or O). When one player has placed three tokens in a horizontal, vertical, or 
diagonal row on the grid, the game is over and that player has won. A draw (no winner) occurs 
when all the cells on the grid have been filled with tokens and neither player has achieved a 
win. Figure 18.1 1 shows the representative sample runs of the example. 
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(a) The X player won the game (b) Draw-no winners 
Figure 1 8.1 1 Two players play a TicTacToe game. 
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(c) The O player won the game 



All the examples you have seen so far show simple behaviors that are easy to model with 
classes. The behavior of the TicTacToe game is somewhat more complex. To create classes 
that model the behavior, you need to study and understand the game. 

Assume that all the cells are initially empty, and that the first player takes the X token, the 
second player the O token. To mark a cell, the player points the mouse to the cell and clicks it. 
If the cell is empty, the token (X or O) is displayed. If the cell is already filled, the player's 
action is ignored. 

From the preceding description, it is obvious that a cell is a GUI object that handles the 
mouse-click event and displays tokens. Such an object could be either a button or a panel. 
Drawing on panels is more flexible than drawing on buttons, because on a panel the token (X 
or O) can be drawn in any size, but on a button it can be displayed only as a text label. There- 
fore, a panel should be used to model a cell. How do you know the state of the cell (empty, X, 
or O)? You use a property named token of char type in the Cel 1 class. The Cel 1 class is 
responsible for drawing the token when an empty cell is clicked. So you need to write the 
code for listening to the MouseEvent and for painting the shapes for tokens X and O. The 
Cel 1 class can be defined as shown in Figure 18. 12. 



javax . swi ng . 1 Panel 





Cell 



-token: char 



+getToken(): char 
+setToken(token : char): void 
#pai ntComponent(g : Graphics): void 
+mouseCl i cked(e : MouseEvent): void 



Token used in the cell (default: "). 

Returns the token in the cell. 
Sets a new token in the cell. 
Paints the token in the cell. 
Handles a mouse click on the cell. 



Figure 1 8.12 The Cel 1 class paints the token on a cell. 
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The TicTacToe board consists of nine cells, created using new Cel 1 [3] [3] . To determine 
which player's turn it is, you can introduce a variable named whoseTurn of char type. 
whoseTurn is initially X, then changes to O, and subsequently changes between X and O 
whenever a new cell is occupied. When the game is over, set whoseTurn to 1 ' . 

How do you know whether the game is over, whether there is a winner, and who the winner, 
if any, is? You can create a method named i sWon (char token) to check whether a specified 
token has won and a method named i sFul 1 () to check whether all the cells are occupied. 

Clearly, two classes emerge from the foregoing analysis. One is the Cel 1 class, which han- 
dles operations for a single cell; the other is the Ti cTacToe class, which plays the whole game 
and deals with all the cells. The relationship between these two classes is shown in Figure 18.13. 



Cell 



j avax . swi ng . J Appl et 



TicTacToe 



-whoseTurn: char 
-cell: Cell[][] 
-jlblStatus: JLabel 



+Ti cTacToe() 

+isFull(): boolean 

+i sWon(token : char): boolean 



Indicates which player has the turn, initially X. 
A 3 X 3, two-dimensional array for cells. 
A label to display game status. 
Constructs the TicTacToe user interface. 
Returns true if all cells are filled. 

Returns true if a player with the specified token has won. 



Figure 18.13 The TicTacToe class contains nine cells. 



Since the Cel 1 class is only to support the Ti cTacToe class, it can be defined as an inner 
class in TicTacToe. The complete program is given in Listing 18.10: 

Listing 18.10 TicTacToe. java 

1 import java.awt.*; 

2 import java.awt. event.*; 

3 import j avax. swing.*; 

4 import javax. swi ng . border . Li neBorder ; 
5 

6 public class TicTacToe extends 3 Applet { main class Ti cTacToe 

7 // Indicate which player has a turn; initially it is the X player 

8 private char whoseTurn = 'X' ; 
9 

10 // Create and initialize cells 

11 private Cell [] [] cells = new Cell [3] [3] ; 
12 

13 // Create and initialize a status label 

14 private JLabel jlblStatus = new DLabel("X's turn to play"); 
15 

16 /** Initialize UI */ 

17 public TicTacToe () { 

18 // Panel p to hold cells 

19 JPanel p = new JPanel(new Gri dLayout(3 , 3, 0, 0)); 

20 for (int i = 0; i < 3; i++) 

21 for (int j = 0; j < 3; j++) 

22 p.add(cells[i] [j] = new CellO); 
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// Set line borders on the cells panel and the status label 

p.setBorder(new LineBorder(Color. red, 1)); 

jl bl Status . setBorder(new LineBorder(Color. yellow, 1)); 

// Place the panel and the label to the applet 

add(p, BorderLayout. CENTER) ; 

add (jlbl Status, BorderLayout . SOUTH) ; 

} 

/** Determine whether the cells are all occupied */ 
public boolean isFull() { 
for (int i = 0; i < 3; i++) 
for (int j = 0; j < 3; j++) 

if (cells[i] [j] .getTokenfJ == ' ') 
return false; 



return true; 

} 

/** Determine whether the player with the specified token wins */ 
public boolean isWon(char token) { 
for (int i = 0; i < 3; i++) 
if ((cells[i] [0] .getToken() 
&& (cells[i] [1] .getToken() 
&& (cells[i] [2] .getToken() 
return true; 

} 



token) 
token) 
token)) { 



for (int j = 0; j < 3; j++) 

if ((cells[0] [j] .getToken() == token) 
&& (cells[l] [j] .getToken() == token) 
&& (cells[2] [j] .getToken() == token)) { 
return true; 

} 

if ((cells[0] [0] .getToken() == token) 
&& (cells[l] [1] .getToken() == token) 
&& (cells [2] [2] .getTokenO == token)) { 
return true; 

} 

if ((cells[0] [2] .getTokenO == token) 
&& (cells[l] [1] .getTokenO == token) 
&& (cells [2] [0] .getTokenO == token)) { 
return true; 

} 

return false; 



} 

// An inner class for a cell 
public class Cell extends J Panel { 

// Token used for this cell 

private char token = ' ' ; 

public CellO { 

setBorder(new Li neBorder(Col or . black, 1)); // Set cell's border 
addMouseLi stener(new MyMouseLi stenerO) ; // Register listener 

} 
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83 

84 /** Return token */ 

85 public char getTokenO { 

86 return token; 

87 } 
88 

89 /** Set a new token */ 

90 public void setToken(char c) { 

91 token = c; 

92 repaint(); 

93 } 
94 

95 /** Paint the cell */ 

96 protected void pai ntComponent(Graphi cs g) { paint cell 

97 super . pai ntComponent(g) ; 
98 

99 if (token == 'X') { 

100 g.drawLine(10, 10, getwidthO - 10, getHeightO - 10); 

101 g.drawLine(getWidth() - 10, 10, 10, getHeightO - 10); 

102 } 

103 else if (token == '0') { 

104 g.drawOvalCIO, 10, getWidthO - 20, getHeightO - 20); 

105 } 

106 } 
107 

108 private class MyMouseLi stener extends MouseAdapter { listener class 

109 /** Handle mouse click on a cell */ 

110 public void moused i cked(MouseEvent e) { 

111 // If cell is empty and game is not over 

112 if (token ==•'&& whoseTurn !=''){ 

113 setToken(whoseTurn) ; // Set token in the cell 
114 

115 // Check game status 

116 if (i sWon (whoseTurn)) { 

117 jlbl Status. setText (whoseTurn + " won! The game is over"); 

118 whoseTurn = ' ' ; // Came is over 

119 } 

120 else if (isFullO) { 

121 jlblStatus.setText("Draw! The game is over"); 

122 whoseTurn = ' ' ; // Came is over 

123 } 

124 else { 

125 // Change the turn 

126 whoseTurn = (whoseTurn == 'X') ? '0': 'X'; 

127 // Display whose turn 

128 jlblStatus.setText(whoseTurn + "'s turn"); 

129 } 

130 } 

131 } 

132 } 

133 } 

134 } main method omitted 



The TicTacToe class initializes the user interface with nine cells placed in a panel of 
Gri dLayout (lines 19-22). A label named j 1 bl Status is used to show the status of the game (line 
14). The variable whoseTu r n (line 8) is used to track the next type of token to be placed in a cell. The 
methods i sFul 1 (lines 34-41) and i sWon (lines 44-72) are for checking the status of the game. 

Since Cel 1 is an inner class in TicTacToe, the variable (whoseTurn) and methods (i sFul 1 
and i sWon) defined in TicTacToe can be referenced from the Cel 1 class. The inner class makes 
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programs simple and concise. If Cel 1 were not declared as an inner class of Ti cTacToe, you would 
have to pass an object of Ti cTacToe to Cel 1 in order for the variables and methods in Ti cTacToe 
to be used in Cel 1 . You will rewrite the program without using an inner class in Exercise 18.6. 

The listener for MouseEvent is registered for the cell (line 81). If an empty cell is clicked 
and the game is not over, a token is set in the cell (line 113). If the game is over, whoseTurn 
is set to ' ' (lines 118, 122). Otherwise, whoseTurn is alternated to a new turn (line 126). 

# Tip 

incremental development Use an incremental approach in developing and testing a Java project of this kind. The foregoing 

and testing program can be divided into five steps: 

1. Lay out the user interface and display a fixed token X on a cell. 

2. Enable the cell to display a fixed token X upon a mouse click. 

3. Coordinate between the two players so as to display tokens X and O alternately. 

4. Check whether a player wins, or whether all the cells are occupied without a winner. 

5. Implement displaying a message on the label upon each move by a player. 



why URL class? 



18.10 Locating Resources Using the URL Class 

You have used the Imagelcon class to create an icon from an image file and used the setlcon 
method or the constructor to place the icon in a GUI component, such as a button or a label. For 
example, the following statements create an Imagelcon and set it on a J Label object jl bl : 

Imagelcon imagelcon = new Imagelcon ("c : \\book\\image\\us . gi f ") ; 
jlbl .setlcon(imagelcon) ; 

This approach presents a problem. The file location is fixed, because it uses the absolute file 
path on the Windows platform. As a result, the program cannot run on other platforms and 
cannot run as an applet. Assume that i mage/us . gi f is under the class directory. You can cir- 
cumvent this problem by using a relative path as follows: 

Imagelcon imagelcon = new ImageIcon("image/us.gif") ; 

This works fine with Java applications on all platforms but not with Java applets, because 
applets cannot load local files. To enable it to work with both applications and applets, you 
need to locate the file's URL. 

The j ava . net . URL class can be used to identify files (image, audio, text, and so on) on the 
Internet. In general, a URL (Uniform Resource Locator) is a pointer to a "resource" on a local 
machine or a remote host. A resource can be something as simple as a file or a directory. 

A URL for a file can also be accessed from a class in a way that is independent of the location 
of the file, as long as the file is located in the class directory. Recall that the class directory is 
where the class is stored. To obtain the URL of a resource file, use the following statements in an 
applet or application: 



Directory 



An applet or 
application 



A resource file 



Class metaObject = this.getClassO ; 

URL url = metaObject. getResource(resourceFilename) ; 



meta object 



The getCl ass() method returns an instance of the java . 1 ang . CI ass class. This instance is 
automatically created by the JVM for every class loaded into the memory. This instance, also 
known as a meta object, contains the information about the class file such as class name, 
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constructors, and methods. You can obtain the URL of a file in the class path by invoking the 
getResource(filename) method on the meta object. For example, if the class file is in 
c : \book, the following statements obtain a URL for c : \book\image\us . gi f . 



C:\book 



An applet or 
application 



image 



Class metaObject = this.getClass() ; 

URL url = metaObject. getResource("image/us. gif") ; 



us.gif 



You can now create an Imagelcon using 

Imagelcon imagelcon = new ImageIcon(url ) ; 

Listing 18.11 gives the code that displays an image from image/us . gi f in the class direc- 
tory. The file image/us . gi f is under the class directory, and its URL is obtained using the 
getResource method (line 5). A label with an image icon is created in line 6. The image 
icon is obtained from the URL. 



Listing 1 8. 1 1 DisplaylmageWithURL. java 

1 import javax. swing.*; 
2 

3 public class DisplaylmageWithURL extends DApplet { 

4 public DisplaylmagewithURLO { 

5 java. net. URL url = this. getClassO .getResource("image/us. gif") ; getimageURL 

6 add (new J Label (new Imagelcon (url) )) ; create a label 

7 } 

8 } main method omitted 

If you replace the code in lines 5-6 with the following code, 

add(new JLabel(new Imagelcon ("image/us. gi f "))) ; 
you can still run the program standalone, but not from a browser. 

18.1 1 Playing Audio in Any Java Program 

There are several formats for audio files. Java programs can play audio files in the WAV, 
AIFF, MIDI, AU, and RMF formats. 

To play an audio file in Java (application or applet), first create an audio clip object for the file. 
The audio clip is created once and can be played repeatedly without reloading the file. To create 
an audio clip, use the static method newAudioCl ip() in the java. applet .Applet class: 

AudioClip audioClip = Appl et . newAudi oCl i p(url ) ; 

Audio originally could be played only from Java applets. For this reason, the AudioCl ip inter- 
face is in the java . appl et package. Since JDK 1.2, audio can be played in any Java program. 

The following statements, for example, create an AudioCl ip for the beep.au audio file 
in the class directory: 

Class metaObject = this.getClassO ; 

URL url = metaObject.getResource("beep.au"); 

AudioClip audioClip = Appl et . newAudi oCl i p(url ) ; 
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«interface» 
java.applet.AudioClip 



+play() 

+ loop() 
+stop() 



Starts playing this audio clip. Each time this method 
is called, the clip is restarted from the beginning. 

Plays the clip repeatedly. 
Stops playing the clip. 



Figure 1 8.14 The AudioCl i p interface provides the methods for playing sound. 



To manipulate a sound for an audio clip, use the playO, loopO, and stopO methods in 
java.applet.AudioClip, as shown in Figure 18.14. 

Listing 18.12 gives the code that displays the Danish flag and plays the Danish national 
anthem repeatedly. The image file i mage/ denmark . gi f and audio file audi o/denmark . mi d 
are stored under the class directory. Line 12 obtains the audio file URL. Line 13 creates an audio 
clip for the file. Line 14 repeatedly plays the audio. 



Listing 18.12 DisplaylmagePlayAudio. java 





1 


import javax. swi ng . * ; 




2 


import java. net. URL; 




3 
4 


import java. applet.*; 




5 


public class DisplaylmagePlayAudio extends JApplet { 




6 


private AudioClip audioClip; 




7 
8 


public DisplaylmagePlayAudioO { 


get image URL 


9 


URL urlForlmage = getClassO .getResource("image/denmark.gif") ; 


create a label 


10 


add(new JLabel(new ImageIcon(url Forlmage))) ; 




11 




get audio URL 


12 


URL urlForAudio = getClassO .getResource("audio/denmark.mid") ; 


create an audio clip 


13 


audioClip = Appl et . newAudi oCl i p(url ForAudi o) ; 


play audio repeatedly 


14 


audioClip. loop() ; 




15 


} 




16 






17 


public void start() { 


start audio 


18 


if (audioClip != null) audioClip.loopO ; 




19 


} 




20 






21 


public void stopO { 


stop audio 


22 


if (audioClip != null) audioClip.stopO ; 




23 


} 


main method omitted 


24 


} 



The stop method (lines 21-23) stops the audio when the applet is not displayed, and the 
start method (lines 17-19) restarts the audio when the applet is redisplayed. Try to run 
this applet from a browser and observe the effect without the stop and start methods. 

Run this program standalone from the main method and from a Web browser to test it. 
Recall that, for brevity, the main method in all applets is not printed in the listing. 

18.12 Case Study: Multimedia Animations 

This case study presents a multimedia animation with images and audio. The images are for 
seven national flags, named f 1 agO . gi f , f 1 agl . gi f , . . . , f 1 ag6 . gi f for Denmark, Ger- 
many, China, India, Norway, U.K., and U.S. They are stored under the image directory in 
the class path. The audio consists of national anthems for these seven nations, named 
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anthemO . mid, antheml .mid, . . . , and anthem6.mid. They are stored under the audio 
directory in the class path. 

The program presents the nations, starting from the first one. For each nation, it displays its 
flag and plays its anthem. When the audio for a nation finishes, the next nation is presented, and 
so on. After the last nation is presented, the program starts to present all the nations again. You 
may suspend animation by clicking the Suspend button and resume it by clicking the Resume 
button, as shown in Figure 18.15. You can also directly select a nation from a combo box. 



I ImageAudioAnima 




LC 



a 



JnJiL 




Suspend Select 



Figure 18.15 The applet displays a sequence of images and plays audio. 



The program is given in Listing 18.13. A timer is created to control the animation (line 15). 
The timer delay for each presentation is the play time for the anthem. You can find the play 
time for an audio file using RealPlayer or Windows Media. The delay times are stored in an 
array named del ays (lines 13-14). The delay time for the first audio file (the Danish anthem) 
is 48 seconds. 



Listing 18.13 ImageAudioAnimation. java 



1 

2 
3 
4 
5 
6 
7 
8 
9 
10 
11 
12 
13 
14 
15 
16 
17 
18 
19 
20 
21 
22 
23 
24 
25 
26 
27 
28 



import j ava . awt . * ; 
import java. awt . event .* ; 
import javax. swing.*; 
import java. applet.*; 

public class ImageAudioAnimation extends JApplet { 
private final static int NUMBER_OF_NATIONS = 7; 
private int current = 0; 

private ImageIcon[] icons = new Imagelcon [NUMBER_0F_NATI0NS] ; 
private AudioClip[] audioClips = new AudioClip[NUMBER_OF_NATIONS] ; 
private AudioClip currentAudioClip; 

private int[] delays = 

{48000, 54000, 59000, 54000, 59000, 31000, 68000}; 
private Timer timer = new Ti mer(del ays [0] , new TimerLi stenerO) ; 

private JLabel jlbllmageLabel = new JLabel (); 
private JButton jbtResume = new JButton("Resume") ; 
private JButton jbtSuspend = new JButton("Suspend") ; 
private JComboBox jcboNations = new JComboBox(new 0bject[] 

{"Denmark", "Germany", "China", "India", "Norway", "UK", "US"}); 

public ImageAudioAnimationO { 

// Load image icons and audio clips 
for (int i =0; i < NUMBER_0F_NATI0NS ; i++) { 
icons[i] = new ImageIcon(getClass() . getResource( 

"image/flag" + i + ".gif")); 
audioCl i ps [i ] = Applet. newAudioCl i p( 



Video Note 

Audio and image 



image icons 
audio clips 
current audio clip 

audio play time 



GUI components 



create icons 



create audio clips 
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create UI 



register listener 
start animation 

register listener 
stop animation 

register listener 

select a nation 
present a nation 



set a new delay 



29 
30 
31 
32 
33 
34 
35 
36 
37 
38 
39 
40 
41 
42 
43 
44 
45 
46 
47 
48 
49 
50 
51 
52 
53 
54 
55 
56 
57 
58 
59 
60 
61 
62 
63 
64 
65 
66 
67 
68 
69 
70 
71 
72 
73 
74 
75 
76 
77 
78 
79 
80 
81 
82 
83 
84 



} 



getClassQ . getResourceC'audio/anthem" + i + ".mid")); 



JPanel panel = new JPanelO; 

panel .add(jbtResume) ; 

panel .add(jbtSuspend) ; 

panel .add(new JLabel ("Select")) ; 

panel .add(jcboNations) ; 

add(jlblImageLabel , BorderLayout . CENTER) ; 
add(panel , BorderLayout . SOUTH) ; 

jbtResume.addActionListener(new Acti onLi stener() { 
public void actionPerformed(ActionEvent e) { 
start() ; 

} 

}); 

jbtSuspend . addActionLi stener(new ActionLi stenerO { 
public void actionPerformed(ActionEvent e) { 
stop() ; 

} 

}); 

jcboNations.addActionListener(new ActionLi stenerO { 
public void actionPerformed(ActionEvent e) { 
stopO ; 

current = jcboNati ons . getSel ectedlndexO ; 
presentNation(current) ; 
timer. start() ; 

} 

}); 

timer. start() ; 

j 1 bl ImageLabel . setlcon (i cons [0] ) ; 

jlbllmageLabel .setHorizontalAlignment(JLabel .CENTER) ; 
currentAudioCl i p = audi oCl i ps [0] ; 
currentAudioCl ip.pl ay () ; 

} 

private class Ti merLi stener implements Acti onLi stener { 
public void acti onPerformed(Acti onEvent e) { 
current = (current + 1) % NUMBER_0F_NATI0NS ; 
presentNation(current) ; 

} 

} 

private void presentNation(int index) { 
j 1 bl ImageLabel . setlcon (i cons [i ndex] ) ; 
jcboNati ons . setSel ectedlndex(i ndex) ; 
currentAudioCl i p = audi oCl i ps [i ndex] ; 
currentAudioCl ip.pl ay () ; 
timer. setDel ay(del ays [i ndex] ) ; 



} 



{ 



public void start() 
timer. start() ; 
currentAudioCl ip.pl ay () ; 

} 
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85 
86 
87 
88 
89 
90 



} 



public void stopO { 
timer. stop () ; 
currentAudioClip.stopO ; 

} 



stop audio clip 



main method omitted 



A label is created in line 17 to display a flag image. An array of flag images for seven nations 
is created in lines 26-27. An array of audio clips is created in lines 28-29. Each audio clip is 
created for an audio file through the URL of the current class. The audio files are stored in the 
same directory with the applet class file. 

The combo box for country names is created in lines 20-21. When a new country name in 
the combo box is selected, the current presentation is stopped and a new selected nation is 
presented (lines 52-55). 

The presentNation(index) method (lines 73-79) presents a nation with the specified 
index. It sets a new image in the label (line 74), synchronizes with the combo box by setting 
the selected index (line 75), plays the new audio, and sets a new delay time (line 78). 

The applet's start and stop methods are overridden to resume and suspend the anima- 
tion (lines 81-89). 



1 . JAppl et is a subclass of Appl et. It is used for developing Java applets with Swing 
components. 

2. The applet bytecode must be specified, using the <appl et> tag in an HTML file to 
tell the Web browser where to find the applet. The applet can accept string parame- 
ters from HTML using the <param> tag. 

3. The applet container controls and executes applets through the init, start, stop, 
and destroy methods in the Appl et class. 

4. When an applet is loaded, the applet container creates an instance of it by invoking 
its no-arg constructor. The init method is invoked after the applet is created. The 
start method is invoked after the init method. It is also called whenever the 
applet becomes active again after the page containing the applet is revisited. The 
stop method is invoked when the applet becomes inactive. 

5. The destroy method is invoked when the browser exits normally to inform the 
applet that it is no longer needed and should release any resources it has allocated. 
The stop method is always called before the destroy method. 



Key Terms 



applet 616 

applet container 620 

archive 616 



HTML 616 

tag 616 

signed applet 618 



Chapter Summary 
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6. The procedures for writing applications and writing applets are very similar. An 
applet can easily be converted into an application, and vice versa. Moreover, an 
applet can be written with a main method to run standalone. 

7. You can pass arguments to an applet using the param attribute in the applet's tag in 
HTML. To retrieve the value of the parameter, invoke the getParameter(paramName) 
method. 

8. The Appl et's getParameter method can be invoked only after an instance of the 
applet is created. Therefore, this method cannot be invoked in the constructor of the 
applet class. You should invoke this method from the init method. 

9. You learned how to incorporate images and audio in Java applications and applets. 
To load audio and images for Java applications and applets, you have to create a 
URL for the audio and image. You can create a URL from a file under the class 
directory. 

1 0. To play an audio, create an audio clip from the URL for the audio source. You can use 
the AudioCl ip's playO method to play it once, the loopO method to play it 
repeatedly, and the stop() method to stop it. 



Review Questions 



Sections 18.2-18.6 

18.1 Is every applet an instance of j ava . appl et . Appl et? Is every applet an instance 
of j avax . swi ng . J Appl et? 

18.2 Describe the init(), start(), stopO, and destroyO methods in the 
Appl et class. 

1 8.3 How do you add components to a JAppl et? What is the default layout manager 
of the content pane of JAppl et? 

1 8.4 Why does the applet in (a) below display nothing? Why does the applet in (b) have 
a runtime NullPointerException on the highlighted line? 



import j avax. swing."; 

public class WelcomeApplet extends DApplet { 
public void WelcomeAppletO { 
DLabel jlblMessage = 

new JI_abel("It is Java") ; 

} 

} 



(a) 



import j avax. swing."''; 

public class WelcomeApplet extends JAppl et { 
private DLabel jlblMessage; 

public WelcomeAppletO { 
JLabel jlblMessage = 

new DLabel("It is Java"); 

} 

public void init() { 
add(jl blMessage) ; 

} 



(b) 



18.5 
18.6 
18.7 



Describe the <appl et> HTML tag. How do you pass parameters to an applet? 

Where is the getParameter method defined? 

What is wrong if the DisplayMessage applet is revised as follows? 



Programming Exercises 639 



public class Di spl ayMessage extends JApplet { 

/** Initialize the applet */ 

public DisplayMessageO { 

// Get parameter values from the HTML file 
String message = getParameter("MESSACE") ; 
int x = 

Integer . parseInt(getParameter("X")) I 
int y = 

Integer . parseInt(getParameter("Y")) ; 

// Create a message panel 
MessagePanel messagePanel = 
new MessagePanel (message) ; 
messagePanel . setXCoordi nate(x) ; 
messagePanel . setYCoordi nate(y) ; 

// Add the message panel to the applet 
add(messagePanel ) ; 



public class Di spl ayMessage extends JApplet { 
private String message; 
private int x; 
private int y; 

/** Initialize the applet */ 

public void init() { 

// Get parameter values from the HTML file 
message = getParameter("MESSAGE") ; 
x = Integer . parseInt(getParameter("X")) I 
y = Integer . parseInt(getParameter("Y")) I 

} 

public DisplayMessageO { 

// Create a message panel 
MessagePanel messagePanel = 

new MessagePanel (message) ; 
messagePanel . setXCoordi nate(x) ; 
messagePanel . setYCoordi nate(y) ; 

// Add the message panel to the applet 
add(messagePanel ) ; 



(a) Revision 1 



(b) Revision 2 



18.8 What are the differences between applications and applets? How do you run an 
application, and how do you run an applet? Is the compilation process different for 
applications and applets? List some security restrictions on applets. 

18.9 Can you place a frame in an applet? 

18.10 Can you place an applet in a frame? 

18.1 I Delete super . paintComponent(g) on line 97 in TicTacToe.java in Listing 18.5 
and run the program to see what happens. 

Sections 18.9-18.10 

18.12 How do you create a URL object for the file image/us. gif in the class directory? 

18.13 How do you create an Imagelcon from the file image/us. gif in the class directory? 

Section 18.1 1 

18.14 What types of audio files are used in Java? 

1 8.1 5 How do you create an audio clip from a file anthem/us. mid in the class directory? 

18.16 How do you play, repeatedly play, and stop an audio clip? 

Programming Exercises 



HH Pedagogical Note 

For every applet in the exercise, add a main method to enable it to run standalone. run standalone 

Sections 18.2-18.6 

1 8.1 (Converting applications to applets) Convert Listing 17.2, ButtonDemo.java, into 
an applet. 
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1 8.2* (Passing strings to applets) Rewrite Listing 18.5, DisplayMessage.java to display 
a message with a standard color, font, and size. The message, x, y, color, 
f ontname, and fontsi ze are parameters in the <appl et> tag, as shown below: 

<app1 et 

code = "Exercisel8 2. class" 
width = 200 
height = 50 

alt = "You must have a Java-enabled browser to view the applet" 

> 

<param name = MESSAGE value = "Welcome to Java" /> 
<param name = X value = 40 /> 
<param name = Y value = 50 /> 
<param name = COLOR value = "red" /> 
<param name = FONTNAME value = "Monospaced" /> 
<param name = FONTSIZE value = 20 /> 
</applet> 

18.3 (Loan calculator) Write an applet for calculating loan payment, as shown in 
Figure 18.16. The user can enter the interest rate, the number of years, and the 
loan amount and click the Compute Payment button to display the monthly pay- 
ment and total payment. 



1 1 B \m&m \ 



Enter interest rate, year and loan amount 


Interest Rate (e.g.. 5.5 for 5.5%) 
Years 

Loan Amount 
Monthly Payment 


5 


15 


200000 


1581.59 


Total Payment 


284685.71 






Compute Payment 





Figure 18.16 
18.4* 

18.5** 



The applet computes the loan payment. 



(Converting applications to applets) Rewrite ClockAnimation in Listing 16.12 
as an applet and enable it to run standalone. 

(Game: a clock learning tool) Develop a clock applet to show a first-grade stu- 
dent how to read a clock. Modify Exercise 15.19 to display a detailed clock with 
an hour hand and a minute hand in an applet, as shown in Figure 18.17(a). The 
hour and minute values are randomly generated. The hour is between and 11, 
and the minute is 0, 15, 30, or 45. Upon a mouse click, a new random time is 
displayed on the clock. 
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(b) 



(c) 



Figure 1 8.1 7 (a) Upon a mouse click on the clock, the clock time is randomly displayed, 
(b) The New Game button starts a new game, (c) The tax calculator computes the tax for the 
specified taxable income and tax status. 
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18.6** (Game: TicTacToe) Rewrite the program in §18.9, "Case Study: TicTacToe," 
with the following modifications: 

■ Declare Cel 1 as a separate class rather than an inner class. 

■ Add a button named New Game, as shown in Figure 18.17(b). The New 
Game button starts a new game. 

18.7** (Financial application: tax calculator) Create an applet to compute tax, as 
shown in Figure 18.17(c). The applet lets the user select the tax status and enter 
the taxable income to compute the tax based on the 2001 federal tax rates, as 
shown in Exercise 10.8. 

1 8.8*** (Creating a calculator) Use various panels of Flow/Layout, GridLayout, and 
BorderLayout to lay out the following calculator and to implement addition 
(+), subtraction (-), division (/), square root (sqrt), and modulus (%) functions 
(see Figure 18.18(a)). 
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Binary 


101 1 01 1 010000000 



(a) (b) 

Figure 18.18 (a) Exercise 18.8 is a Java implementation of a popular calculator, (b) Exer- 
cise 18.9 converts between decimal, hex, and binary numbers. 

1 8.9* (Converting numbers) Write an applet that converts between decimal, hex, and 
binary numbers, as shown in Figure 18.18(b). When you enter a decimal value 
on the decimal-value text field and press the Enter key, its corresponding hex 
and binary numbers are displayed in the other two text fields. Likewise, you can 
enter values in the other fields and convert them accordingly. 

I 8. 1 0** (Repainting a partial area) When you repaint the entire viewing area of a 
panel, sometimes only a tiny portion of the viewing area is changed. You can 
improve the performance by repainting only the affected area, but do not 
invoke super. paintComponent (g) when repainting the panel, because 
this will cause the entire viewing area to be cleared. Use this approach to 
write an applet to display the temperatures of each hour during the last 
24 hours in a histogram. Suppose that temperatures between 50 and 90 
degrees Fahrenheit are obtained randomly and are updated every hour. The 
temperature of the current hour needs to be redisplayed, while the others 
remain unchanged. Use a unique color to highlight the temperature for the 
current hour (see Figure 18.19(a)). 

1 8.1 I ** (Simulation: a running fan) Write a Java applet that simulates a running fan, as 
shown in Figure 18.19(b). The buttons Start, Stop, and Reverse control the fan. 
The scrollbar controls the fan's speed. Create a class named Fan, a subclass of 
JPanel , to display the fan. This class also contains the methods to suspend and 
resume the fan, set its speed, and reverse its direction. Create a class named 
FanControl that contains a fan, and three buttons and a scroll bar to control the 
fan. Create a Java applet that contains an instance of FanControl . 
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Figure 1 8.1 9 (a) The histogram displays the average temperature of every hour in the last 
24 hours, (b) The program simulates a running fan. 



18.12** (Controlling a group of fans) Write a Java applet that displays three fans in 
a group, with control buttons to start and stop all of them, as shown in 
Figure 18.20. 



ExerdBel8_12: CuriLruing a Group of fans 
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Figure 1 8.20 The program runs and controls a group of fans. 



1 8. 1 3*** (Creating an elevator simulator) Write an applet that simulates an elevator going 
up and down (see Figure 18.21). The buttons on the left indicate the floor where 
the passenger is now located. The passenger must click a button on the left to 
request that the elevator come to his or her floor. On entering the elevator, the 
passenger clicks a button on the right to request that it go to the specified floor. 
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Figure 1 8.2 1 The program simulates elevator operations. 



1 8. 1 4* (Controlling a group of clocks) Write a Java applet that displays three clocks in a 
group, with control buttons to start and stop all of them, as shown in Figure 18.22. 

Video Note Sections 18.10-18.12 

Control a group of clocks 18.15* (Enlarging and shrinking an image) Write an applet that will display a 

sequence of images from a single image file in different sizes. Initially, the 
viewing area for this image has a width of 300 and a height of 300. Your pro- 
gram should continuously shrink the viewing area by 1 in width and 1 in height 
until it reaches a width of 50 and a height of 50. At that point, the viewing area 
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Figure 18.22 Three clocks run independently with individual control and group control. 



should continuously enlarge by 1 in width and 1 in height until it reaches a 
width of 300 and a height of 300. The viewing area should shrink and enlarge 
(alternately) to create animation for the single image. 

1 8. 1 6*** (Simulating a stock ticker) Write a Java applet that displays a stock-index 
ticker (see Figure 18.23). The stock-index information is passed from the 
<param> tag in the HTML file. Each index has four parameters: Index Name 
(e.g., S&P 500), Current Time (e.g., 15:54), the index from the previous day 
(e.g., 919.01), and Change (e.g., 4.54). Use at least five indexes, such as Dow 
Jones, S&P 500, NASDAQ, NIKKEI, and Gold & Silver Index. Display posi- 
tive changes in green and negative changes in red. The indexes move from 
right to left in the applet's viewing area. The applet freezes the ticker when the 
mouse button is pressed; it moves again when the mouse button is released. 



| Applet Viewer: Excrciscl8_16.class 
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Figure 1 8.23 The program displays a stock-index ticker. 



18.17** (Racing cars) Write an applet that simulates four cars racing, as shown in 
Figure 18.24(a). You can set the speed for each car, with 1 being the highest. 
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Figure 1 8.24 (a) You can set the speed for each car. (b) This applet shows each country's 
flag, name, and description, one after another, and reads the description that is currently shown. 



18.18** (Showing national flags) Write an applet that introduces national flags, one 
after the other, by presenting each one's photo, name, and description (see 
Figure 18.24(b)) along with audio that reads the description. 



644 Chapter 18 Applets and Multimedia 



Suppose your applet displays the flags of eight countries. Assume that the 
photo image files, named flag0.gif, flagl.gif, and so on, up to flag7.gif, are 
stored in a subdirectory named image in the applet's directory. The length of 
each audio is less than 10 seconds. Assume that the name and description of 
each country's flag are passed from the HTML using the parameters nameO, 
namel, name7, and descriptionO, description]., and 

description?. Pass the number of countries as an HTML parameter using 
numberOf Countries. Here is an example: 

<param name = "numberOfCountries" value = 8> 
<param name = "nameO" value = "Canada"> 

<param name = "descriptionO" value = "The Maple Leaf flag 
The Canadian National Flag was adopted by the Canadian 
Parliament on October 22, 1964 and was proclaimed into law 
by Her Majesty Queen Elizabeth II (the Queen of Canada) on 
February 15, 1965. The Canadian Flag (colloquially known 
as The Maple Leaf Flag) is a red flag of the proportions 
two by length and one by width, containing in its center a 
white square, with a single red stylized eleven-point 
maple leaf centered in the white square. "> 

Hint: Use the DescriptionPanel class to display the image, name, and the 
text. The DescriptionPanel class was introduced in Listing 17.6. 

1 8.1 9*** (Bouncing balls) The example in §18.8 simulates a bouncing ball. Extend the 
example to allow multiple balls, as shown in Figure 18.25(a). You may use the 
+ 7 or —1 button to increase or decrease the number of the balls, and use the 
Suspend and Resume buttons to freeze the balls or resume bouncing. For each 
ball, assign a random color. 
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Figure 1 8.25 (a) The applet allows you to add or remove bouncing balls, (b) Click Play to 
play an audio clip once, click Loop to play an audio repeatedly, and click Stop to terminate 
playing. 



1 8.20* (Playing, looping, and stopping a sound clip) Write an applet that meets the 
following requirements: 

■ Get an audio file. The file is in the class directory. 

■ Place three buttons labeled Play, Loop, and Stop, as shown in Figure 18.25(b). 

■ If you click the Play button, the audio file is played once. If you click the 
Loop button, the audio file keeps playing repeatedly. If you click the Stop 
button, the playing stops. 

■ The applet can run as an application. 
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1 8.2 I ** (Creating an alarm clock) Write an applet that will display a digital clock with 
a large display panel that shows hour, minute, and second. This clock should 
allow the user to set an alarm. Figure 18.26(a) shows an example of such a 
clock. To turn on the alarm, check the Alarm check box. To specify the alarm 
time, click the Set alarm button to display a new frame, as shown in Figure 
18.26(b). You can set the alarm time in the frame. 
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Figure 1 8.26 The program displays current hour, minute, and second and enables you to 
set an alarm. 



18.22** (Creating an image animator with audio) Create animation using the applet 
(see Figure 18.27) to meet the following requirements: 

■ Allow the user to specify the animation speed. The user can enter the speed 
in a text field. 

■ Get the number of frames and the image file-name prefix from the user. For 
example, if the user enters n for the number of frames and L for the image 
prefix, then the files are LI, L2, and so on, to L/i. Assume that the images 
are stored in the image directory, a subdirectory of the applet's directory. 

■ Allow the user to specify an audio file name. The audio file is stored in the 
same directory as the applet. The sound is played while the animation runs. 
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Figure 18.27 This applet lets the user select image files, audio file, and animation speed. 



18.23** (Simulation: raising flag and playing anthem) Create an applet that displays a 
flag rising up, as shown in Figure 1 5 . 1 . As the national flag rises, play the national 
anthem. (You may use a flag image and anthem audio file from Listing 18.13.) 

Comprehensive 

1 8.24** (Game: guessing birthdays) Listing 3.3, GuessBirthday.java, gives a program 
for guessing a birthday. Create an applet for guessing birthdays as shown in 
Figure 18.28. The applet prompts the user to check whether the date is in any 
of the five sets. The date is displayed in the text field upon clicking the Guess 
Birthday button. 

1 8.25*** (Game: Sudoku) §7.7 introduced the Sudoku problem. Write a program that lets 
the user enter the input from the text fields in an applet, as shown in Figure 18.1. 
Clicking the Solve button displays the result. 
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Figure 1 8.28 This applet guesses the birthdays. 



1 8. 26*** (Game: math quiz) Listing 3.1, AdditionQuiz.java, and Listing 3.4, Subtrac- 
tionQuiz.java, generate and grade Math quizzes. Write an applet that allows the 
user to select a question type and difficulty level, as shown in Figure 18.29(a). 
When the user clicks the Start button, the program begins to generate a ques- 
tion. After the user enters an answer with the Enter key, a new question is dis- 
played. When the user clicks the Start button, the elapse time is displayed. The 
time is updated every second until the Stop button is clicked. The correct count 
is updated whenever a correct answer is made. 
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(a) Before a session starts 
Figure 1 8.29 The applet tests math skills. 
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18.27*** (Simulation: traffic control) Exercise 17.3 uses the radio buttons to change 
the traffic lights. Revise the program that simulates traffic control at an inter- 
section, as shown in Figure 18.30. When the light turns red, the traffic flows 
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(a) The traffic flows vertically (b) The traffic flows horizontally 



Figure 18.30 The applet simulates traffic control. 
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vertically; when the light turns green, the traffic flows horizontally. The light 
changes automatically every one minute. Before the light changes to red from 
green, it first changes to yellow for a brief five seconds. 

18.28** (Geometry: two circles intersect?) The C"ircle2D class was defined in Exercise 
10.1 1. Write an applet that enables the user to specify the location and size of the 
circles and displays whether the two circles intersect, as shown in Figure 18.31(a). 
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(a) (b) (c) 

Figure 1 8.3 1 Check whether two circles, two rectangles, and two triangles are overlapping. 



18.29** (Geometry: two rectangles intersect?) The MyRectangl e2D class was 
defined in Exercise 10.12. Write an applet that enables the user to specify the 
location and size of the rectangles and displays whether the two rectangles 
intersect, as shown in Figure 18.31(b). 

18.30** (Geometry: two triangles intersect?) The Triangle2D class was defined in 
Exercise 10.13. Write an applet that enables the user to specify the location of 
the two triangles and displays whether the two triangles intersect, as shown in 
Figure 18.31(c). 

18.31*** (Game: bean-machine animation) Write an applet that animates a bean machine 
introduced in Exercise 16.22. The applet lets you set the number of slots, as 
shown in Figure 18.32. Click Start to start or restart the animation and click 
Stop to stop. 




(a) (b) (c) (d) 

Figure 18.32 (a)-(c) The applet controls a bean-machine animation, (d) The applet counts down the time. 



18.32* 



(Count-down alarm) Write an applet that allows the user to enter time in 
minutes in the text field and press the Enter key to count down the minutes, 
as shown in Figure 18.32(d). The remaining minutes are redisplayed every 
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one minute. When the minutes are expired, the program starts to play music 
continuously. 

18.33** {Pattern recognition: consecutive four equal numbers) Write an applet for 
Exercise 7.19, as shown in Figure 18.33 (a-b). Let the user enter the numbers 
in the text fields in a grid of 6 rows and 7 columns. The user can click the 
Solve button to highlight a sequence of four equal numbers, if it exists. 
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Figure 1 8.33 (a)-(b) Clicking the Solve button to highlight the four consecutive numbers in a 
row, a column, or a diagonal, (c) The applet enables two players to play the connect-four game. 



1 8.34*** (Game: connect four) Exercise 7.20 enables two players to play the connect- 
four game on the console. Rewrite the program using an applet, as shown in 
Figure 18.33(c). The applet enables two players to place red and yellow discs 
in turn. To place a disk, the player needs to click on an available cell. An 
available cell is unoccupied and whose downward neighbor is occupied. The 
applet flashes the four winning cells if a player wins and reports no winners if 
all cells are occupied with no winners. 



Chapter 



Binary I/O 



Objectives 



To discover how I/O is processed in Java (§19.2). 

To distinguish between text I/O and binary I/O (§19.3). 

To read and write bytes using Fil elnputStream and FileOutputStream (§19.4.1). 

To filter data using base classes Fil terlnputStream/Fil terOutputStream 

(§19.4.2). 

To read and write primitive values and strings using 
DatalnputStream/DataOutputStream (§19.4.3). 

To store and restore objects using ObjectOutputStream 
and ObjectlnputStream, and to understand how objects 
are serialized and what kind of objects can be 
serialized (§19.6). 

To implement the Serial izabl e interface to make objects 
serializable (§19.6.1). 

To serialize arrays (§19.6.2). 

To read and write files using the RandomAccessFile 
class (§19.7). 
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19.1 Introduction 

Data stored in a text file are represented in human-readable form. Data stored in a binary file 
are represented in binary form. You cannot read binary files. They are designed to be read by 
programs. For example, Java source programs are stored in text files and can be read by a text 
editor, but Java classes are stored in binary files and are read by the JVM. The advantage of 
binary files is that they are more efficient to process than text files. 

Although it is not technically precise and correct, you can envision a text file as consisting 
of a sequence of characters and a binary file as consisting of a sequence of bits. For example, 
the decimal integer 199 is stored as the sequence of three characters, ' 1 ' , ' 9 ' , ' 9 ' , in a text 
file, and the same integer is stored as a byte-type value C7 in a binary file, because decimal 
199 equals hex C7( 199 = 12 X 16 1 + 7). 

Java offers many classes for performing file input and output. These can be categorized as 
text I/O classes and binary I/O classes. In §9.7, "File Input and Output," you learned how to 
read/write strings and numeric values from/to a text file using Scanner and PrintWriter. 
This section introduces the classes for performing binary I/O. 

1 9.2 How is I/O Handled in Java? 

Recall that a Fil e object encapsulates the properties of a file or a path but does not contain 
the methods for reading/writing data from/to a file. In order to perform I/O, you need to cre- 
ate objects using appropriate Java I/O classes. The objects contain the methods for 
reading/writing data from/to a file. For example, to write text to a file named temp.txt, you 
may create an object using the PrintWriter class as follows: 

PrintWriter output = new PrintWriterCtemp.txt"); 

You can now invoke the print method from the object to write a string into the file. For 
example, the following statement writes "Java 101" to the file. 

output. print("Java 101"); 

The next statement closes the file. 

output . closeO ; 

There are many I/O classes for various purposes. In general, these can be classified as input 
classes and output classes. An input class contains the methods to read data, and an output 
class contains the methods to write data. PrintWriter is an example of an output class, and 
Scanner is an example of an input class. The following code creates an input object for the 
file temp.txt and reads data from the file. 

Scanner input = new Scanner(new File("temp.txt")) ; 
System . out . pri ntl n(i nput . next Li ne()) ; 

If temp.txt contains "Java 101", input. nextLineO returns string "Java 101". 

Figure 19.1 illustrates Java I/O programming. An input object reads a stream of data from 
input stream a file, and an output object writes a stream of data to a file. An input object is also called an 

output stream input stream and an output object an output stream. 

19.3 Text I/O vs. Binary I/O 

Computers do not differentiate binary files and text files. All files are stored in binary format, and 
thus all files are essentially binary files. Text I/O is built upon binary I/O to provide a level of 
abstraction for character encoding and decoding, as shown in Figure 19.2(a). Encoding and 
decoding are automatically performed for text I/O. The JVM converts a Unicode to a file-specific 
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Figure 19.1 The program receives data through an input object and sends data through an 
output object. 

encoding when writing a character and converts a file-specific encoding to a Unicode when 
reading a character. For example, suppose you write string "199" using text I/O to a file. Each 
character is written to the file. Since the Unicode for character ' 1' is 0x0031, the Unicode 
0x0031 is converted to a code that depends on the encoding scheme for the file. (Note that the 
prefix Ox denotes a hex number.) In the United States, the default encoding for text files on Win- 
dows is ASCII. The ASCII code for character ' 1 ' is 49 (0x31 in hex) and for character ' 9 ' is 
57 (0x39 in hex). So to write the characters "199", three bytes — 0x31, 0x39, and 0x39 — are 
sent to the output, as shown in Figure 19.2(a). 

§ Note 

The new version of Java supports supplementary Unicode. For simplicity, however, this book con- 
siders only the original Unicode from to FFFF. 

Binary I/O does not require conversions. If you write a numeric value to a file using binary 
I/O, the exact value in the memory is copied into the file. For example, a byte-type value 199 
is represented as 0xC7 (199 = 12 X 16 1 + 7) in the memory and appears exactly as 0xC7 in 
the file, as shown in Figure 19.2(b). When you read a byte using binary I/O, one byte value is 
read from the input. 

In general, you should use text input to read a file created by a text editor or a text output 
program, and use binary input to read a file created by a Java binary output program. 
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Figure 1 9.2 Text I/O requires encoding and decoding, whereas binary I/O does not. 
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Binary I/O is more efficient than text I/O, because binary I/O does not require encoding 
and decoding. Binary files are independent of the encoding scheme on the host machine and 
thus are portable. Java programs on any machine can read a binary file created by a Java pro- 
gram. This is why Java class files are binary files. Java class files can run on a JVM on any 
machine. 



.txt and .dat 



Note 

For consistency, this book uses the extension .txt to name text files and .dat to name binary 
files. 



19.4 Binary I/O Classes 



The design of the Java I/O classes is a good example of applying inheritance, where common 
operations are generalized in superclasses, and subclasses provide specialized operations. 
Figure 19.3 lists some of the classes for performing binary I/O. InputStream is the root for 
binary input classes, and OutputStream is the root for binary output classes. Figures 19.4 
and 19.5 list all the methods in InputStream and OutputStream. 
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Figure 19.3 InputStream, OutputStream, and their subclasses are for binary I/O. 



java. io.InputStream 


+read(): int 




+read(b: byte[]): int 




+read(b: byte[], off: 
len: int): int 


int, 


+available() : int 
+close(): void 
+skip(n: long): long 




+markSupported() : boolean 
+mark(readlimit: int): void 
+reset(): void 



Reads the next byte of data from the input stream. The value byte is returned as 
an i nt value in the range to 2 5 5. If no byte is available because the end of 
the stream has been reached, the value -1 is returned. 

Reads up to b . 1 ength bytes into array b from the input stream and returns the 
actual number of bytes read. Returns -I at the end of the stream. 

Reads bytes from the input stream and stores them in b [off] , b [of f +1] , . . 

b [of f +1 en-1] . The actual number of bytes read is returned. Returns -1 
at the end of the stream. 

Returns an estimate of the number of bytes that can be read from the input stream. 

Closes this input stream and releases any system resources occupied by it. 

Skips over and discards n bytes of data from this input stream. The actual 
number of bytes skipped is returned. 

Tests whether this input stream supports the mark and reset methods. 

Marks the current position in this input stream. 

Repositions this stream to the position at the time the mark method was last 
called on this input stream. 



Figure 1 9.4 The abstract InputStream class defines the methods for the input stream of bytes. 
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java. io. OutputStream 



+write(int fa): void 

+write(b: byte[]): void 

+write(b: byte[], off: int, 
len: int) : void 

+close(): void 

+flush(): void 



Writes the specified byte to this output stream. The parameter b is an i nt value, 
(byte) b is written to the output stream. 

Writes all the bytes in array b to the output stream. 

Writes b[off] , b[off+l] , . . . , b[off+len-l] into the output stream. 

Closes this output stream and releases any system resources occupied by it. 
Flushes this output stream and forces any buffered output bytes to be written out. 



Figure 19.5 The abstract OutputStream class defines the methods for the output stream of bytes. 



Note 

All the methods in the binary I/O classes are declared to throw java.io.IOException or a 
subclass of java. io.IOExcept ion. 



throws IOException 



1 9.4- 1 Fil elnputSt ream/Fil eOutputStream 

FilelnputStream/FileOutputStream is for reading/writing bytes from/to files. All the 
methods in these classes are inherited from InputStream and OutputStream. 
FilelnputStream/FileOutputStream does not introduce new methods. To construct a 
FilelnputStream, use the following constructors, as shown in Figure 19.6: 



java. io. InputStream 



javo.io.FilelnputStream 



+FileInputStream(file: File) 

+Fi 1 eInputStream(f i 1 ename : Stri ng) 



Creates a Fi 1 elnputSt ream from a Fi le object. 
Creates a Fi 1 elnputSt ream from a file name. 



Figure 19.6 FilelnputStream inputs a stream of bytes from a file. 



A java.io.FileNotFoundException will occur if you attempt to create a File- 
lnputStream with a nonexistent file. 

To construct a Fil eOutputStream, use the constructors shown in Figure 19.7. 



FileNotFoundException 



java. io. OutputStream 



t 



java.io.FileOutputStream 



+FileOutputStream(file: File) 
+Fi 1 eOutputStream (fi 1 ename : Stri ng) 
+FileOutputStream(file: File, append: boolean) 
+FileOutputStream(filename: String, append: boolean) 



Creates a Fi 1 eOutputStream from a File object. 
Creates a Fi 1 eOutputStream from a file name. 
If append is true, data are appended to the existing file. 
If append is true, data are appended to the existing file. 



Figure 19.7 FileOutputStream outputs a stream of bytes to a file. 



If the file does not exist, a new file will be created. If the file already exists, the first two con- 
structors will delete the current content of the file. To retain the current content and append new 
data into the file, use the last two constructors by passing true to the append parameter. 



9 Binary I/O 



Almost all the methods in the I/O classes throw java. io.IOException. Therefore you 
have to declare java. io. IOExcept ion to throw in the method or place the code in a try- 
catch block, as shown below: 



Declaring exception in the method 



public static void man n(Stri ng [] args) 
throws IOException { 

// Perform I/O operations 

} 



Using try-catch block 



public static void main(String[] args) { 
try { 

// Perform I/O operations 

} 

catch (IOException ex) { 
ex.printStackTraceO ; 

} 

} 



Listing 19.1 uses binary I/O to write ten byte values from 1 to 10 to a file named temp.dat 
and reads them back from the file. 



Listing 19. 1 TestFileSt ream, java 



1 

2 
3 
4 
5 
6 
7 
8 
9 
10 
11 
12 
13 
14 
15 
16 
17 
18 
19 
20 
21 
22 
23 
24 
25 
26 



import java.io.*; 

public class TestFi 1 eStream { 

public static void main(String[] args) throws IOException { 

// Create an output stream to the file 

FileOutputStream output = new FileOutputStreamCtemp.dat"); 

// Output values to the file 
for (int i = 1; i <= 10; i++) 
output .wri te(i ) ; 

// Close the output stream 
output . close() ; 

// Create an input stream for the file 

Fi 1 elnputStream input = new FileInputStream("temp.dat") ; 

// Read values from the file 
int value; 

while ((value = input. read()) != -1) 
System. out. print(value + " "); 

// Close the output stream 
input. close() ; 



123456789 10 



A FileOutputStream is created for file temp.dat in line 6. The for loop writes ten 
byte values into the file (lines 9-10). Invoking write(i) is the same as invoking 
write((byte)i). Line 13 closes the output stream. Line 16 creates a FilelnputStream 
for file temp.dat. Values are read from the file and displayed on the console in lines 19-21. 
The expression ((value = input, read ()) != -1) (line 20) reads a byte from 
input . read(), assigns it to value, and checks whether it is -1. The input value of -1 
signifies the end of a file. 
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The file temp.dat created in this example is a binary file. It can be read from a Java 
program but not from a text editor, as shown in Figure 19.8. 



Binary data 



* ' : Command Prompt - cmd 



Z: \booSO jaua ehapterl S . TestFileStream ~±\ 



1 23156789 13 
C :\book>type temp.dat 

C:\t>ook>_ 



Figure 19.8 A binary file cannot be displayed in text mode. 



# Tip 

When a stream is no longer needed, always close it using the close() method. Not closing close stream 

streams may cause data corruption in the output file, or other programming errors. 

§ Note 

The root directory for the file is the classpath directory. For the example in this book, the root 
directory is c:\book. So the file temp.dat is located at c:\book. If you wish to place temp.dat 

in a specific directory, replace line 8 by where is the file? 

Fi 1 eOutputStream output = 

new Fi 1 eOutputStream("di rectory/temp. dat") ; 

|j§| Note 

An instance of FilelnputStream can be used as an argument to construct a Scanner, and 
an instance of FileOutputStream can be used as an argument to construct a 

PrintWriter. You can create a Printwriter to append text into a file using appending to text file 

new Pri ntWri ter(new FileOutputStream("temp.txt", true)); 

If temp.txt does not exist, it is created. If temp.txt already exists, new data are appended to the file. 

1 9.4-2 Fil terlnputStream/Fil terOutputStream 

Filter streams are streams that filter bytes for some purpose. The basic byte input stream pro- 
vides a read method that can be used only for reading bytes. If you want to read integers, 
doubles, or strings, you need a filter class to wrap the byte input stream. Using a filter class 
enables you to read integers, doubles, and strings instead of bytes and characters. 
Fil terlnputStream and Fil terOutputStream are the base classes for filtering data. 
When you need to process primitive numeric types, use DatalnputStream and 
DataOutputStream to filter bytes. 

1 9.4-3 DatalnputStream/DataOutputStream 

DatalnputStream reads bytes from the stream and converts them into appropriate primitive 
type values or strings. DataOutputStream converts primitive type values or strings into 
bytes and outputs the bytes to the stream. 

DatalnputStream extends Fil terlnputStream and implements the Datalnput 
interface, as shown in Figure 19.9. DataOutputStream extends Fil terOutputStream 
and implements the DataOutput interface, as shown in Figure 19.10. 

DatalnputStream implements the methods defined in the Datalnput interface to read 
primitive data type values and strings. DataOutputStream implements the methods defined 
in the DataOutput interface to write primitive data type values and strings. Primitive values 
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InputStream 
2£ 



FilterlnputStream | 



«interface» 
java. io.Datalnput 



DatalnputStream 



+DataInputStream( 
in: InputStream) 



+readBoolean() : boolean 
+readByte() : byte 
+readChar(): char 
+readFloat() : float 
+readDouble() : double 
+readlnt(): int 
+readLong(): long 
+readShort() : short 
+readLi ne() : String 
+readUTF() : String 



Reads a Boolean from the input stream. 
Reads a byte from the input stream. 
Reads a character from the input stream. 
Reads a f 1 oat from the input stream. 
Reads a doubl e from the input stream. 
Reads an i nt from the input stream. 
Reads a 1 ong from the input stream. 
Reads a short from the input stream. 
Reads a line of characters from input. 
Reads a string in UTF format. 



Figure 1 9.9 DatalnputStream filters an input stream of bytes into primitive data type values and strings. 



OutputStream 



Fi 1 terOutputStream 



T 



«interface» 
java. io.DataOutput 



DataOutputStream 



+DataOutputStream 
(out: OutputStream) 



+writeBoolean(b: boolean): void 
+writeByte(v: int): void 

+writeBytes(s: String): void 

+writeChar(c: char): void 

+writeChars(s: String): void 

+writeFloat(v: float): void 
+writeDouble(v: double): void 
+writelnt(v: int): void 
+writeLong(v: long): void 
+writeShort(v: short): void 
+writeUTF(s: String): void 



Writes a Boolean to the output stream. 

Writes the eight low-order bits of the argument v to 
the output stream. 

Writes the lower byte of the characters in a string to 
the output stream. 

Writes a character (composed of 2 bytes) to the 
output stream. 

Writes every character in the string s to the output 
stream, in order, 2 bytes per character. 

Writes a f 1 oat value to the output stream. 

Writes a doubl e value to the output stream. 

Writes an i nt value to the output stream. 

Writes a long value to the output stream. 

Writes a short value to the output stream. 

Writes s string in UTF format. 



Figure 19.10 DataOutputStream enables you to write primitive data type values and strings into an output stream. 

are copied from memory to the output without any conversions. Characters in a string may be 
written in several ways, as discussed in the next section. 

Characters and Strings in Binary I/O 

A Unicode consists of two bytes. The writeChar(char c) method writes the Unicode of 
character c to the output. The writeChars(String s) method writes the Unicode for each 
character in the string s to the output. The wri teBytes(String s) method writes the lower 
byte of the Unicode for each character in the string s to the output. The high byte of the Uni- 
code is discarded. The writeBytes method is suitable for strings that consist of ASCII char- 
acters, since an ASCII code is stored only in the lower byte of a Unicode. If a string consists 
of non- ASCII characters, you have to use the wri teChar s method to write the string. 

The writeUTFCString s) method writes two bytes of length information to the output 
stream, followed by the modified UTF-8 representation of every character in the string s. 
UTF-8 is a coding scheme that allows systems to operate with both ASCII and Unicode. Most 
operating systems use ASCII. Java uses Unicode. The ASCII character set is a subset of the 
Unicode character set. Since most applications need only the ASCII character set, it is a waste 
to represent an 8-bit ASCII character as a 16-bit Unicode character. The modified UTF-8 
scheme stores a character using one, two, or three bytes. Characters are coded in one byte if 



19.4 Binary I/O Classes 657 



their code is less than or equal to 0x7F, in two bytes if their code is greater than 0x7F and less 
than or equal to 0x7FF, or in three bytes if their code is greater than 0x7FF. 

The initial bits of a UTF-8 character indicate whether a character is stored in one byte, two UTF-8 scheme 
bytes, or three bytes. If the first bit is 0, it is a one-byte character. If the first bits are 110, it is 
the first byte of a two-byte sequence. If the first bits are 1110, it is the first byte of a three-byte 
sequence. The information that indicates the number of characters in a string is stored in the 
first two bytes preceding the UTF-8 characters. For example, writeUTF("ABCDEF") actu- 
ally writes eight bytes (i.e., 00 06 41 42 43 44 45 46) to the file, because the first two bytes 
store the number of characters in the string. 

The writeUTF(String s) method converts a string into a series of bytes in the UTF-8 
format and writes them into a binary stream. The readUTFO method reads a string that has 
been written using the wr i teUTF method. 

The UTF-8 format has the advantage of saving a byte for each ASCII character, because a 
Unicode character takes up two bytes and an ASCII character in UTF-8 only one byte. If most 
of the characters in a long string are regular ASCII characters, using UTF-8 is efficient. 

Using DatalnputStream/DataOutputStream 

Data streams are used as wrappers on existing input, and output streams to filter data in the orig- 
inal stream. They are created using the following constructors (see Figures 19.9 and 19.10): 

public DataInputStream(InputStream instream) 
public Data0utputStream(0utputStream outstream) 

The statements given below create data streams. The first statement creates an input stream 
for file in.dat; the second statement creates an output stream for file out.dat. 

DatalnputStream input = 

new DatalnputStream (new FileInputStreamCin.dat")); 
DataOutputStream output = 

new DataOutputStream (new FileOutputStream("out.dat")) I 

Listing 19.2 writes student names and scores to a file named temp.dat and reads the data back 
from the file. 

Listing 19.2 TestDataStream. java 

1 i mpor t j ava . i o . * ; 

2 

3 public class TestDataStream { 

4 public static void main(String[] args) throws IOException { 

5 // Create an output stream for file temp.dat 

6 DataOutputStream output = output stream 

7 new DataOutputStream(new FileOutputStream("temp.dat")) ; 



8 
9 
10 
11 
12 
13 
14 
15 
16 
17 
18 
19 
20 
21 
22 
23 



// Write student test scores to the file 

output. writeUTFC'John") ; 

output .wri teDoubl e(85 . 5) ; 

output. writeUTFC'Jim") ; 

output .wri teDoubl e( 185 . 5) ; 

output .wri teUTF("George") ; 

output .wri teDoubl e( 105 . 25) ; 



// Close output stream 
output . closeQ ; 



// Create an input stream for file temp.dat 
DatalnputStream input = 

new DataInputStream(new FileInputStream("temp.dat")) ; 



input stream 



close stream 



output 
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24 // Read student test scores from the file 

input 2 5 System. out. pri ntln (input. readUTFO + " " + input. readDoubl e() ) 

26 System. out. println(input. readUTFO + " " + input. readDoubleO) 

27 System. out. println(input. readUTFO + " " + input. readDoubleO) 

28 } 

29 } 




George 105.25 



A DataOutputStream is created for file temp.dat in lines 6-7. Student names and scores 
are written to the file in lines 10-15. Line 18 closes the output stream. A DatalnputStream 
is created for the same file in lines 21-22. Student names and scores are read back from the 
file and displayed on the console in lines 25-27. 

DatalnputStream and DataOutputStream read and write Java primitive type values 
and strings in a machine-independent fashion, thereby enabling you to write a data file on one 
machine and read it on another machine that has a different operating system or file structure. 
An application uses a data output stream to write data that can later be read by a program 
using a data input stream. 

Caution 

" You have to read data in the same order and format in which they are stored. For example, since 
names are written in UTF-8 using wri teUTF, you must read names using readUTF. 

Detecting End of File 

EOFException If you keep reading data at the end of an InputStream, an EOFException will occur. This 

exception may be used to detect the end of file, as shown in Listing 19.3. 

Listing 19.3 DetectEndOf Fi le. java 

1 import java.io.-; 





2 
3 


public class DetectEndOf Fi 1 e { 




4 


public static void main(String[] args) { 




5 


try { 


output stream 


6 




DataOutputStream output = new DataOutputStream 




7 




(new FileOutputStreamCtest.dat")) ; 


output 


8 




output. writeDouble(4. 5) ; 




9 




output .wri teDoubl e(43 . 25) ; 




10 




output .wri teDoubl e (3 . 2) ; 


close stream 


11 




output. close() ; 




12 






input stream 


13 




DatalnputStream input = new DatalnputStream 




14 




(new FileInputStream("test.dat")) ; 




15 




while (true) { 


input 


16 




System. out. pri ntln(input. readDoubleO ) ; 




17 




} 




18 


} 




EOFException 


19 


catch (EOFException ex) { 




20 




System.out.println("All data read"); 




21 


} 






22 


catch (IOException ex) { 




23 




ex . pri ntStackTrace() ; 




24 


} 






25 


} 






26 


} 
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4.5 

43.25 

3.2 

All data read 



The program writes three double values to the file using DataOutputStream (lines 6-10), 
and reads the data using DatalnputStream (lines 13-17). When reading past the end of file, 
an EOFException is thrown. The exception is caught in line 19. 

1 9.4-4 Buf feredlnputStream/Buf feredOutputStream 

Buf feredlnputStream/Buf feredOutputStream can be used to speed up input and 
output by reducing the number of reads and writes. Buf feredlnputStream/ 
Buf feredOutputStream does not contain new methods. All the methods in 
Buf feredlnputStream/BufferedOutputStream are inherited from the InputStream/ 
OutputStream classes. Buf feredlnputStream/Buf feredOutputStream adds a buffer in 
the stream for storing bytes for efficient processing. 

You may wrap a Buf feredlnputStream/Buf feredOutputStream on any 
InputStream/OutputStream using the constructors shown in Figures 19.11 and 19.12. 



java. io. InputStream 



J 



java. io. Fi 1 terlnputStream 



T 



java.io.BufferedlnputStream 



+BufferedInputStream(i n : InputStream) 

+BufferedInputStream(fi 1 ename : String, bufferSize: int) 



Figure 19.11 Buf feredlnputStream buffers input stream. 



Creates a BufferedlnputStream from an 
InputStream object. 

Creates a BufferedlnputStream from an 
InputStream object with specified buffer size. 



java. io. OutputStream 



J 



java.io. FilterOutputStream 



T 



java.io.BufferedOutputStream 



+BufferedOutputStream(out : OutputStream) 
+Buffered0utputStream(fi1ename: String, bufferSize: int) 



Creates a BufferedOutputStream from an 
OutputStream object. 

Creates a BufferedOutputStream from an 
OutputStream object with specified size. 



Figure 19.12 BufferedOutputStream buffers output stream. 
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If no buffer size is specified, the default size is 512 bytes. A buffered input stream reads as 
many data as possible into its buffer in a single read call. By contrast, a buffered output stream 
calls the write method only when its buffer fills up or when the fl ush() method is called. 

You can improve the performance of the TestDataStream program in the preceding 
example by adding buffers in the stream in lines 6-7 and 13-14 as follows: 

DataOutputStream output = new DataOutputStream( 

new Buf feredOutputStream (new Fi I eOutputSt ream (" temp. dat"))) ; 

DatalnputStream input = new DataInputStream( 

new BufferedlnputStream (new FilelnputSt ream ("temp. dat"))) ; 

# Tip 

You should always use buffered 10 to speed up input and output. For small files, you may not 
notice performance improvements. However, for large files — over 100 MB — you will see substan- 
tial improvements using buffered 10. 



19.5 Problem: Copying Files 

This section develops a program that copies files. The user needs to provide a source file and 
a target file as command-line arguments using the following command: 



Video Note 

Copy file java Copy source target 



The program copies a source file to a target file and displays the number of bytes in the file. If 
the source does not exist, the user is told that the file has not been found. If the target file 
already exists, the user is told that the file exists. A sample run of the program is shown in 
Figure 19.13. 





Command Prompt 


_|n| 


x| 


File exists >- 


C : \book> jaua Copy Welcome. jaua Temp.jaua 
Target file Temp.jaua already exists 




i 


Delete file >- 


C:\book>del Temp.jaua 






Copy *- 


C : \book> jaua Copy Welcome . jaua Temp.jaua 
The file Welcome . jaua has 176 bytes 
Copy done! 






Source does >- 

not exist 


C:\book>jaua Copy TTT.jaua Temp.jaua 
Source file TTT.jaua not exist 








C:\book> 






<\ I 



Figure 19.13 The program copies a file. 



To copy the contents from a source to a target file, it is appropriate to use a binary input 
stream to read bytes from the source file and a binary output stream to send bytes to the target 
file, regardless of the contents of the file. The source file and the target file are specified from 
the command line. Create an InputFileStream for the source file and an 
OutputFileStream for the target file. Use the read() method to read a byte from the input 
stream, and then use the write (b) method to write the byte to the output stream. Use 
BufferedlnputStream and Buf feredOutputStream to improve the performance. Listing 
19.4 gives the solution to the problem. 
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Listing 19.4 Copy.java 

1 import java.io.*; 

2 

3 public class Copy { 



4 /** Main method 

5 ©param args[0] for sourcefile 

6 Oparam args[l] for target file 

7 V 

8 public static void main(String[] args) throws IOException { 

9 // Check command-line parameter usage 

10 if (args. length != 2) { check usage 

11 System. out . pri ntl n( 

12 "Usage: java Copy sourceFile targetf il e") ; 

13 System. exit(0) ; 

14 } 
15 

16 // Check whether source file exists 

17 File sourceFile = new Fi 1 e(args [0] ) ; sourcefile 

18 if (IsourceFile.existsO) { 

19 System. out. pri ntl n("Source file " + args[0] + " not exist"); 

20 System. exi t(0) ; 

21 } 
22 

23 // Check whether target file exists 

24 File targetFile = new Fi 1 e(args [1] ) ; target file 

25 if (targetFile. existsO) { 

26 System. out . pri ntl n("Target file " + args[l] + " already 

27 exists"); 

28 System. exit(0) ; 

29 } 
30 

31 // Create an input stream 

32 BufferedlnputStream input = input stream 

33 new BufferedInputStream(new Fi 1 eInputStream(sourceFi 1 e)) ; 
34 

35 // Create an output stream 

36 BufferedOutputStream output = output stream 

37 new BufferedOutputStream(new FileOutputStream(targetFile)) ; 
38 

39 // Continuously read a byte from input and write it to output 

40 int r; int numberOf BytesCopi ed = 0; 

41 while ((r = input. read() ) != -1) { read 

42 output .wri te( (byte) r) ; write 

43 numberOfBytesCopied++; 

44 } 
45 

46 // Close streams 

47 i nput. close () ; close stream 

48 output. close() ; 
49 

50 // Display the file size 

51 System . out . pri ntl n (numberOfBytesCopi ed + " bytes copied"); 

52 } 



53 } 

The program first checks whether the user has passed two required arguments from the com- 
mand line in lines 10-14. 

The program uses the File class to check whether the source file and target file exist. If 
the source file does not exist (lines 18-21) or if the target file already exists, exit the program. 
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An input stream is created using Buf feredlnputStream wrapped on Fil elnputStream 
in lines 32-33, and an output stream is created using Buf feredOutputStream wrapped on 
FileOutputStream in lines 36-37. 

The expression ((r = input . readO) != -1) (line 41) reads a byte from input. 
read(), assigns it to r, and checks whether it is -1. The input value of -1 signifies the end of 
a file. The program continuously reads bytes from the input stream and sends them to the out- 
put stream until all of the bytes have been read. 

19.6 Object I/O 

DatalnputStream/DataOutputStream enables you to perform I/O for primitive type 
values and strings. ObjectlnputStream/ObjectOutputStream enables you to perform 
I/O for objects in addition to primitive type values and strings. Since ObjectlnputStream/ 
ObjectOutputStream contains all the functions of DatalnputStream/ 
DataOutputStream, you can replace DatalnputStream/DataOutputStream com- 
pletely with ObjectlnputStream/ObjectOutputStream. 

ObjectlnputStream extends InputStream and implements Objectlnput and 
ObjectStreamConstants, as shown in Figure 19.14. Objectlnput is a subinterface of 
Datalnput. Datalnput is shown in Figure 19.9. ObjectStreamConstants contains the 
constants to support ObjectlnputStream/ObjectOutputStream. 




Video Note 

Object I/O 



java. io. InputStream | 



java.io.ObjectInputStream 



«i nterface» 
ObjectStreamConstants 




+ObjectInputStream(i n : InputStream) 



«i nterface» 
java. io. Datalnput 

_ ^ _ 

«interface» 
java. io. Objectlnput 



+readObject() : Object 



Reads an object. 



Figure 19.14 ObjectlnputStream can read objects, primitive type values, and strings. 



ObjectOutputStream extends OutputStream and implements ObjectOutput and 
ObjectStreamConstants, as shown in Figure 19.15. ObjectOutput is a subinterface of 
DataOutput. DataOutput is shown in Figure 19.10. 



java. io. OutputStream | 







java.io.Object 


OutputStream 


+0bject0utputStream(out : OutputStream) 



«i nterface» 
ObjectStreamConstants 



«i nterface» 
java. io .DataOutput 



-■M 



«interface» 
java. io. ObjectOutput 



+writeObject(o: Object): void 



Writes an object. 



Figure 19.15 ObjectOutputStream can write objects, primitive type values, and strings. 
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You may wrap an ObjectlnputStream/ObjectOutputStream on any InputStream/ 
OutputStream using the following constructors: 

// Create an ObjectlnputStream 
public ObjectInputStream(InputStream in) 

// Create an ObjectOutputStream 
public ObjectOutputStream(OutputStream out) 

Listing 19.5 writes student names, scores, and current date to a file named object.dat. 

Listing 19.5 TestObjectOutputStream. java 

1 import java. io.*; 

2 

3 public class TestObjectOutputStream { 

4 public static void main(String[] args) throws IOException { 

5 // Create an output stream for file object.dat 

6 ObjectOutputStream output = 

7 new ObjectOutputStream(new FileOutputStream("object.dat")) ; 
8 

9 // Write a string, double value, and object to the file 

10 output. writeUTFC'John") ; 

11 output. writeDouble(85. 5) ; 

12 output .wri teObject(new java.util .DateO) ; 
13 

14 // Close output stream 

15 output . closeO ; 

16 } 

17 } 

An ObjectOutputStream is created to write data into file object.dat in lines 6-7. A string, 
a double value, and an object are written to the file in lines 10-12. To improve performance, 
you may add a buffer in the stream using the following statement to replace lines 6-7: 

ObjectOutputStream output = new ObjectOutputStream( 

new BufferedOutputStream(new FileOutputStreamCobject.dat"))) ; 

Multiple objects or primitives can be written to the stream. The objects must be read back 
from the corresponding ObjectlnputStream with the same types and in the same order as 
they were written. Java's safe casting should be used to get the desired type. Listing 19.6 reads 
data back from object.dat. 

Listing 19.6 TestObjectlnputStream. java 

1 i mport j ava . i o . * ; 

2 

3 public class TestObjectlnputStream { 

4 public static void main(String[] args) 

5 throws ClassNotFoundException, IOException { 

6 // Create an input stream for file object.dat 

7 ObjectlnputStream input = 

8 new ObjectInputStream(new FileInputStream("object.dat")) ; 

9 

10 // Write a string, double value, and object to the file 

11 String name = i nput . readUTFO ; 

12 double score = input. readDoubleO ; 

13 java.util .Date date = (java.util .Date) (input. readObjectO) ; 

14 System. out. println(name + + score + " " + date); 
15 



output stream 



output 



input stream 



input 
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16 // Close output stream 

17 input. closefj ; 

18 } 

19 } 




John 85.5 Mon lun 26 17:17:29 EDT 2006 



ClassNotFoundException The readObjectO method may throw java.lang. ClassNotFoundException. The reason 

is that when the JVM restores an object, it first loads the class for the object if the class has not 
been loaded. Since ClassNotFoundException is a checked exception, the main method 
declares to throw it in line 5. An ObjectlnputStream is created to read input from objectdat in 
lines 7-8. You have to read the data from the file in the same order and format as they were written 
to the file. A string, a double value, and an object are read in lines 11-13. Since readObjectO 
returns an Object, it is cast into Date and assigned to a Date variable in line 13. 

19.6.1 The Serial izable Interface 

Not every object can be written to an output stream. Objects that can be so written are said to 
be serializable. A serializable object is an instance of the java. io. Serial izable inter- 
face, so the object's class must implement Serial izable. 

The Ser i al i zabl e interface is a marker interface. Since it has no methods, you don't need to 
add additional code in your class that implements Serial izabl e. Implementing this interface 
enables the Java serialization mechanism to automate the process of storing objects and arrays. 

To appreciate this automation feature, consider what you otherwise need to do in order to 
store an object. Suppose you want to store a JButton object. To do this you need to store all 
the current values of the properties (e.g., color, font, text, alignment) in the object. Since 
JButton is a subclass of AbstractButton, the property values of AbstractButton have 
to be stored as well as the properties of all the superclasses of AbstractButton. If a prop- 
erty is of an object type (e.g., background of the Color type), storing it requires storing all 
the property values inside this object. As you can see, this is a very tedious process. Fortu- 
nately, you don't have to go through it manually. Java provides a built-in mechanism to auto- 
mate the process of writing objects. This process is referred to as object serialization, which 
is implemented in ObjectOutputStream. In contrast, the process of reading objects is 
referred to as object deserialization, which is implemented in ObjectlnputStream. 

Many classes in the Java API implement Serializable. The utility classes, such as 
java.util .Date, and all the Swing GUI component classes implement Serializable. 
Attempting to store an object that does not support the Serial izabl e interface would cause 
a NotSer i al i zabl eException. 

When a serializable object is stored, the class of the object is encoded; this includes the class 
name and the signature of the class, the values of the object's instance variables, and the closure 
of any other objects referenced from the initial object. The values of the object's static variables 
are not stored. 

Note 

nonserializable fields 

[f an object is an instance of Serial izable but contains nonserializable instance data fields, 
can it be serialized? The answer is no. To enable the object to be serialized, mark these data fields 
transient with the transient keyword to tell the JVM to ignore them when writing the object to an 

object stream. Consider the following class: 

public class Foo implements java.io. Serial izable { 
private int vl; 
private static double v2 ; 
private transient A v3 = new A() ; 

} 

class A { } // A is not serializable 



serializable 



serialization 
deserialization 



NotSerial izabl e- 
Exception 
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When an object of the Foo class is serialized, only variable vl is serialized. Variable v2 is not 
serialized because it is a static variable, and variable v3 is not serialized because it is marked 
transient. If v3 were not marked transient, a java. io.NotSerial izable- 
Exception would occur. 




Note 



duplicate objects 

If an object is written to an object stream more than once, will it be stored in multiple copies? No, 
it will not. When an object is written for the first time, a serial number is created for it. The JVM 
writes the complete content of the object along with the serial number into the object stream. 
After the first time, only the serial number is stored if the same object is written again. When the 
objects are read back, their references are the same, since only one object is actually created in the 
memory. 

19.6.2 Serializing Arrays 

An array is serializable if all its elements are serializable. An entire array can be saved using 
writeObject into a file and later can be restored using readObject. Listing 19.7 stores an array 
of five i nt values and an array of three strings and reads them back to display on the console. 

Listing 19.7 TestObjectStreamForArray . java 

1 import java.io.*; 

2 

3 public class TestObjectStreamForArray { 

4 public static void main(String[] args) 



5 throws CI assNotFoundExcepti on , IOException { 

6 int[] numbers = {1, 2, 3, 4, 5}; 

7 String[] strings = {"John", "Jim", "Jake"}; 
8 

9 // Create an output stream for file array.dat 

10 ObjectOutputStream output = output stream 

11 new ObjectOutputStream(new Fi 1 eOutputStream 

12 ("array.dat", true)); 
13 

14 // Write arrays to the object output stream store array 

15 output. writeObject(numbers) ; 

16 output. writeObject(strings) ; 
17 

18 // Close the stream 

19 output. close() ; 
20 

21 // Create an input stream for file array.dat 

22 ObjectlnputStream input = input stream 

23 new ObjectInputStream(new FileInputStream("array.dat")) ; 
24 

25 int[] newNumbers = (int[j) (input. readObject ()) ; restore array 

26 String [] newStrings = (Stri ng [] ) (i nput . readObjectO) ; 
27 

28 // Display arrays 

29 for (int i = 0; i < newNumbers . 1 ength ; i++) 

30 System. out. print(newNumbers[i] + " ") ; 

31 System . out . pri ntl n () ; 

32 

33 for (int i = 0; i < newStri ngs . 1 ength ; i++) 

34 System. out. print(newStrings[i] + " ") ; 



35 } 

36 } 
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1 2 3 4 5 
John Jim Jake 



Lines 15-16 write two arrays into file array.dat. Lines 25-26 read three arrays back in the 
same order they were written. Since readObjectO returns Object, casting is used to cast 
the objects into i nt [] and Stri ng [] . 

19.7 Random-Access Files 

read-only All of the streams you have used so far are known as read-only or write-only streams. The exter- 

write only na ^ ^ es °^ these streams are sequential files that cannot be updated without creating a new file. 

It is often necessary to modify files or to insert new records into files. Java provides the 
sequential RandomAccessFile class to allow a file to be read from and written to at random locations. 

The RandomAccessFile class implements the Datalnput and DataOutput interfaces, 
as shown in Figure 19.16. The Datalnput interface shown in Figure 19.9 defines the meth- 
ods (e.g., readlnt, readDouble, readChar, readBoolean, readUTF) for reading primi- 
tive type values and strings, and the DataOutput interface shown in Figure 19.10 defines the 
methods (e.g., writelnt, writeDouble, writeChar, writeBoolean, writeUTF) for 
writing primitive type values and strings. 



«i nterface» 
java. io. Datalnput 



«i nterface» 
java. io. DataOutput 




java.io.RandomAccessFile 



+RandomAccessFile(file: File, mode: 
Stri ng) 

+RandomAccessFi 1 e (name : Stri ng , 
mode: String) 

+close(): void 

+getFi 1 ePoi nter() : long 

+length(): long 
+read(): int 
+read(b: byte[]): int 

+read(b: byte[], off: int, len: int): int 
+seek(pos: Jong): void 

+setl_ength(newl_ength : long): void 
+ski pBytes(i nt n) : int 
+write(b: byte[]): void 

+write(b: byte[], off: int, len: int): 
void 



Creates a RandomAccessFi 1 e stream with the specified Fi 1 e object 
and mode. 

Creates a RandomAccessFi 1 e stream with the specified file name, 
string, and mode. 

Closes the stream and releases the resource associated with it. 

Returns the offset, in bytes, from the beginning of the file to where the 

next read or wri te occurs. 
Returns the length of this file. 

Reads a byte of data from this file and returns -1 at the end of stream. 

Reads up to b . 1 ength bytes of data from this file into an array of bytes. 

Reads up to 1 en bytes of data from this file into an array of bytes. 

Sets the offset (in bytes specified in pos) from the beginning of the 
stream to where the next read or wri te occurs. 

Sets a new length for this file. 

Skips over n bytes of input. 

Writes b . 1 ength bytes from the specified byte array to this file, 
starting at the current file pointer. 

Writes len bytes from the specified byte array, starting at offset off, 
to this file. 



Figure 1 9.1 6 RandomAccessFi 1 e implements the Datalnput and DataOutput interfaces with additional methods 
to support random access. 



When creating a RandomAccessFile, you can specify one of two modes ("r" or "rw"). 
Mode "r" means that the stream is read-only, and mode "rw" indicates that the stream allows 
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both read and write. For example, the following statement creates a new stream, raf , that 
allows the program to read from and write to the file test.dat: 

RandomAccessFi 1 e raf = new RandomAccessFileCtest.dat", "rw") ; 

If test.dat already exists, raf is created to access it; if test.dat does not exist, a new file 
named test.dat is created, and raf is created to access the new file. The method 
raf . 1 ength () returns the number of bytes in test.dat at any given time. If you append new 
data into the file, raf . 1 ength () increases. 

Hi Tip 

[f the file is not intended to be modified, open it with the "r" mode. This prevents unintentional 
modification of the file. 

A random-access file consists of a sequence of bytes. A special marker called a file pointer is 
positioned at one of these bytes. A read or write operation takes place at the location of the file 
pointer. When a file is opened, the file pointer is set at the beginning of the file. When you 
read or write data to the file, the file pointer moves forward to the next data item. For exam- 
ple, if you read an int value using readlntO, the JVM reads 4 bytes from the file pointer, 
and now the file pointer is 4 bytes ahead of the previous location, as shown in Figure 19.17. 

File pointer 



File- 







byte) 


byte 




byte 


byte 


byte 


byte 


byte 




byte 


byte 


byte 


byte 


byte | 



file pointer 



(a) Before readlntO 
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(b) After readlntO 



Figure 1 9.1 7 After an int value is read, the file pointer is moved 4 bytes ahead. 

For a RandomAccessFile raf, you can use the raf . seek(position) method to move 
the file pointer to a specified position, raf . seek (0) moves it to the beginning of the file, and 
raf .seek(raf. lengthO) moves it to the end of the file. Listing 19.8 demonstrates 
RandomAccessFile. A large case study of using RandomAccessFile to organize an 
address book is given in Supplement VII.B. 

Listing 19.8 TestRandomAccessFile. java 

1 import java. io.*; 

2 

3 public class TestRandomAccessFile { 

4 public static void main(String[] args) throws IOException { 

5 // Create a random-access file 

6 RandomAccessFile inout = new RandomAccessFileCinout.dat", "rw") ; RandomAccessFile 
7 

8 // Clear the file to destroy the old contents, if any 

9 inout. setLength(O) ; empty file 
10 

11 // Write new integers to the file 

12 for (int i =0; i < 200; i++) 

13 inout. writelnt(i) ; write 
14 

15 // Display the current length of the file 

16 System. out. pri ntl n("Current file length is " + inout. lengthO ) ; 
17 
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18 // Retrieve the first number 

move pointer 19 i nout . seek(O) ; // Move the file pointer to the beginning 

read 20 System . out . pri ntl n ("The first number is " + i nout . readlntO ) ; 

21 

22 // Retrieve the second number 

23 inout.seek(l * 4) ; // Move the file pointer to the second number 

24 System. out. println("The second number is " + i nout . readlntO ) ; 
25 

26 // Retrieve the tenth number 

27 inout.seek(9 * 4) ; // Move the file pointer to the tenth number 

28 System. out. println("The tenth number is " + i nout . readlntO ) ; 
29 

30 // Modify the eleventh number 

31 inout.writeInt(555) ; 
32 

33 // Append a new number 

34 inout.seek(inout.lengthO) ; // Move the file pointer to the end 

35 inout.writeInt(999) ; 
36 

37 // Display the new length 

38 System. out. pri ntl n ("The new length is " + inout.lengthO ) ; 

39 

40 // Retrieve the new eleventh number 

41 inout.seek(10 * 4) ; // Move the file pointer to the next number 

42 System. out. println("The eleventh number is " + i nout . readlntO ) ; 
43 

close file 44 i nout . cl ose() ; 

45 } 

46 } 



Current file length is 


800 


The first number is 




The second number is 1 




The tenth number is 9 




The new length is 804 




The eleventh number is 


555 



A RandomAccessFil e is created for the file named inout.dat with mode "rw" to allow both 
read and write operations in line 6. 

inout . setLength(O) sets the length to in line 9. This, in effect, destroys the old con- 
tents of the file. 

The for loop writes 200 int values from to 199 into the file in lines 12-13. Since each 
int value takes 4 bytes, the total length of the file returned from inout.lengthO is now 
800 (line 16), as shown in sample output. 

Invoking inout. seek(0) in line 19 sets the file pointer to the beginning of the file, 
i nout . readlnt () reads the first value in line 20 and moves the file pointer to the next num- 
ber. The second number is read in line 23. 

inout.seek(9 * 4) (line 27) moves the file pointer to the tenth number, inout 
. readlntO reads the tenth number and moves the file pointer to the eleventh number in 
line 28. inout . wri te(555) writes a new eleventh number at the current position (line 31). 
The previous eleventh number is destroyed. 

i nout. seek(i nout. length ()) moves the file pointer to the end of the file (line 34). 
inout .wri telnt (999) writes a 999 to the file. Now the length of the file is increased by 4, 
so inout.lengthO returns 804 (line 38). 

inout . seekCIO * 4) moves the file pointer to the eleventh number in line 41. The new 
eleventh number, 555, is displayed in line 42. 
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Chapter Summary 

1 . I/O can be classified into text I/O and binary I/O. Text I/O interprets data in sequences 
of characters. Binary I/O interprets data as raw binary values. How text is stored in a file 
depends on the encoding scheme for the file. Java automatically performs encoding and 
decoding for text I/O. 

2. The InputStream and OutputStream classes are the roots of all binary I/O classes. 
FilelnputStream/FileOutputStream associates a file for binary input/output. 
BufferedlnputStream/Buf feredOutputStream can be used to wrap on any 
binary I/O stream to improve performance. DatalnputStream/DataOutputStream 

can be used to read/write primitive values and strings. 

3. ObjectlnputStream/ObjectOutputStream can be used to read/write objects in 
addition to primitive values and strings. To enable object serialization, the object's 
defining class must implement the java. io. Serial izable marker interface. 

4. The RandomAccessFil e class enables you to read and write data to a file. You can 
open a file with the "r" mode to indicate that it is read-only, or with the "rw" mode to 
indicate that it is updateable. Since the RandomAccessFil e class implements 
Datalnput and DataOutput interfaces, many methods in RandomAccessFil e are 
the same as those in DatalnputStream and DataOutputStream. 

Review Questions 

Sections 19.1-19.2 

19.1 What is a text file, and what is a binary file? Can you view a text file or a binary 
file using a text editor? 

1 9.2 How do you read or write data in Java? What is a stream? 
Section 19.3 

19.3 What are the differences between text I/O and binary I/O? 

1 9.4 How is a Java character represented in the memory, and how is a character repre- 
sented in a text file? 

1 9.5 If you write string "ABC" to an ASCII text file, what values are stored in the file? 

1 9.6 If you write string "100" to an ASCII text file, what values are stored in the file? 
If you write a numeric byte-type value 100 using binary I/O, what values are 
stored in the file? 

19.7 What is the encoding scheme for representing a character in a Java program? By 
default, what is the encoding scheme for a text file on Windows? 

Section 19.4 

1 9.8 Why do you have to declare to throw IOException in the method or use a try- 
catch block to handle IOException for Java IO programs? 

19.9 Why should you always close streams? 
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InputStream reads bytes. Why does the read() method return an int instead 
of a byte? Find the abstract methods in InputStream and OutputStream. 

Does FilelnputStream/FileOutputStream introduce any new methods? 
How do you create a Fil elnputStream/Fil eOutputStream? 

What will happen if you attempt to create an input stream on a nonexistent file? 
What will happen if you attempt to create an output stream on an existing file? Can 
you append data to an existing file? 

How do you append data to an existing text file using java. io.PrintWriter? 

Suppose a file contains an unspecified number of doubl e values. Theses values 
were written to the file using the writeDouble method using a 
DataOutputStream. How do you write a program to read all these values? How 
do you detect the end of file? 

What is written to a file using writeByte(91) on a Fil eOutputStream? 

How do you check the end of a file in a binary input stream (Fi 1 elnputStream, 
DatalnputStream)? 

What is wrong in the following code? 

import java.io.*; 

public class Test { 

public static void man n(Stri ng [] args) { 
try { 

Fi 1 elnputStream fis = new Fi 1 eInputStream("test ■ dat") ; 

} 

catch (IOException ex) { 
ex . pri ntStackTraceO ; 

} 

catch (FileNotFoundException ex) { 
ex . pri ntStackTraceO ; 

} 

} 

} 

19.18 Suppose you run the program on Windows using the default ASCII encoding. 
After the program is finished, how many bytes are in the file t.txt? Show the con- 
tents of each byte. 

public class Test { 

public static void mai n(Stri ng [] args) 
throws java.io. IOException { 
java. io . Pri ntWriter output = 

new java. i o . Pri ntWri ter("t . txt") ; 
output. pri ntf("%s", "1234") ; 
output. pri ntf("%s", "5678") ; 
output . cl ose() ; 

} 

} 

19.19 After the program is finished, how many bytes are in the file t.dat? Show the con- 
tents of each byte. 

import java.io.*; 

public class Test { 

public static void mai n(Stri ng [] args) throws IOException { 
DataOutputStream output = new DataOutputStream( 
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new FileOutputStreamCt.dat")) ; 
output .wri telnt(1234) ; 
output .wri telnt(5678) ; 
output. close() ; 

} 

} 

19.20 For each of the following statements on a DataOutputStream out, how many 
bytes are sent to the output? 

output. writeChar('A') ; 
output. writeCharsC'BC") ; 
output. wn'teUTFC'DEF") ; 

1 9.2 I What are the advantages of using buffered streams? Are the following statements 
correct? 

Buff eredlnputStream inputl = 

new Buff eredlnputStream (new FileInputStreamCt.dat")); 

DatalnputStream input2 = new DataInputStream( 

new Buff eredlnputStream (new FileInputStreamCt.dat"))); 

ObjectlnputStream input3 = new ObjectInputStream( 

new Buff eredInputStream(new FileInputStreamCt.dat"))) I 

Section 19.6 

19.22 What types of objects can be stored using the ObjectOutputStream? What is 
the method for writing an object? What is the method for reading an object? What 
is the return type of the method that reads an object from ObjectlnputStream? 

1 9.23 If you serialize two objects of the same type, will they take the same amount of 
space? If not, give an example. 

1 9.24 Is it true that any instance of java . no . Serial i zabl e can be successfully seri- 
alized? Are the static variables in an object serialized? How do you mark an 
instance variable not to be serialized? 

1 9.25 Can you write an array to an ObjectOutputStream? 

19.26 Is it true that DatalnputStream/DataOutputStream can always be replaced 
by ObjectlnputStream/ObjectOutputStream? 

1 9.27 What will happen when you attempt to run the following code? 

import java. io.*; 

public class Test { 

public static void man n(Stri ng [] args) throws IOException { 
ObjectOutputStream output = 

new ObjectOutputStream(new FileOutputStreamCobject.dat")); 

output .wri teObject(new A()); 

} 

} 

class A implements Serializable { 
B b = new B() ; 

} 



class B { 

} 
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Section 19.7 

19.28 Can RandomAccessFile streams read and write a data file created by 
DataOutputStream? Can RandomAccessFile streams read and write objects? 

1 9.29 Create a RandomAccessFil e stream for the file address.dat to allow the updat- 
ing of student information in the file. Create a DataOutputStream for the file 
address.dat. Explain the differences between these two statements. 

1 9.30 What happens if the file test.dat does not exist when you attempt to compile and 
run the following code? 

import java.io.*; 

public class Test { 

public static void man n(Stri ng [] args) { 
try { 

RandomAccessFile raf = 

new RandomAccessFileCtest.dat", "r") ; 
int i = raf . readlntC) ; 

} 

catch (IOException ex) { 

System . out . pri ntl n("I0 exception") ; 

} 

} 

} 

Programming Exercises 

Section 19.3 

19.1* (Creating a text file) Write a program to create a file named Exercisel9_l.txt if it 
does not exist. Append new data to it. Write 100 integers created randomly into the 
file using text I/O. Integers are separated by a space. 

Section 19.4 

19.2* (Creating a binary data file) Write a program to create a file named 
Exercisel9_2.dat if it does not exist. Append new data to it. Write 100 integers 
created randomly into the file using binary I/O. 

19.3* (Summing all the integers in a binary data file) Suppose a binary data file named 
Exercisel9_3.dat has been created using writelnt(int) in DataOutput- 
Stream. The file contains an unspecified number of integers. Write a program to 
find the sum of integers. 

1 9.4* (Converting a text file into UTF) Write a program that reads lines of characters from 
a text and writes each line as a UTF-8 string into a binary file. Display the sizes of 
the text file and the binary file. Use the following command to run the program: 

java Exercisel9 4 Wei come . j ava Wei come. utf 
Section 19.6 

1 9.5* (Storing objects and arrays into a file) Write a program that stores an array of five 
i nt values 1, 2, 3, 4 and 5, a Date object for current time, and a doubl e value 5 . 5 
into the file named Exercisel9_5.dat. 
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19.6* (Storing Loan objects) The Loan class, in Listing 10.2, does not implement 
Serial izable. Rewrite the Loan class to implement Serial izabl e. Write a 
program that creates five Loan objects and stores them in a file named 
Exercisel9_6.dat. 

19.7* (Restoring objects from a file) Suppose a file named Exercisel9_7.dat has 
been created using the ObjectOutputStream. The file contains Loan 
objects. The Loan class, in Listing 10.2, does not implement Serial izable. 
Rewrite the Loan class to implement Serial izable. Write a program that 
reads the Loan objects from the file and computes the total loan amount. Sup- 
pose you don't know how many Loan objects are in the file. Use 
EOFException to end the loop. 

Section 19.7 

19.8* (Updating count) Suppose you want to track how many times a program has 
been executed. You may store an int to count the file. Increase the count by 1 
each time this program is executed. Let the program be Exercisel9_8 and store 
the count in Exercisel9_8.dat. 

1 9.9*** (Address book) Supplement VII. B gives a case study of using random-access 
files for creating and manipulating an address book. Modify the case study by 
adding an Update button, as shown in Figure 19.18, to enable the user to modify 
the address that is being displayed. 



Name [jijliii Sinilh 



Street " CO 1.1 a n -itsit 



C»y |S attain nail 



Jstale|GA ;Zjl| 31419 



Update 



Figure 19.18 The application can store, retrieve, and update addresses from a file. 
Comprehensive 

19.10* (Splitting fdes) Suppose you wish to back up a huge file (e.g., a 10-GB AVI file) 
to a CD-R. You can achieve it by splitting the file into smaller pieces and back- 
ing up these pieces separately. Write a utility program that splits a large file into 
smaller ones using the following command: 

java Exerci sel9_10 SourceFile numberOf Pi eces 

The command creates files SourceFile. 1, SourceFile. 2, SourceFile. n, 

where n is numberOf Pi eces and the output files are about the same size. 

19.1 I** (Splitting fdes GUI) Rewrite Exercise 19.10 with a GUI, as shown in Figure 
19.19(a). 



13 Exerciseig 11: Split a File 




_|n|x| 


If you split a file named temp.txt into 3 smallerfiles. the 
three smallerfiles are temp.M.1 , temp.M.2, and temp.M.3. 


Enter or choose a file: 


temp.txt 


Browse 


Specify the number of smaller files: 


3 


Start 



Exerciseig 13: Combine Files 



If the base file is named temp.txt with three pieces, temp.txt.1 , 
temp.txt. 2 : and temp.txt. 3 are combined into temp.M. 



Enter a base file: 



temp.M 



(a) 



Specify the number of smallerfiles: 



(b) 



Video Note 

Split a large file 



Figure 19.19 (a) The program splits a file, (b) The program combines files into a new file. 
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19.12* (Combining files) Write a utility program that combines the files together into a 
new file using the following command: 

java Exercisel9_12 SourceFilel . . . SoureFilen TargetFile 

The command combines SourceFilel, . . . , and SourceFilen into TargetFile. 

1 9.1 3* (Combining files GUI) Rewrite Exercise 19.12 with a GUI, as shown in Figure 
19.19(b). 

1 9.14 (Encrypting files) Encode the file by adding 5 to every byte in the file. Write a 
program that prompts the user to enter an input file name and an output file 
name and saves the encrypted version of the input file to the output file. 

19.15 (Decrypting files) Suppose a file is encrypted using the scheme in Exercise 
19.14. Write a program to decode an encrypted file. Your program should 
prompt the user to enter an input file name and an output file name and should 
save the unencrypted version of the input file to the output file. 

1 9.1 6 (Frequency of characters) Write a program that prompts the user to enter the 
name of an ASCII text file and display the frequency of the characters in the file. 

1 9.1 7** (BitOutputStream) Implement a class named Bi tOutputStream, as shown 
in Figure 19.20, for writing bits to an output stream. The wri teBi t (char 
bit) method stores the bit in a byte variable. When you create a 
BitOutputStream, the byte is empty. After invoking wri teBi t( ' 1 ' ), the 
byte becomes 00000001. After invoking wri teBi t ("0101"), the byte 
becomes 00010101. The first three bits are not filled yet. When a byte is full, it 
is sent to the output stream. Now the byte is reset to empty. You must close the 
stream by invoking the close () method. If the byte is not empty and not full, 
the close () method first fills the zeros to make a full 8 bits in the byte, and 
then output the byte and close the stream. For a hint, see Exercise 4.46. Write a 
test program that sends the bits 010000100100001001101 to the file named 
Exercisel9_17.dat. 



BitOutputStream 


+Bi t0utputStream(f i 1 e 


File) 


+writeBit(char bit): void 


+writeBit(String bit) 


voi d 


+close(): void 





Creates a BitOutputStream to write bit to the file. 

Write a bit '0' or T to the output stream. 

Write a string of bits to the output stream. 

This method must be invoked to close the stream. 



Figure 19.20 BitOutputStream outputs a stream of bits to a file. 



1 9.1 8* (View bits) Write the following method that displays the bit representation for 
the last byte in an integer: 

public static String getBits(int value) 

For a hint, see Exercise 4.46. Write a program that prompts the user to enter a 
file name, reads bytes from a file, and displays each byte's binary 
representation. 

19.19* (View hex) Write a program that prompts the user to enter a file name, reads 
bytes from a file, and displays each byte's hex representation. (Hint: You may 
first convert the byte value into an 8-bit string, then convert the bit string into a 
two-digit hex string.) 
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1 9.20** (Binary Editor) Write a GUI application that lets the user enter a file name in the 
text field and press the Enter key to display its binary representation in a text 
area. The user can also modify the binary code and save it back to the file, as 
shown in Figure 19.21(a). 



'9 Exercisel9_20 T [ 


X 




M Exerciser 21 j ! 


X 


Eirter a file| c :\We 1 c o m e j ava 


Enter atile|c :WJe I come jaral 


D1 1 01 001 01 1 01 1 D1 01 1 1 000001 1 01 1 1 1 01 1 1 001 
01 1 101 00001 0000001 1 01 01 001 1 00001 01 1 1 01 1 c 
011 00001011 11 000001 011 1001 11 0011 01110111 
011 01 001011 01 11 001 1001 11 001011 1 001 001 01 
010011110111 000001 110100011 01 001 01101111 
011 01 11 001 01 000001 1 00001 01 1011 1 001 1 001 01 

nrn 1 1 rn 1 nnom 1 m onorn 01 000001 1 01 norirn 01 n 






696D706F7274206A61 7661 782E7377696E672E 
4A4F7074696F6E5061 6E65360D0A0D0A707562 
6C696320636C6173732057656C636F6D65207 
B0D0A20207075626C696320737461 746963207 
66F6964206D61696E28537472696E675B5D206 
172677329207B0D0A202020204A4F7074696F6 




Save the hits to the file 






Save the hits to the file 


(a) 


(b) 



Figure 1 9.2 1 The exercises enable the user to manipulate the contents of the file in binary and hex. 

1 9.2 I ** (Hex Editor) Write a GUI application that lets the user enter a file name in the 
text field and press the Enter key to display its hex representation in a text area. 
The user can also modify the hex code and save it back to the file, as shown in 
Figure 19.21(b). 
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Recursion 

Objectives 

■ To describe what a recursive method is and the benefits of using recursion (§20.1) 

■ To develop recursive methods for recursive mathematical functions (§§20.2-20.3) 

■ To explain how recursive method calls are handled in a call stack (§§20.2-20.3). 

■ To use an overloaded helper method to derive a recursive method (§20.5). 

■ To solve selection sort using recursion (§20.5.1). 

■ To solve binary search using recursion (§20.5.2). 

■ To get the directory size using recursion (§20.6). 

■ To solve the Towers of Hanoi problem using 
recursion (§20.7). 

■ To draw fractals using recursion (§20.8). 

■ To solve the Eight Queens problem using recursion (§20.9). 

■ To discover the relationship and difference between 
recursion and iteration (§20.10). 

■ To know tail-recursive methods and why they 
are desirable (§20.11). 
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20.1 Introduction 

search word problem Suppose you want to find all the files under a directory that contain a particular word. How do 

you solve this problem? There are several ways to do so. An intuitive and effective solution is 
to use recursion by searching the files in the subdirectories recursively. 

Eight Queens problem The classic Eight Queens puzzle is to place eight queens on a chessboard such that no two 

can attack each other (i.e., no two queens are on the same row, same column, or same diago- 
nal), as shown in Figure 20.1. How do you write a program to solve this problem? A good 
approach is to use recursion. 
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Figure 20.1 The Eight Queens problem can be solved using recursion. 



recursive method To use recursion is to program using recursive methods — methods that directly or indi- 

rectly invoke themselves. Recursion is a useful programming technique. In some cases, it 
enables you to develop a natural, straightforward, simple solution to an otherwise difficult 
problem. This chapter introduces the concepts and techniques of recursive programming and 
illustrates by examples how to "think recursively." 



20.2 Problem: Computing Factorials 

Many mathematical functions are defined using recursion. We begin with a simple example. 
The factorial of a number n can be recursively defined as follows: 

0! = 1; 

n! = n x (n - 1) x ... x2xl=nx(n-l)!; n>0 

How do you find n ! for a given n? To find 1 ! is easy, because you know that ! is 1, and 1 ! 
is 1 x ! . Assuming that you know (n - 1) ! , you can obtain n ! immediately using nx (n - 
1) ! . Thus, the problem of computing n ! is reduced to computing (n - 1) ! . When comput- 
ing (n - 1) ! , you can apply the same idea recursively until n is reduced to 0. 

Let factorial (n) be the method for computing n ! . If you call the method with n = 0, it 
immediately returns the result. The method knows how to solve the simplest case, which is 
base case or stopping referred to as the base case or the stopping condition. If you call the method with n > 0, it 

condition reduces the problem into a subproblem for computing the factorial of n - 1. The subproblem is 

essentially the same as the original problem, but is simpler or smaller. Because the subproblem 
has the same property as the original, you can call the method with a different argument, which 
recursive call is referred to as a recursive call. 

The recursive algorithm for computing f actori al (n) can be simply described as follows: 

if (n == 0) 
return 1; 
el se 

return n * factorial (n - 1); 

A recursive call can result in many more recursive calls, because the method keeps on divid- 
ing a subproblem into new subproblems. For a recursive method to terminate, the problem 
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must eventually be reduced to a stopping case, at which point the method returns a result to its 
caller. The caller then performs a computation and returns the result to its own caller. This 
process continues until the result is passed back to the original caller. The original problem 
can now be solved by multiplying n by the result of factorial (n - 1). 

Listing 20. 1 gives a complete program that prompts the user to enter a nonnegative integer 
and displays the factorial for the number. 

Listing 20.1 ComputeFactorial .java 

1 import java. util .Scanner; 

2 

3 public class ComputeFactorial { 

4 /** Main method */ 

5 public static void main(String[] args) { 

6 // Create a Scanner 

7 Scanner input = new Scanner(System . i n) ; 

8 System . out . pri nt("Enter a nonnegative integer: ") ; 

9 int n = i nput . nextlntO ; 
10 

11 // Display factorial 

12 System. out. println("Factorial of " + n + " is " + factori al (n) ) ; 

13 } 
14 

15 /** Return the factorial for a specified number */ 

16 public static long factorial (int n) { 

17 if (n == 0) // Base case base case 

18 return 1; 

19 el se 

20 return n * factorial (n -1); // Recursive call recursion 

21 } 

22 } 



Enter a nonnegative integer: 
Factorial of 4 is 24 



Enter a nonnegative integer: 
Factorial of 10 is 3628800 



The factorial method (lines 16-21) is essentially a direct translation of the recursive math- 
ematical definition for the factorial into Java code. The call to factorial is recursive 
because it calls itself. The parameter passed to factorial is decremented until it reaches the 
base case of 0. 

Figure 20.2 illustrates the execution of the recursive calls, starting with n = 4. The use of 
stack space for recursive calls is shown in Figure 20.3. 

ig|l Caution 

[f recursion does not reduce the problem in a manner that allows it to eventually converge into 

the base case, infinite recursion can occur. For example, suppose you mistakenly write the infinite recursion 

factorial method as follows: 

public static long factori al (int n) { 
return n * factori al (n - 1); 

} 

The method runs infinitely and causes a StackOverflowError. 
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factorial (4) 

Step 0: executes factorial (4) 



Step 9: return 24 



Step 8: return 6 



return 4 * factorial (3) 

Step 1: executes factorial (3) 



Step 7: return 2 



return 3 * factorial (2) 

Step 2: executes f actori al (2) 



Step 6: return 1 



return 2 * factorial (1) 

Step 3: executes factorial (1) 



Step 5: return 1 



return 1 * factorial (0) 

Step 4: executes f acto ri al (0) 



return 1 

Figure 20.2 Invoking factorial (4) spawns recursive calls to factorial . 
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Figure 20.3 When factorial (4) is being executed, the factorial method is called recursively, causing stack space 
to dynamically change. 
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|j§t Pedagogical Note 

It is simpler and more efficient to implement the factorial method using a loop. However, we 
use the recursive factorial method here to demonstrate the concept of recursion. Later in this 
chapter, we will present some problems that are inherently recursive and are difficult to solve 
without using recursion. 

20.3 Problem: Computing Fibonacci Numbers 

The factorial method in the preceding section could easily be rewritten without using 
recursion. In some cases, however, using recursion enables you to give a natural, straightfor- 
ward, simple solution to a program that would otherwise be difficult to solve. Consider the 
well-known Fibonacci-series problem: 

The series: 1 1 2 3 5 8 13 21 34 55 89 ... 
indices: 0123456 7 8 9 10 11 

The Fibonacci series begins with and 1, and each subsequent number is the sum of the pre- 
ceding two. The series can be recursively defined as follows: 

fib(0) = 0; 
fib(l) = 1; 

fib(index) = fib(index - 2) + fib(index - 1); index >= 2 

The Fibonacci series was named for Leonardo Fibonacci, a medieval mathematician, who 
originated it to model the growth of the rabbit population. It can be applied in numeric opti- 
mization and in various other areas. 

How do you find fib(index) for a given index? It is easy to find fib(2), because you 
know fib(0) and fib(l). Assuming that you know fib(index - 2) and fib(index - 1), 
you can obtain fib(index) immediately. Thus, the problem of computing fib(index) is 
reduced to computing fib(index - 2) and fib(index - 1). When doing so, you apply the 
idea recursively until i ndex is reduced to or 1. 

The base case is i ndex = or i ndex = 1. If you call the method with i ndex = or i ndex 
= 1, it immediately returns the result. If you call the method with index >= 2, it divides the 
problem into two subproblems for computing fib(index - 1) and fib(index - 2) using 
recursive calls. The recursive algorithm for computing fib (index) can be simply described 
as follows: 

if (index == 0) 

return 0; 
else if (index == 1) 

return 1; 
el se 

return fib(index - 1) + fib(index - 2); 

Listing 20.2 gives a complete program that prompts the user to enter an index and computes 
the Fibonacci number for the index. 

Listing 20.2 ComputeFi bonacci .java 

1 import java. util .Scanner; 
2 

3 public class ComputeFi bonacci { 

4 /** Main method */ 

5 public static void main(String args[]) { 

6 // Create a Scanner 

7 Scanner input = new Scanner(System . i n) ; 

8 System . out . pri nt("Enter an index for the Fibonacci number: ") ; 
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base case 
base case 

recursion 



9 
10 
11 
12 
13 
14 
15 
16 
17 
18 
19 
20 
21 
22 
23 
24 

25 } 



int index = i nput . nextlnt () ; 

// Find and display the Fibonacci number 
System . out . pri ntl n ( 

"Fibonacci number at index " + index + " is " + fib(index)); 



} 



/** The method for finding the Fibonacci number */ 
public static long fib(long index) { 
if (index == 0) // Base case 

return 0; 
else if (index == 1) // Base case 
return 1; 

else // Reduction and recursive calls 
return fib(index - 1) + fib(index - 2); 

} 



Enter an index for the Fibonacci number: 
Fibonacci number at index 1 is 1 


1 




Enter an index for the Fibonacci number: 
Fibonacci number at index 6 is 8 


fj - 1 Enter 




Enter an index for the Fibonacci number: 
Fibonacci number at index 7 is 13 


7 1^ Enter 



The program does not show the considerable amount of work done behind the scenes by the 
computer. Figure 20.4, however, shows successive recursive calls for evaluating f i b (4) . The 
original method, fib(4), makes two recursive calls, fib(3) and fib(2), and then returns 
f ib(3) + f ib(2). But in what order are these methods called? In Java, operands are evalu- 
ated from left to right. fib(2) is called after fib(3) is completely evaluated. The labels in 
Figure 20.4 show the order in which methods are called. 



17: return fib(4)__ 
10: return fib(3) 



fib(4) 

| 0: call fib (4) 



11: call fib (2) 



return fib(l) + fib(0) 

14: return fib(0) 




return 1 IeLUIn 1 1 u W ""-—return 

Figure 20.4 Invoking fib(4) spawns recursive calls to fib. 
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As shown in Figure 20.4, there are many duplicated recursive calls. For instance, f ib(2) 
is called twice, fib(l) three times, and fib(0) twice. In general, computing fib(index) 
requires roughly twice as many recursive calls as does computing fib ("index - 1). As you 
try larger index values, the number of calls substantially increases. 

Besides the large number of recursive calls, the computer requires more time and space to 
run recursive methods. 



Pedagogical Note 

The recursive implementation of the f i b method is very simple and straightforward, but not effi- 
cient. See Exercise 20.2 for an efficient solution using loops. Though it is not practical, the recur- 
sive fib method is a good example of how to write recursive methods. 



20.4 Problem Solving Using Recursion 



The preceding sections presented two classic recursion examples. All recursive methods have recursion characteristics 
the following characteristics: 

■ The method is implemented using an i f -el se or a swi tch statement that leads to if-else 
different cases. 



One or more base cases (the simplest case) are used to stop recursion. 



base cases 



■ Every recursive call reduces the original problem, bringing it increasingly closer to a reduction 
base case until it becomes that case. 

In general, to solve a problem using recursion, you break it into subproblems. Each subprob- 
lem is almost the same as the original problem but smaller in size. You can apply the same 
approach to each subproblem to solve it recursively. 

Let us consider the simple problem of printing a message n times. You can break the problem 
into two subproblems: one is to print the message one time and the other is to print it n - 1 times. 
The second problem is the same as the original problem but smaller in size. The base case for the 
problem is n == 0. You can solve this problem using recursion as follows: 

public static void nPri ntl n(String message, int times) { 
if (times >= 1) { 

System . out . pri ntl n(message) ; 

nPri ntl n (message , times - 1); recursive call 

} // The base case is times == 

} 



Note that the fib method in the preceding example returns a value to its caller, but the 
nPrintl n method is void and does not. 

If you think recursively, you can use recursion to solve many of the problems presented in think recursively 
earlier chapters of this book. Consider the palindrome problem in Listing 9.1. Recall that a 
string is a palindrome if it reads the same from the left and from the right. For example, mom 
and dad are palindromes, but uncle and aunt are not. The problem of checking whether a 
string is a palindrome can be divided into two subproblems: 

■ Check whether the first character and the last character of the string are equal. 

■ Ignore the two end characters and check whether the rest of the substring is a 
palindrome. 

The second subproblem is the same as the original problem but smaller in size. There are two 
base cases: (1) the two end characters are not same; (2) the string size is or 1. In case 1, the 
string is not a palindrome; and in case 2, the string is a palindrome. The recursive method for 
this problem can be implemented as shown in Listing 20.3. 
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Listing 20.3 Recursi vePal i ndromeUsi ngSubstri ng . java 



method header 
base case 

base case 



recursive call 



1)) // Base case 



1 public class RecursivePalindromeUsingSubstring { 

2 public static boolean i sPal i ndrome(Stri ng s) { 

3 if (s.lengthO <= 1) // Base case 

4 return true; 

5 else if (s.charAt(O) != s . charAt(s . 1 engthO 

6 return false; 

7 el se 

8 return i sPal i ndrome(s . substri ng(l , s.lengthO - 1)) 

9 } 
10 

11 public static void main(String[] args) { 

12 System. out. println("Is moon a palindrome? " 

13 + is Palindrome ("moon")) ; 

14 System. out. println("Is noon a palindrome? " 

15 + i sPal i ndrome("noon")) ; 

16 System. out. println("Is a a palindrome? " + 

17 System. out. print"! n ("Is aba a palindrome? 

18 isPalindrome("aba")) ; 

19 System. out. println("Is ab a palindrome? " + i sPal i ndrome("ab")) : 

20 } 

21 } 



isPalindrome("a")) ; 
+ 



Is moon a palindrome? false 

Is noon a palindrome? true 

Is a a palindrome? true 

Is aba a palindrome? true 

Is ab a palindrome? false 



The substring method in line 8 creates a new string that is the same as the original string 
except without the first and last characters. Checking whether a string is a palindrome is 
equivalent to checking whether the substring is a palindrome if the two end characters in the 
original string are the same. 

20.5 Recursive Helper Methods 

The preceding recursive isPal indrome method is not efficient, because it creates a new 
string for every recursive call. To avoid creating new strings, you can use the low and high 
indices to indicate the range of the substring. These two indices must be passed to the recur- 
sive method. Since the original method is isPal indrome(String s), you have to create a 
new method isPal indrome(String s, int low, int high) to accept additional infor- 
mation on the string, as shown in Listing 20.4. 

Listing 20.4 Recursi vePal indrome. java 

1 public class Recursi vePal indrome { 

2 public static boolean i sPal i ndrome(Stri ng s) { 

3 return isPalindrome(s, 0, s.lengthO - 1); 

4 } 
5 

helpermethod 6 public static boolean i sPal i ndrome(Stri ng s, int low, int high) { 

base case 7 if (high <= low) // Base case 

8 return true; 

base case 9 else if (s . charAt(l ow) != s.charAt(high)) // Base case 

10 return false; 
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11 el se 

12 return i sPal i ndrome(s , low + 1, high - 1); 

13 } 
14 

15 public static void mai n (Stri ng [] args) { 

16 System. out. println("Is moon a palindrome? " 

17 + i s Palindrome ("moon") ) ; 

18 System. out. println("Is noon a palindrome? " 

19 + isPalindrome("noon")) ; 

20 System. out. println("Is a a palindrome? " + i sPal i ndrome("a")) ; 

21 System. out. println("Is aba a palindrome? " + i sPal i ndrome("aba")) ; 

22 System. out. println("Is ab a palindrome? " + i sPal i ndrome("ab")) ; 

23 } 



24 } 

Two overloaded i sPal i ndrome methods are defined. The first, i sPal i ndrome(Stri ng s) , 
checks whether a string is a palindrome, and the second, i sPal i ndrome(Stri ng s , i nt 1 ow , 
int high), checks whether a substring s(low. .high) is a palindrome. The first method 
passes the string s with low = and high = s.lengthC) - 1 to the second method. The 
second method can be invoked recursively to check a palindrome in an ever-shrinking sub- 
string. It is a common design technique in recursive programming to define a second method 

that receives additional parameters. Such a method is known as a recursive helper method. recursive helper method 

Helper methods are very useful in designing recursive solutions for problems involving 
strings and arrays. The sections that follow give two more examples. 

20.5.1 Selection Sort 

Selection sort was introduced in §6.10.1, "Selection Sort." Recall that it finds the smallest 
number in the list and places it first. It then finds the smallest number remaining and places it 
after the first, and so on until the remaining list contains only a single number. The problem 
can be divided into two subproblems: 

■ Find the smallest number in the list and swap it with the first number. 

■ Ignore the first number and sort the remaining smaller list recursively. 

The base case is that the list contains only one number. Listing 20.5 gives the recursive sort 
method. 

Listing 20.5 Recursi veSelectionSort . java 

1 public class RecursiveSelectionSort { 



2 public static void sort(double[] list) { 

3 sort(list, 0, list. length -1); // Sort the entire list 

4 } 
5 

6 public static void sort(double[] list, int low, int high) { 

7 if (low < high) { helper method 

8 // Find the smallest number and its index in list(low .. high) basecase 

9 int indexOfMin = low; 

10 double min = list [low]; 

11 for (int i = low + 1; i <= high; i++) { 

12 if (list[i] < min) { 

13 min = list[i] ; 

14 i ndexOf Mi n = i ; 

15 } 

16 } 
17 

18 // Swap the smallest in list(low .. high) with list(low) 
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19 ~list[indexOfMin] = list [low]; 

20 list[low] = min; 
21 

22 // Sort the remaining list(low+l .. high) 

23 sort(list, low + 1, high); 
recursive call 24 } 

25 } 

26 } 



Two overloaded sort methods are defined. The first method, sort (doubl e [] 1 i st) , sorts 
an array in list[0. .list, length - 1] and the second method sort (doubl e[] list, 
int low, int high) sorts an array in list[low. .high]. The second method can be 
invoked recursively to sort an ever-shrinking subarray. 



Video Note 

Binary search 



helper method 
base case 



recursive call 
base case 
recursive call 



20.5.2 Binary Search 

Binary search was introduced in §6.9.2. For binary search to work, the elements in the array 
must already be ordered. The binary search first compares the key with the element in the 
middle of the array. Consider the following three cases: 

■ Case 1 : If the key is less than the middle element, recursively search the key in the 
first half of the array. 

■ Case 2: If the key is equal to the middle element, the search ends with a match. 

■ Case 3: If the key is greater than the middle element, recursively search the key in 
the second half of the array. 

Case 1 and Case 3 reduce the search to a smaller list. Case 2 is a base case when there is a 
match. Another base case is that the search is exhausted without a match. Listing 20.6 gives a 
clear, simple solution for the binary search problem using recursion. 

Listing 20.6 Recursive Binary Search Method 



1 public class Recursi veBi narySearch { 

2 public static int recursiveBinarySearch(int[] list, int key) { 
int low = 0; 

int high = list. length - 1; 

return recursiveBinarySearch(list, key, low, high); 

} 



3 

4 

5 

6 

7 

8 

9 
10 
11 
12 
13 
14 
15 
16 
17 
18 
19 
20 

21 } 



public static int recursiveBinarySearch(int[] list, int key, 
int low, int high) { 
if (low > high) // The list has been exhausted without a match 
return -low - 1; 

int mid = (low + high) / 2; 
if (key < list [mid]) 

return recursiveBinarySearch(list, key, low, mid - 1); 
else if (key == list [mid]) 

return mid; 
el se 

return recursiveBinarySearch(list, key, mid + 1, high); 



The first method finds a key in the whole list. The second method finds a key in the list with 
index from low to high. 
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The first binarySearch method passes the initial array with low = and high = 
list. length - 1 to the second binarySearch method. The second method is invoked 
recursively to find the key in an ever- shrinking subarray. 

20.6 Problem: Finding the Directory Size 

The preceding examples can easily be solved without using recursion. This section presents a 
problem that is difficult to solve without using recursion. The problem is to find the size of a 
directory. The size of a directory is the sum of the sizes of all files in the directory. A directory 
d may contain subdirectories. Suppose a directory contains files f\, fi, . . . , f m and subdirecto- 
ries d\, d^- ■ ■ , d n , as shown in Figure 20.5. 



Video Note 

Directory size 



directory 



L 



dn 



Figure 20.5 A directory contains files and subdirectories. 

The size of the directory can be defined recursively as follows: 

size(d) = size(fi) + size(f2) + ■■■+ size(f m ) + size(d\) + s!ze(d 2 ) + ...+ size(d n ) 

The Fil e class, introduced in §9.6, can be used to represent a file or a directory and obtain 
the properties for files and directories. Two methods in the File class are useful for this 
problem: 

■ The 1 ength() method returns the size of a file. 

■ The listFilesO method returns an array of Fi 1 e objects under a directory. 
Listing 20.7 gives a program that prompts the user to enter a directory or a file and displays its 



Listing 20.7 Di rectorySize. java 



i 

2 
3 
4 
5 
6 
7 
8 
9 
10 
11 
12 
13 
14 
15 
16 
17 
18 



import java. no . Fi 1 e ; 
import java. util .Scanner; 

public class Di rectorySi ze { 

public static void main(String[] args) { 

// Prompt the user to enter a directory or a file 
System . out . pri nt("Enter a directory or a file: ") ; 
Scanner input = new Scanner(System. i n) ; 
String directory = i nput . nextLi ne() ; 

// Display the size 

System. out. println(getSize(new File(di rectory)) + " bytes")- 

} 

public static long getSize(File file) { 

long size = 0; // Store the total size of all files 

if (f i le . i sDi rectoryO ) { 



invoke method 
getSize method 
is directory? 
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allsubitems 19 File[] files = f i 1 e . 1 i stFi 1 es () ; // All files and subdirectories 

20 for (int i =0; i < f i 1 es . 1 ength ; i++) { 

recursive call 21 size += getSi ze(f i 1 es [i ] ) ; // Recursive call 

22 } 

23 } 

base case 24 else { // Base case 

2 5 size += file.lengthO ; 

26 } 

27 

28 return size; 

29 } 

30 } 




Enter a directory or a file: c:\book j e«« 
48619631 bytes 




Enter a directory or a file: c:\book\Welcome.java |^ enter 
172 bytes 









Enter a directory or a file: c:\book\NonExistentFile 


pEnteT^ 




bytes 





If the file object represents a directory (line 18), each subitem (file or subdirectory) in the 
directory is recursively invoked to obtain its size (line 21). If the f il e object represents a file 
(line 24), the file size is obtained (line 25). 

What happens if an incorrect or a nonexistent directory is entered? The program will detect 
that it is not a directory and invoke file.lengthO (line 25), which returns 0. So, in this 
case, the getSize method will return 0. 

* Tip 

testing base cases To avoid mistakes, it is a good practice to test base cases. For example, you should test the pro- 

gram for an input of file, an empty directory, a nonexistent directory, and a nonexistent file. 

20.7 Problem: Towers of Hanoi 

The Towers of Hanoi problem is a classic problem that can be solved easily using recursion 
but is difficult to solve otherwise. 

The problem involves moving a specified number of disks of distinct sizes from one tower 
to another while observing the following rules: 

■ There are n disks labeled 1, 2, 3, . . . , n and three towers labeled A, B, and C. 

■ No disk can be on top of a smaller disk at any time. 

■ All the disks are initially placed on tower A. 

■ Only one disk can be moved at a time, and it must be the top disk on a tower. 

The objective of the problem is to move all the disks from A to B with the assistance of C. For 
example, if you have three disks, the steps to move all of the disks from A to B are shown in 
Figure 20.6. 
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Figure 20.6 The goal of the Towers of Hanoi problem is to move disks from tower A to 
tower B without breaking the rules. 

HI Note 

The Towers of Hanoi is a classic computer-science problem, to which many Websites are devoted. 
One of them worth looking at is www.cut-the-knot.com/recurrence/hanoi.html. 

In the case of three disks, you can find the solution manually. For a larger number of disks, 
however — even for four — the problem is quite complex. Fortunately, the problem has an 
inherently recursive nature, which leads to a straightforward recursive solution. 

The base case for the problem is n = 1. If n == 1, you could simply move the disk from A 
to B. When n > 1, you could split the original problem into three subproblems and solve them 
sequentially. 

1. Move the first n - 1 disks from A to C with the assistance of tower B, as shown in Step 
1 in Figure 20.7. 

2. Move disk n from A to B, as shown in Step 2 in Figure 20.7. 

3. Move n - 1 disks from C to B with the assistance of tower A, as shown in Step 3 in 
Figure 20.7. 

The following method moves n disks from the f romTower to the toTower with the assis- 
tance of the auxTower: 

void moveDi sks(int n, char fromTower, char toTower, char auxTower) 

The algorithm for the method can be described as follows: 

if (n == 1) // Stopping condition 

Move disk 1 from the fromTower to the toTower; 
else { 
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Figure 20.7 The Towers of Hanoi problem can be decomposed into three subproblems. 



moveDi sks(n - 1, f romTower , auxTower, toTower) ; 
Move disk n from the f romTower to the toTower; 
moveDisks(n - 1, auxTower, toTower, f romTower) ; 

} 

Listing 20.8 gives a program that prompts the user to enter the number of disks and invokes 
the recursive method moveDi sks to display the solution for moving the disks. 

Listing 20.8 Tower sOf Hanoi . java 

1 import java. util .Scanner; 

2 

3 public class TowersOf Hanoi { 

4 /** Main method */ 

5 public static void main(String[] args) { 

6 // Create a Scanner 

7 Scanner input = new Scanner(System . i n) ; 

8 System . out . pri nt("Enter number of disks: ") ; 

9 int n = i nput . nextlntO ; 
10 

11 // Find the solution recursively 

12 System. out. pri ntln ("The moves are:"); 

13 moveDisks(n, 'A', 'B', 'C'); 

14 } 
15 

16 /** The method for finding the solution to move n disks 

17 from f romTower to toTower with auxTower */ 
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18 public static void moveDi sks(int n, char fromTower, 

19 char toTower, char auxTower) { 

20 if (n == 1) // Stopping condition base case 

21 System. out. println ("Move disk " + n + " from " + 

22 fromTower + " to " + toTower); 

23 else { 

24 moveDisks(n - 1, fromTower, auxTower, toTower); recursion 
2 5 System. out. println ("Move disk " + n + " from " + 

26 fromTower + " to " + toTower); 

27 moveDi sks(n - 1, auxTower, toTower, fromTower) ; recursion 

28 } 

29 } 



30 } 
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This problem is inherently recursive. Using recursion makes it possible to find a natural, sim- 
ple solution. It would be difficult to solve the problem without using recursion. 

Consider tracing the program for n = 3. The successive recursive calls are shown in 
Figure 20.8. As you can see, writing the program is easier than tracing the recursive calls. 
The system uses stacks to trace the calls behind the scenes. To some extent, recursion pro- 
vides a level of abstraction that hides iterations and other details from the user. 



moveDisksd, 'A' , 'B' , 'C') 



moveDisks(2, 'A' , 'C ' , ' B ' ) 
move disk 3 from A to B 
moveDisks(2, 'C , 'B' , 'A') 



moveDisks(2, 'A' , 'C , 'B') 



moveDisksd, 'A' , 'B' , 'C') 
move disk 2 from A to C 
moveDisksd, 'B','C','A') 



moveDisksd, 'A' , 'B' , 'C') 



move disk 1 from A to B 



moveDisksd, 'B' , 'C , 'A') 



move disk 1 from B to C 



moveDisksd, 'C , 'B' , 'A') 



moveDisksd, 'C , 'A' , 'B') 
move disk 2 from C to B 
moveDisksd, 'A' , 'B' , 'C') 




moveDisksd, 'C , 'A' , 'B') moveDisksd, 'A' , 'B' , 'C') 



move disk 1 from C to A move disk 1 from A to B 



Figure 20.8 Invoking moveDi sks(3, 'A', 'B', 'C') spawns calls to moveDi sks recursively. 



692 Chapter 20 Recursion 



Video Note 



20.8 Problem: Fractals 

A fractal is a geometrical figure, but unlike triangles, circles, and rectangles, fractals can be 
divided into parts, each a reduced-size copy of the whole. There are many interesting exam- 
Fractai (Sierpinski triangle) P^ es °^ f racta l s - This section introduces a simple fractal, the Sierpinski triangle, named after a 

famous Polish mathematician. 

A Sierpinski triangle is created as follows: 

1. Begin with an equilateral triangle, which is considered to be a Sierpinski fractal of order 
(or level) 0, as shown in Figure 20.9(a). 

2. Connect the midpoints of the sides of the triangle of order to create a Sierpinski trian- 
gle of order 1 (Figure 20.9(b)). 

3. Leave the center triangle intact. Connect the midpoints of the sides of the three other tri- 
angles to create a Sierpinski triangle of order 2 (Figure 20.9(c)). 

4. You can repeat the same process recursively to create a Sierpinski triangle of order 3, 4, 
. . . , and so on (Figure 20.9(d)). 




Enter an order: 



(a) Order 



# SierpinskiTriam 




Enter an order: | 2| 




(b) Order 1 




DPanel 



DPanel 



(c) Order 2 (d) Order 3 

Figure 20.9 A Sierpinski triangle is a pattern of recursive triangles. 



The problem is inherently recursive. How do you develop a recursive solution for it? Consider 
the base case when the order is 0. It is easy to draw a Sierpinski triangle of order 0. How do you 
draw a Sierpinski triangle of order 1? The problem can be reduced to drawing three Sierpinski 
triangles of order 0. How do you draw a Sierpinski triangle of order 21 The problem can be 
reduced to drawing three Sierpinski triangles of order 1. So the problem of drawing a Sierpin- 
ski triangle of order n can be reduced to drawing three Sierpinski triangles of order n - 1. 

Listing 20.9 gives a Java applet that displays a Sierpinski triangle of any order, as shown in 
Figure 20.9. You can enter an order in a text field to display a Sierpinski triangle of the spec- 
ified order. 



Listing 20.9 Si erpi nskiTri angl e . java 

1 import javax. swing.*; 

2 import java.awt.*; 

3 import java.awt. event.*; 
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4 

5 public class Si erpi nskiTri angl e extends JApplet { 



6 private JTextField jtfOrder = new JTextField("0", 5); // Order 

7 private Si erpi nskiTri angl ePanel tri angl ePanel = 

8 new SierpinskiTrianglePanel () ; // To display the pattern 
9 

10 public Si erpi nskiTri angl e() { 

11 // Panel to hold label, text field, and a button 

12 J Panel panel = new JPanelO; 

13 panel . add(new JLabel ("Enter an order: ")); 

14 panel .add (jtfOrder) ; 

15 jtfOrder . setHori zontal Al i gnment (Swi ngConstants . RIGHT) ; 
16 

17 // Add a Sierpinski triangle panel to the applet 

18 add(trianglePanel) ; 

19 add(panel, BorderLayout . SOUTH) ; 
20 

21 // Register a listener 

22 jtfOrder . addActi onLi stener(new ActionLi stener() { listener 

23 public void actionPerformed(ActionEvent e) { 

24 tri angl ePanel . setOrder (Integer . pa rselnt (jtfOrder . getText ())) ; set a new order 

25 } 

26 }); 

27 } 
28 

29 static class SierpinskiTrianglePanel extends JPanel { 

30 private int order = 0; 
31 

32 /** Set a new order */ 

33 public void set0rder(int order) { 

34 this. order = order; 

35 repaintO; 

36 } 
37 

38 protected void pai ntComponent(Graphi cs g) { 

39 super. pai ntComponent (g) ; 
40 

41 // Select three points in proportion to the panel size 

42 Point pi = new Point (getWidth() / 2, 10); three initial points 

43 Point p2 = new Point(10, getHeight() - 10); 

44 Point p3 = new Point (getWidth() - 10, getHeight() - 10); 
45 

46 displayTriangles(g, order, pi, p2 , p3) ; 

47 } 
48 

49 private static void displayTriangles(Graphics g, int order, 

50 Point pi, Point p2 , Point p3) { 

51 if (order >= 0) { 

52 // Draw a triangle to connect three points 

53 g.drawLine(pl.x, pl.y, p2.x, p2.y); draw a triangle 

54 g.drawLine(pl.x, pl.y, p3.x, p3.y); 

55 g.drawLine(p2.x, p2.y, p3.x, p3.y); 
56 

57 // Get the midpoint on each edge in the triangle 

58 Point pl2 = midpoint (pi, p2) ; 

59 Point p23 = midpoint(p2, p3) ; 

60 Point p31 = midpoint(p3, pi); 
61 

62 // Recursively display three triangles 

63 displayTriangles(g, order - 1, pi, pl2 , p31) ; top subtriangle 
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left subtriangle 
right subtriangle 



main method omitted 



64 
65 
66 
67 
68 
69 
70 
71 
72 
73 



} 



displayTriangles(g, order 
displayTriangles(g, order 



, pl2, p2, p23); 
1, p31, p23, P 3); 



} 



private static Point mi dpoi nt(Poi nt pi, Point p2) { 

return new Point((pl.x + p2.x) / 2, (pl.y + p2.y) / 2); 

} 



The initial triangle has three points set in proportion to the panel size (lines 42-44). The 
di splayTri angl es(g, order, pi, p2, p3) method (lines 49-67) performs the follow- 
ing tasks if order >= 0: 

1. Display a triangle to connect three points pi, p2, and p3 in lines 53-55 , as shown in 
Figure 20.10(a). 

2. Obtain a midpoint between pi and p2 (line 58), a midpoint between p2 and p3 (line 
59), and a midpoint between p3 and pi (line 60), as shown in Figure 20.10(b). 

3. Recursively invoke displayTriangles with a reduced order to display three 
smaller Sierpinski triangles (lines 63-66). Note each small Sierpinski triangle is 
structurally identical to the original big Sierpinski triangle except that the order of a 
small triangle is one less, as shown in Figure 20.10(b). 

A Sierpinski triangle is displayed in a SierpinskiTrianglePanel . The order property in 
the inner class SierpinskiTrianglePanel specifies the order for the Sierpinski triangle. 
The Point class, introduced in §16.10, "Mouse Events," represents a point on a component. 
The midpoint (Point pi, Point p2) method returns the midpoint between pi and p2 
(lines 72-74). 

pi Draw the Sierpinski triangle 

di splayTri angl es(g, order, pi, p2 , p3) 




Recursively draw the small 
Sierpinski triangle 
di splayTri angl es(g , 
order - 1, pl2 , p2 , p23) 



p2 




Recursively draw the small Sierpinski triangle 
di splayTri angl es(g, 
order - 1, pi, pl2 , p31) 



Recursively draw the 
small Sierpinski triangle 
di spl ayTri angl es (g , 
order - 1, p31, p23, p3) 



Figure 20.10 Drawing a Sierpinski triangle spawns calls to draw three small Sierpinski 
triangles recursively. 
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20.9 Problem: Eight Queens 

This section gives a recursive solution to the Eight Queens problem presented at the begin- 
ning of the chapter. The task is to find a solution to place a queen in each row on a chessboard 
such that no two queens can attack each other. You may use a two-dimensional array to repre- 
sent a chessboard. However, since each row can have only one queen, it is sufficient to use a 
one-dimensional array to denote the position of the queen in the row. So, you may define 
array queens as follows: 

int[] queens = new int[8]; 

Assignj toqueens[i] to denote that a queen is placed in row i and column j. Figure 20.1 1(a) 
shows the contents of array queens for the chessboard in Figure 20.1 1(b). 



queens[0] 

queens[l] 4 

queens[2] 7 

queens[3] 5 

queens[4] 2 

queens[5] 6 

queens[6] 1 

queens[7] 3 

(a) (b) 
Figure 20.1 1 queens[i] denotes the position of the queen in row i. 

Listing 20.10 gives the program that displays a solution for the Eight Queens problem. 

Listing 20.10 EightQueens. java 

1 import java.awt.*; 

2 import javax. swing.*; 
3 

4 public class EightQueens extends JApplet { 



5 public static final int SIZE = 8; // The size of the chessboard 

6 private int[] queens = new int[SIZE]; // Queen positions 
7 

8 public EightQueensO { 

9 search(O); // Search for a solution from row search for solution 

10 add(new ChessBoardO , BorderLayout. CENTER) ; // Display solution 

11 } 
12 

13 /** Check if a queen can be placed at row i and column j */ 

14 private boolean isValid(int row, int column) { check whether valid 

15 for (int i =1; i <= row; i++) 

16 if (queens[row - i] == column // Check column 

17 || queens[row - i] == column - i // Check upleft diagonal 

18 j queens[row - i] == column + i) // Check upright diagonal 

19 return false; // There is a conflict 

20 return true; // No conflict 

21 } 
22 

23 /** Search for a solution starting from a specified row */ 

24 private boolean search(int row) { search this row 
2 5 if (row == SIZE) // Stopping condition 

26 return true; // A solution found to place 8 queens in 8 rows search columns 

27 

28 for (int column = 0; column < SIZE; column++) { search next row 
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found 



main method omitted 



queens[row] = column; // Place a queen at (row, column) 
if (isValid(row, column) && search(row + 1)) 

return true; // Found, thus return true to exit for loop 



// No solution for a queen placed at any column of this row 
return false; 



class ChessBoard extends JPanel { 
private Image queenlmage = 

new ImageIcon(" image/queen . jpg") . getlmage() ; 

ChessBoardO { 

this . setBorder (Border Factory .createLi neBorder(Color . BLACK, 2)) ; 

} 



protected void pai ntComponent(Graphi cs g) { 
super . pai ntComponent(g) ; 

// Paint the queens 

for (int i =0; i < SIZE; i++) { 

int j = queens[i]; // The position of the queen 
g . drawlmage(queenlmage , j * getWidth() / SIZE, 
i * getHeightO / SIZE, getWidthO / SIZE, 
getHeightO / SIZE, this); 

} 

// Draw the horizontal and vertical lines 
for (int i =1; i < SIZE; i++) { 

g.drawLine(0, i * getHeightO / SIZE, 

getWidthO, i * getHeightO / SIZE); 
g.drawLine(i * getWidthO / SIZE, 0, 
i * getWidthO / SIZE, getHeightO); 

} 



29 
30 
31 

32 } 
33 
34 
35 

36 } 
37 
38 
39 
40 
41 
42 
43 
44 
45 
46 
47 
48 
49 
50 
51 
52 
53 
54 
55 
56 
57 
58 
59 
60 
61 
62 
63 

64 } 

65 } 

66 } 

The program invokes search (0) (line 9) to start a search for a solution at row 0, which 
recursively invokes search(l), search(2), . . . , and search(7) (line 30). 

The recursive search (row) method returns true if all row are filled (lines 25-26). The 
method checks whether a queen can be placed in column 0, 1, 2, . . . , and 7 in a for loop 
(line 28). Place a queen in the column (line 29). If the placement is valid, recursively search 
for the next row by invoking search(row + 1) (line 30). If search is successful, return true 
(line 31) to exit the for loop. In this case, there is no need to look for the next column in the 
row. If there is no solution for a queen to be placed on any column of this row, the method 
returns f al se (line 35). 

Suppose you invoke search (row) for row 3, as shown in Figure 20.12(a). The method 
tries to fill in a queen in column 0, 1, 2, and so on in this order. For each trial, the 
isVal id(row, col umn) method (line 30) is called to check whether placing a queen at the 
specified position causes a conflict with the queens placed earlier. It ensures that no queen is 
placed in the same column (line 16), no queen is placed in the upper left diagonal (line 17), 
and no queen is placed in the upper right diagonal (line 18), as shown in Figure 20.12(a). If 
isVal id(row, col umn) returns fal se, check the next column, as shown Figure 20.12(b). 
If isVal id(row, column) returns true, recursively invoke search(row + 1), as shown 
in Figure 20.12(d). If search(row + 1) returns fal se, check the next column on the pre- 
ceding row, as shown Figure 20.12(c). 
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search (row) 
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01234567 01234567 




search(row + 1) 



(c) (d) 
Figure 20.12 Invoking search(row) fills in a queen in a column on the row. 



20.10 Recursion vs. Iteration 

Recursion is an alternative form of program control. It is essentially repetition without a loop. 
When you use loops, you specify a loop body. The repetition of the loop body is controlled by 
the loop control structure. In recursion, the method itself is called repeatedly. A selection 
statement must be used to control whether to call the method recursively or not. 

Recursion bears substantial overhead. Each time the program calls a method, the system recursion overhead 
must assign space for all of the method's local variables and parameters. This can consume 
considerable memory and requires extra time to manage the additional space. 

Any problem that can be solved recursively can be solved nonrecursively with iterations. 
Recursion has some negative aspects: it uses up too much time and too much memory. Why, recursion advantages 
then, should you use it? In some cases, using recursion enables you to specify for an inher- 
ently recursive problem a clear, simple solution that would otherwise be difficult to obtain. 
Examples are the directory-size problem, the Towers of Hanoi problem, and the fractal prob- 
lem, which are rather difficult to solve without using recursion. 

The decision whether to use recursion or iteration should be based on the nature of, and your recursion or iteration? 
understanding of, the problem you are trying to solve. The rule of thumb is to use whichever 
approach can best develop an intuitive solution that naturally mirrors the problem. If an iterative 
solution is obvious, use it. It will generally be more efficient than the recursive option. 

|p Note 

Your recursive program could run out of memory, causing a StackOverflowError. StackOverflowError 
|§| Tip 

If you are concerned about your program's performance, avoid using recursion, because it takes performance concern 

more time and consumes more memory than iteration. 



20.1 1 Tail Recursion 

A recursive method is said to be tail recursive if there are no pending operations to be per- 
formed on return from a recursive call. For example, the recursive isPal indrome method 
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(lines 6-13) in Listing 20.4 is tail recursive because there are no pending operations after 
recursively invoking isPal indrome in line 12. However, the recursive factorial method 
(lines 16-21) in Listing 20. 1 is not tail recursive, because there is a pending operation, namely 
multiplication, to be performed on return from each recursive call. 

Tail recursion is desirable, because the method ends when the last recursive call ends. So 
there is no need to store the intermediate calls in the stack. Some compilers can optimize tail 
recursion to reduce stack space. 

A non-tail-recursive method can often be converted to a tail-recursive method by using auxiliary 
parameters. These parameters are used to contain the result. The idea is to incorporate the pending 
operations into the auxiliary parameters in such a way that the recursive call no longer has a pend- 
ing operation. You may define a new auxiliary recursive method with the auxiliary parameters. This 
method may overload the original method with the same name but a different signature. For exam- 
ple, the factorial method in Listing 20.1 can be written in a tail-recursive way as follows: 



original method 
invoke auxiliary method 



auxiliary method 



recursive call 



1 /** Return the factorial for a specified number */ 

2 public static long factorial (int n) { 

3 return factorial (n, 1); // Call auxiliary method 

4 } 
5 

6 /** Auxiliary tail-recursive method for factorial */ 

7 private static long factorial (int n, int result) { 

8 if (n == 1) 

9 return result; 

10 el se 

11 return factorial (n - 1, n * result); // Recursive call 

12 } 



The first factorial method simply invokes the second auxiliary method (line 3). The second 
method contains an auxiliary parameter resul t that stores the result for factorial of n. This method 
is invoked recursively in line 1 1 . There is no pending operation after a call is returned. The final result 
is returned in line 9, which is also the return value from invoking f actor i al (n , 1) in line 3. 
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Chapter Summary 



1 . A recursive method is one that directly or indirectly invokes itself. For a recursive 
method to terminate, there must be one or more base cases. 

2. Recursion is an alternative form of program control. It is essentially repetition without 
a loop control. It can be used to specify simple, clear solutions for inherently recursive 
problems that would otherwise be difficult to solve. 

3. Sometimes the original method needs to be modified to receive additional parameters in 
order to be invoked recursively. A recursive helper method can be defined for this purpose. 

4. Recursion bears substantial overhead. Each time the program calls a method, the sys- 
tem must assign space for all of the method's local variables and parameters. This can 
consume considerable memory and requires extra time to manage the additional space. 

5 . A recursive method is said to be tail recursive if there are no pending operations to be 
performed on return from a recursive call. Some compilers can optimize tail recursion 
to reduce stack space. 



Review Questions 



Review Questions 699 



Sections 20.1-20.3 

20.1 What is a recursive method? Describe the characteristics of recursive methods. 
What is an infinite recursion? 

20.2 Write a recursive mathematical definition for computing 2" for a positive integer n. 

20.3 Write a recursive mathematical definition for computing x" for a positive integer n 
and a real number x. 

20.4 Write a recursive mathematical definition for computing l + 2 + 3 + -- - + n 
for a positive integer. 

20.5 How many times is the factorial method in Listing 20.1 invoked for 
factorial (6)? 

20.6 How many times is the fib method in Listing 20.2 invoked for fib(6)? 
Sections 20.4-20.6 

20.7 Show the call stack for isPal indrome("abcba") using the methods defined in 
Listing 20.3 and Listing 20.4, respectively. 

20.8 Show the call stack for selectionSort(new double[]{2, 3, 5, 1}) using 
the method defined in Listing 20.5. 

20.9 What is a recursive helper method? 
Section 20.7 

20.10 How many times is the moveDisks method in Listing 20.8 invoked for 
moveDisks(5, 'A' , 'B' , 'C')? 

Section 20.9 

20.1 I Which of the following statements are true? 

■ Any recursive method can be converted into a nonrecursive method. 

■ Recursive methods take more time and memory to execute than nonrecursive 
methods. 

■ Recursive methods are always simpler than nonrecursive methods. 

■ There is always a selection statement in a recursive method to check whether a 
base case is reached. 

20. 1 2 What is the cause for the stack-overflow exception? 
Comprehensive 

20. 1 3 Show the output of the following program: 



public class Test { 




public static void main(String[] 


args) { 


System . out . pri ntl n ( 




"Sum is " + xMethod(5)); 




} 




public static int xMethod(int n) 


{ 


if (n == 1) 




return 1; 




el se 




return n + xMethod(n - 1); 




} 




} 





public class Test { 

public static void main(String[] args) { 
xMethod(1234567) ; 

} 

public static void xMethod(int n) { 
if (n > 0) { 

System. out. print(n % 10); 
xMethod(n / 10) ; 

} 

} 
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20.1 4 Show the output of the following two programs: 



public class Test { 

public static void man n(Stri ng [] args) { 
xMethod(5) ; 

} 

public static void xMethod(int n) { 
if (n > 0) { 
System. out. pn'nt(n + " "); 
xMethod(n - 1); 

} 

} 



public class Test { 

public static void main(Stn'ng[] args) { 
xMethod(5) ; 

} 

public static void xMethod(int n) { 
if (n > 0) { 
xMethod(n - 1); 
System. out. print(n + " "); 

} 

} 



20. 1 5 What is wrong in the following method? 



public class Test { 

public static void main(String[] args) { 
xMethod(1234567) ; 

} 

public static void xMethod(doubl e n) { 
if (n != 0) { 
System. out. print(n) ; 
xMethod(n / 10) ; 

} 

} 



public class Test { 

public static void main(Stn'ng[] args) { 
Test test = new Test() ; 
System .out . pri ntl n(test . toStri ng()) ; 

} 

public TestO { 
Test test = new Test(); 

} 



20. 1 6 Identify tail-recursive methods in this chapter. 

20. 1 7 Rewrite the f i b method in Listing 20.2 using tail recursion. 
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Sections 20.2-20.3 

20.1* (Factorial) Using the Biglnteger class introduced in §14.12, you can find the 
factorial for a large number (e.g., 100 ! ). Write a program that prompts the user to 
enter an integer and displays its factorial. Implement the method using recursion. 

20.2* (Fibonacci numbers) Rewrite the fib method in Listing 20.2 using iterations. 

Hint: To compute fib(n) without recursion, you need to obtain fib(n - 2) 
and fib(n - 1) first. Let fO and fl denote the two previous Fibonacci num- 
bers. The current Fibonacci number would then be fO + f 1. The algorithm can 
be described as follows: 



fO = 0; // For fib(0) 
fl = 1; // For fib(l) 

for (int i = 1; i <= n; i++) { 
currentFib = fO + fl; 
fO = fl; 

fl = currentFib; 

} 



// After the loop, currentFib is fib(n) 



Programming Exercises 701 



20.3* (Computing greatest common divisor using recursion) The gcd(m , n) can also 
be defined recursively as follows: 

■ If m % n is 0, gcd (m , n) is n. 

■ Otherwise, gcd (m, n)isgcd(n, m%n). 

Write a recursive method to find the GCD. Write a test program that computes 
gcd(24, 16) andgcd(255, 25). 

20.4 (Summing series) Write a recursive method to compute the following series: 

11 1 

m(i) = !.+- + - + ••• + - 
W 2 3 i 

20.5 (Summing series) Write a recursive method to compute the following series: 

1 2 3 4 5 6 i 

m(i) = - + - + - + - + — + — + ••• + 

w 3 5 7 9 11 13 2i + 1 

20.6* (Summing series) Write a recursive method to compute the following series: 

...12 i 

m(i) =- + - + ••• + 

w 2 3 2 + 1 

20.7* (Fibonacci series) Modify Listing 20.2, ComputeFibonacci.java, so that the pro- 
gram finds the number of times the f i b method is called. 

(Hint: Use a static variable and increment it every time the method is called.) 
Section 20.4 

20.8* (Printing the digits in an integer reversely) Write a recursive method that dis- 
plays an int value reversely on the console using the following header: 

public static void reverseDi spl ay(int value) 

For example, reverseDi splay(12345) displays 54321. 

20.9* (Printing the characters in a string reversely) Write a recursive method that dis- 
plays a string reversely on the console using the following header: 

public static void reverseDi spl ay (Stri ng value) 

For example, reverseDi spl ay ("abed") displays deba. 

20. 1 0* (Occurrences of a specified character in a string) Write a recursive method that 
finds the number of occurrences of a specified letter in a string using the follow- 
ing method header. 

public static int count(String str, char a) 

For example, count ("Wei come" , 'e') returns 2. 

20.1 I* (Summing the digits in an integer using recursion) Write a recursive method 
that computes the sum of the digits in an integer. Use the following method 
header: 



public static int sumDi gits (long n) 

For example, sumDigits(234) returns 2 + 3 + 4 = 9. 



702 Chapter 20 Recursion 



Section 20.5 

20. 12** (Printing the characters in a string reversely) Rewrite Exercise 20.9 using a 
helper method to pass the substring high index to the method. The helper 
method header is: 

public static void reverseDi spl ay(Stri ng value, int high) 

20.1 3* (Finding the largest number in an array) Write a recursive method that returns 
the largest integer in an array. 

20.14* (Finding the number of uppercase letters in a string) Write a recursive method 
to return the number of uppercase letters in a string. 

20.1 5* (Occurrences of a specified character in a string) Rewrite Exercise 20.10 using 
a helper method to pass the substring high index to the method. The helper 
method header is: 

public static int count(String str, char a, int high) 

20. 1 6* (Finding the number of uppercase letters in an array) Write a recursive method 
to return the number of uppercase letters in an array of characters. You need to 
define the following two methods. The second one is a recursive helper method. 

public static int count(char[] chars) 

public static int count(char[] chars, int high) 

20. 1 7* (Occurrences of a specified character in an array) Write a recursive method that 
finds the number of occurrences of a specified character in an array. You need to 
define the following two methods. The second one is a recursive helper method. 

public static int count(char[] chars, char ch) 

public static int count(char[] chars, char ch, int high) 

Sections 20.6 

20. 1 8* (Towers of Hanoi) Modify Listing 20.8, TowersOfHanoi.java, so that the program 
finds the number of moves needed to move n disks from tower A to tower B. 

(Hint: Use a static variable and increment it every time the method is called.) 

20.1 9* (Sierpinski triangle) Revise Listing 20.9 to develop an applet that lets the user 
use the Increase and Decrease buttons to increase or decrease the current order 
by 1, as shown in Figure 20.13(a). The initial order is 0. If the current order is 0, 
the Decrease button is ignored. 
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20.20* (Displaying circles) Write a Java applet that displays ovals, as shown in Figure 
20.13(b). The ovals are centered in the panel. The gap between two adjacent 
ovals is 10 pixels, and the gap between the panel and the largest oval is also 10. 

Comprehensive 

20.2 1 * (Decimal to binary) Write a recursive method that converts a decimal number 
into a binary number as a string. The method header is as follows: 

public static String decimalToBi nary(int value) 

20.22* (Decimal to hex) Write a recursive method that converts a decimal number into 
a hex number as a string. The method header is as follows: 

public static String decimal ToHex(int value) 

20.23* (Binary to decimal) Write a recursive method that parses a binary number as a 
string into a decimal integer. The method header is as follows: 

public static int bi naryToDeci mal (Stri ng bi naryStri ng) 

20.24* (Hex to decimal) Write a recursive method that parses a hex number as a string 
into a decimal integer. The method header is as follows: 

public static int hexToDeci mal (Stri ng hexString) 

20.25** (String permutation) Write a recursive method to print all the permutations of a 
string. For example, for a string abc, the printout is 

abc 
acb 
bac 
bca 
cab 
cba 

(Hint: Define the following two methods. The second is a helper method.) 

public static void displayPermuation(String s) 

public static void displayPermuation(String si, String s2) 

The first method simply invokes displayPermuationC"" , s). The second 
method uses a loop to move a character from s2 to si and recursively invoke it with 
a new si and s2. The base case is that s2 is empty and prints si to the console. 

20.26** (Creating a maze) Write an applet that will find a path in a maze, as shown in 
Figure 20.14(a). The maze is represented by an 8 X 8 board. The path must 
meet the following conditions: 

■ The path is between the upper-left corner cell and the lower-right corner cell 
in the maze. 

■ The applet enables the user to place or remove a mark on a cell. A path con- 
sists of adjacent unmarked cells. Two cells are said to be adjacent if they are 
horizontal or vertical neighbors, but not if they are diagonal neighbors. 

■ The path does not contain cells that form a square. The path in Figure 20. 14(b), 
for example, does not meet this condition. (The condition makes a path easy to 
identify on the board.) 
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(a) Correct path (b) Illegal path 

Figure 20. 1 4 The program finds a path from the upper-left corner to the bottom-right corner. 

20.27** (Koch snow flake fractal) The text presented the Sierpinski triangle fractal. In 
this exercise, you will write an applet to display another fractal, called the Koch 
snowflake, named after a famous Swedish mathematician. A Koch snowflake is 
created as follows: 

1. Begin with an equilateral triangle, which is considered to be the Koch fractal 
of order (or level) 0, as shown in Figure 20.15(a). 

2. Divide each line in the shape into three equal line segments and draw an out- 
ward equilateral triangle with the middle line segment as the base to create a 
Koch fractal of order 1, as shown in Figure 20.15(b). 

3. Repeat step 2 to create a Koch fractal of order 2,3, . . . , and so on, as shown 
in Figure 20.15(c-d). 




Enter an order: | D| Errier an order: | t| Enter an order: | | 4 



X^ 



(a) (b) (c) 

Figure 20. 1 5 A Koch snowflake is a fractal starting with a triangle. 




Enter an order: j| 



(d) 



20.28** (Nonrecursive directory size) Rewrite Listing 20.7, DirectorySize.java, without 
using recursion. 

20.29* (Number of files in a directory) Write a program that prompts the user to enter a 
directory and displays the number of the files in the directory. 

20.30** (Finding words) Write a program that finds all occurrences of a word in all the files 
under a directory, recursively. Pass the parameters from the command line as follows: 

Video Note ^ ava Exerc "" se2 ° 30 dirName word 

Search a string in a directory 20.3 I ** (Replacing words) Write a program that replaces all occurrences of a word with 

a new word in all the files under a directory, recursively. Pass the parameters 
from the command line as follows: 

java Exercise20 31 dirName oldWord newWord 
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20.32*** (Game: Knight's Tour) The Knight's Tour is an ancient puzzle. The objective is to 
move a knight, starting from any square on a chessboard, to every other square 
once, as shown in Figure 20.16(a). Note that the knight makes only L-shape moves 
(two spaces in one direction and one space in a perpendicular direction). As shown 
in Figure 20. 16(b), the knight can move to eight squares. Write a program that dis- 
plays the moves for the knight in an applet, as shown in Figure 20.16(c). 

(Hint: A brute-force approach for this problem is to move the knight from one 
square to another available square arbitrarily. Using such an approach, your 
program will take a long time to finish. A better approach is to employ some 
heuristics. A knight has two, three, four, six, or eight possible moves, depend- 
ing on its location. Intuitively, you should attempt to move the knight to the 
least accessible squares first and leave those more accessible squares open, so 
there will be a better chance of success at the end of the search.) 




Figure 20.16 (a) A knight traverses all squares once, (b) A knight makes an L-shape move, (c) An applet displays a 
knight tour path. 

20.33*** (Game: Knight's Tour animation) Write an applet for the Knight's Tour problem. 

Your applet should let the user move a knight to any starting square and click the 
Solve button to animate a knight moving along the path, as shown in Figure 20.17. 
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Figure 20.1 7 A knight traverses along the path. 



20.34** 
20.35** 



(Game: Sudoku) Write a program to solve the Sudoku problem using recursion. 
(H-tree fractal) An H-tree is a fractal defined as follows: 

1. Begin with a letter H. The three lines of the H are of the same length, as 
shown in Figure 20.18(a). 

2. The letter H (in its sans-serif form, H) has four endpoints. Draw an H centered 
at each of the four endpoints to an H-tree of order 1, as shown in Figure 
20.18(b). These H's are half the size of the H that contains the four endpoints. 

3. Repeat step 2 to create a H-tree of order 2,3, . . . , and so on, as shown in 
Figure 20.18(c-d). 
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(a) (b) (c) (d) 

Figure 20.1 8 An H-tree is a fractal starting with three lines of equal length in an H-shape. 

The H-tree is used in VLSI design as a clock distribution network for routing 
timing signals to all parts of a chip with equal propagation delays. Write an 
applet that draws an H-tree, as shown in Figure 20.18. 

20.36*** (Game: all Sudoku solutions) Rewrite Exercise 20.34 to find all possible solu- 
tions to a Sudoku problem. 

20.37*** (Game: multiple Eight Queens solution) Write an applet to display all possible 
solutions for the Eight Queens puzzle in a scroll pane, as shown in Figure 20.19. 
For each solution, put a label to denote the solution number. 
Hint: Place all solution panels into one panel and place this one panel into a 
JScrol 1 Pane. The solution panel class should override the getPref erred- 
SizeO method to ensure that a solution panel is displayed properly. See List- 
ing 15.3, FigurePanel.java, on how to override getPreferredSizeQ. 
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Figure 20.1 9 All solutions are placed in a scroll pane. 

20.38** (Recursive tree) Write an applet to display a recursive tree as shown in Figure 20.20. 

20.39** (Dragging the tree) Revise Exercise 20.38 to move the tree to where the mouse 
is dragged. 
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(a) (b) 
Figure 20.20 A recursive tree with the specified depth. 



(c) 



(d) 



Chapter 21 

Generics 

Objectives 

■ To describe the benefits of generics (§21.1). 

■ To use generic classes and interfaces (§21.2). 

■ To define generic classes and interfaces (§21.3). 

■ To explain why generic types can improve reliability and readability (§21.3). 

■ To define and use generic methods and bounded generic types (§21.4). 

■ To use raw types for backward compatibility (§21.5). 

■ To explain why wildcard generic types are 
necessary (§21.6). 

■ To describe generic type erasure and list certain restrictions 
and limitations on generic types caused by 

type erasure (§21.7). 

■ To design and implement generic matrix classes (§21.8). 
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21.1 Introduction 

what is generics? Generics is the capability to parameterize types. With this capability, you can define a class or 

a method with generic types that the compiler can replace with concrete types. For example, 
you may define a generic stack class that stores the elements of a generic type. From this 
generic class, you may create a stack object for holding strings and a stack object for holding 
numbers. Here, strings and numbers are concrete types that replace the generic type. 

why generics? The key benefit of generics is to enable errors to be detected at compile time rather than at 

runtime. A generic class or method permits you to specify allowable types of objects that the 
class or method may work with. If you attempt to use an incompatible object, the compiler 
can detect the errors. 

This chapter explains how to define and use generic classes, interfaces, and methods and 
demonstrates how generics can be used to improve software reliability and readability. It can 
be intertwined with Chapter 14, "Abstract Classes and Interfaces." 

21.2 Motivations and Benefits 

Since JDK 1.5, Java allows you to define generic classes, interfaces, and methods. Several 
interfaces and classes in the Java API are modified using generics. For example, prior to JDK 
1 .5 the j ava . 1 ang . Compa rabl e interface was defined as shown in Figure 2 1 . 1 (a), but since 
JDK 1.5 it is modified as shown in Figure 21.1(b). 



package j ava. 1 ang; 

public interface Comparable { 
public int compareTo(Object o) 

} 



package j ava. 1 ang; 

public interface Comparable<T> { 
public int compa reTo(T o) 

} 



(a) Prior to JDK 1.5 



(b) JDK 1.5 



Figure 21.1 The j ava. 1 ang .Comparable interface is redefined since JDK 1.5 with a 
generic type. 



formal generic type 
actual concrete type 
generic instantiation 



Here, <T> represents a formal generic type, which can be replaced later with an actual 
concrete type. Replacing a generic type is called a generic instantiation. By convention, a sin- 
gle capital letter such as E or T is used to denote a formal generic type. 

To see the benefits of using generics, let us examine the code in Figures 21.2. The state- 
ment in Figure 21.2(a) declares that c is a reference variable whose type is Comparabl e and 
invokes the compareTo method to compare a Date object with a string. The code compiles 
fine, but it has a runtime error because a string cannot be compared with a date. 



Comparable c = new DateO; 

System . out .pri ntl n (c . compareTo (" red")) ; 



Comparabl e<Date> c = new Date(); 
System . out . pri ntl n (c . compareTo (" red") ) ; 



(a) Prior to JDK 1.5 

Figure 2 1 .2 The new generic type detects possible errors at compile time. 



(b) JDK 1.5 



The statement in Figure 21.2(b) declares that c is a reference variable whose type is 
Comparabl e<Date> and invokes the compareTo method to compare a Date object with a 
string. The code has a compile error, because the argument passed to the compareTo method 
must be of the Date type. Since the errors can be detected at compile time rather than at run- 
reliable time, the generic type makes the program more reliable. 
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ArrayList was introduced in §11.11, "The ArrayList Class." This class is a generic 
class since JDK 1.5. Figure 21.3 shows the class diagram for ArrayList before and since 
JDK 1.5, respectively. 



java.util.ArrayList 



I 



java.util.ArrayList <E> 



+ArrayLi st() 

+add(o: Object): void 

+add (index: int, o: Object): void 

+clear(): void 

+contains(o: Object): boolean 
+get(i ndex : i nt) : Object 
+index0f(o: Object): int 
+isEmpty(): boolean 
+1 astlndexOf (o : Object): int 
+remove(o: Object): boolean 
+size(): int 

+remove(i ndex : int): boolean 
+set(index: int, o: Object): Object 



+Arrayl_i st() 
+add(o: E) : void 
+add(index: int, o: E) : void 
+clear() : void 

+contains(o: Object): boolean 
+get(i ndex: int) : E 
+indexOf(o: Object): int 
+isEmpty(): boolean 
+1 astlndexOf (o: Object): int 
+remove(o: Object): boolean 
+size() : int 

+remove (index: int): boolean 
+set(index: int, o: E) : E 



(b) ArrayLi st in JDK 1.5 



only string allowed 



(a) ArrayLi st before JDK 1.5 
Figure 21.3 ArrayList is a generic class since JDK 1.5. 

For example, the following statement creates a list for strings: 
ArrayLi st<Stri ng> list = new ArrayLi st<Stri ng>() ; 
You can now add only strings into the list. For example, 
list. add ("Red"); 

If you attempt to add a nonstring, a compile error will occur. For example, the following state- 
ment is now illegal, because 1 ist can contain only strings. 

1 i st . add(new Integer(l)); 

Generic types must be reference types. You cannot replace a generic type with a primitive generic reference type 
type such as int, doubl e, or char. For example, the following statement is wrong: 

ArrayLi st<int> intList = new ArrayLi st<int> () ; 
To create an ArrayLi st object for i nt values, you have to use: 

ArrayLi st<Integer> intList = new ArrayLi st<Integer> () ; 
You can add an int value to intList. For example, 

intList. add(5) ; 

Java automatically wraps 5 into new Integer(5). This is called autoboxing, as introduced in autoboxing 
§14.11, "Automatic Conversion between Primitive Types and Wrapper Class Types." 

Casting is not needed to retrieve a value from a list with a specified element type, because no casting needed 
the compiler already knows the element type. For example, the following statements create a 
list that contains strings, add strings to the list, and retrieve strings from the list. 
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1 ArrayLi st<Stri ng> list = new ArrayLi st<Stri ng>() ; 

2 list. add ("Red"); 

3 list.add("white") ; 

4 String s = list.get(O); // No casting is needed 

Prior to JDK 1.5, without using generics, you would have had to cast the return value to 
String as follows: 

String s = (String) (list. get(0)) ; // Casting needed prior to DDK 1.5 

If the elements are of wrapper types, such as Integer, Double, and Character, you can 

autounboxing directly assign an element to a primitive type variable. This is called autounboxing, as intro- 

duced in §14.1 1. For example, see the following code: 

1 ArrayLi st<Doubl e> list = new ArrayLi st<Doubl e>() ; 

2 1 i st . add(5 . 5) ; // 5.5 is automatically converted to new Double(5.5) 

3 1 i st . add(3 .0) ; // 3.0 is automatically converted to new Double(3.0) 

4 Double doubleObject = list.get(O); // No casting is needed 

5 double d = list.get(l); // Automatically converted to double 

In lines 2 and 3,5.5 and 3 . are automatically converted into Doubl e objects and added to 
1 i st. In line 4, the first element in 1 i st is assigned to a Doubl e variable. No casting is nec- 
essary, because 1 i st is declared for Doubl e objects. In line 5, the second element in 1 i st is 
assigned to a doubl e variable. The object in 1 i st . get (1) is automatically converted into a 
primitive type value. 

2 1 .3 Defining Generic Classes and Interfaces 

Let us revise the stack class in § 1 1 . 1 2, "A Custom Stack Class," to generalize the element type 
with a generic type. The new stack class, named GenericStack, is shown in Figure 21.4 and 
is implemented in Listing 21.1. 



GenericStack<E> 



-list: java.util .ArrayLi st<E> 



+Ceneri cStack() 
+getSize(): int 
+peek(): E 
+pop(): E 
+push(o: E) : void 
+isEmpty(): boolean 



An array list to store elements. 

Creates an empty stack. 

Returns the number of elements in this stack. 

Returns the top element in this stack. 

Returns and removes the top element in this stack. 

Adds a new element to the top of this stack. 

Returns true if the stack is empty. 



Figure 21.4 The GenericStack class encapsulates the stack storage and provides the 
operations for manipulating the stack. 



Listing 21. 1 Generi cStack. java 

generic type E declared 1 public class Generi cStacl«E> { 

generic array list 2 private java . uti 1 .ArrayLi st<E> list = new java.util .ArrayList<E>() ; 

3 

getSize 4 public int getSize() { 

5 return list.size(); 

6 } 
7 
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8 

9 
10 
11 
12 
13 
14 
15 
16 
17 
18 
19 
20 
21 
22 
23 
24 

25 } 



public E peek() { 

return 1 i st . get(getSi ze() - 1) ; 

} 



peek 



public void push(E o) { 
1 i st . add(o) ; 

} 



push 



public E pop() { 



pop 



E o = list.get(getSize() - 1) ; 
"list, remove (getSizeO - 1); 
return o; 

} 



public boolean isEmptyO { 
return 1 i st . i sEmptyO ; 

} 



isEmpty 



Here is an example that creates a stack to hold strings and adds three strings to the stack: 

Generi cStack<Stri ng> stackl = new Generi cStack<Stri ng>() ; 
stackl. push ("London") ; 
stackl. push("Paris") ; 
stackl. push("Berl in") ; 



Here is another example that creates a stack to hold integers and adds three integers to the stack: 

Generi cStack<Integer> stack2 = new Generi cStack<Integer>() ; 
stack2 . push(l) ; // auto boxing 1 to new Integer(l) 
stack2 . push(2) ; 
stack2 . push(3) ; 



Instead of using a generic type, you could simply make the type element Object, which benefits of using generic types 
can accommodate any object type. However, using generic types can improve software reli- 
ability and readability, because certain errors can be detected at compile time rather than at 
runtime. For example, since stackl is declared Generi cStack<String>, only strings 
can be added to the stack. It would be a compile error if you attempted to add an integer to 
stackl. 

H§| Caution 

To create a stack of strings, you use newGenericStack<String>(). This could mislead you 

into thinking that the constructor of GenericStack should be defined as generic class constructor 

public Generi cStack<E>() 



This is wrong. It should be defined 
public Generi cStackQ 



% Note 



Occasionally, a generic class may have more than one parameter. In this case, place the parameters 
together inside the brackets, separated by commas — for example, <E1 , E2 , E3>. 



multiple generic parameters 



j|| Note 

You can define a class or an interface as a subtype of a generic class or interface. For example, the 
java.lang. String class is defined to implement the Comparable interface in the Java API 
as follows: 

public class String implements Comparabl e<Stri ng> 

21.4 Generic Methods 

You can define generic interfaces (e.g., the Comparable interface in Figure 21.1(b)) and 
classes (e.g., the CenericStack class in Listing 21.1). You can also use generic types to 
define generic methods. For example, Listing 21.2 defines a generic method print (lines 
10-14) to print an array of objects. Line 6 passes an array of integer objects to invoke the 
generic print method. Line 7 invokes print with an array of strings. 

Listing 2 1 .2 Gene ri cMethodDemo . j ava 

1 public class Generi cMethodDemo { 

2 public static void main(String[] args ) { 

3 Integer[] integers = {1, 2, 3, 4, 5}; 

4 String [] strings = {"London", "Paris", "New York", "Austin"}; 
5 

6 Generi cMethodDemo . <Integer>pri nt(i ntegers) ; 

7 Generi cMethodDemo . <Stri ng>pri nt(stri ngs) ; 

8 } 
9 

10 public static <E> void print(E[] list) { 

11 for (int i =0; i < list. length; i++) 

12 System. out. pri nt(l i st [i ] + " ") ; 

13 System. out. pri ntl n() ; 

14 } 

15 } 

To invoke a generic method, prefix the method name with the actual type in angle brackets. 
For example, 

Generi cMethodDemo . <Integer>pri nt (i ntegers) ; 
Generi cMethodDemo . <Stri ng>pri nt(stri ngs) ; 

A generic type can be specified as a subtype of another type. Such a generic type is called 
bounded. For example, Listing 21.3 revises the equal Area method in Listing 1 1.4, TestGeo- 
metricObject.java, to test whether two geometric objects have the same area. The bounded 
generic type <E extends GeometricObject> (line 7) specifies that E is a generic subtype 
of GeometricObject. You must invoke equalArea by passing two instances of 
GeometricObject. 

Listing 21.3 BoundedTypeDemo . j ava 

1 public class BoundedTypeDemo { 

2 public static void main(String[] args ) { 

3 Rectangle rectangle = new Rectangle(2, 2); 

4 Circle circle = new Circle(2); 
5 

6 System. out. pri ntl n ("Same area? " + 

7 BoundedTypeDemo . <Geometri cObject>equal Area(rectangl e , ci rcl e)) ; 

8 } 
9 

10 public static <E extends Geometri c0bject> boolean equalArea( 

11 E objectl, E object2) { 
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12 

13 

14 } 



return objectl.getAreaQ == object2 . getAreaQ ; 



} 




An unbounded generic type <E> is the same as <E extends Object>. 



§ Note 



To define a generic type for a class, place it after the class name, such as GenericStack<E>. 
To define a generic type for a method, place the generic type before the method return type, such 
as <E> void max(E ol, E o2). 



generic class parameter vs. 
generic method parameter 



21.5 Raw Type and Backward Compatibility 



You may use a generic class without specifying a concrete type like this: 

Generi cStack stack = new Generi cStackO ; // raw type 
This is roughly equivalent to 

Generi cStack<Object> stack = new Generi cStack<Object>() ; 

A generic class such as Generi cStack and ArrayList used without a type parameter 

is called a raw type. Use of raw type is allowed for backward compatibility with the earlier raw type 

versions of Java. For example, generic type is used in java.lang. Comparable since JDK backward compatibility 

1.5, but a lot of code still uses the raw type Comparabl e, as shown in Listing 21.4 (also see 

the Max class in §14.5, "Example: The Comparabl e Interface"): 

Listing 2 1.4 Max.java 

1 public class Max { 

2 /** Return the maximum between two objects */ 

3 public static Comparable max(Comparabl e ol , Comparable o2) { raw type 

4 if (ol. compareTo(o2) > 0) 

5 return ol; 



Comparable ol and Comparable o2 are raw type declarations. Raw type is unsafe. For 
example, you might invoke the max method using 

Max. max ("Wei come" , 23); // 23 is autoboxed into new Integer(23) 

This would cause a runtime error, because you cannot compare a string with an integer 
object. The Java compiler displays a warning on line 3 when compiled with the option 
-Xli nt : unchecked, as shown in Figure 21.5. XI int: unchecked 



6 
7 
8 

9 } 



el se 



return o2 ; 



} 




if (ol . corapareTo{o2) > 9) 



Figure 21.5 The unchecked warnings are displayed using the compiler option 
-XI i nt : unchecked. 



714 Chapter 2 1 Generics 



bounded type 



A better way to write the max method is to use a generic type, as shown in Listing 21.5. 

Listing 21.5 Maxl.java 

1 public class Maxl { 

2 /** Return the maximum between two objects */ 

3 public static <E extends Comparabl e<E» E max(E ol , E o2) { 

4 if (ol. compareTo(o2) > 0) 

5 return ol; 

6 el se 

7 return o2; 

8 } 

9 } 



If you invoke the max method using 

Maxl. max ("Wei come", 23); // 23 is autoboxed into new Integer(23) 

a compile error will be displayed, because two arguments of the max method in Maxl must 
have the same type (e.g., two strings or two integer objects). Furthermore, the type E must be 
a subtype of Comparabl e<E>. 

As another example, in the following code you may declare a raw type stack in line 1, 
assign new GenericStack<String> to it in line 2, and push a string and an integer object 
to the stack in lines 3 and 4. 

1 CenericStack stack; 

2 stack = new Generi cStack<Stri ng>() ; 

3 stack. push ("Wei come to Java"); 

4 stack. push (new Integer(2)); 

Line 4 is unsafe because the stack is intended to store strings, but an Integer object is added 
into the stack. Line 3 should be OK, but the compiler will show warnings on both line 3 and 
line 4, because it cannot follow the semantic meaning of the program. All the compiler knows 
is that stack is a raw type, and performing certain operations is unsafe. Therefore, warnings 
are displayed to alert potential problems. 

#Tip 

Since raw types are unsafe, this book will not use them from here on. 



Generi cStack<Integer> 

type 



21.6 Wildcard Generic Types 



What are wildcard generic types and why are needed? Listing 21.6 gives an example to 
demonstrate the needs. The example defines a generic max method for finding the maximum 
in a stack of numbers (lines 12-22). The main method creates a stack of integer objects, adds 
three integers to the stack, and invokes the max method to find the maximum number in the 
stack. 

Listing 21.6 WildCardDemol. java 



public class WildCardDemol { 

public static void main(String[] args ) { 

Generi cStack<Integer> intStack = new Generi cStack<Integer>() ; 
i ntStack. push(l) ; // 1 is autoboxed into new Integer(l) 
intStack. push(2) ; 
intStack. push(-2) ; 

System. out . pri nt("The max number is " + max(i ntStack)) ; 
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10 GenericStack<Number> 

11 /** Find the maximum in a stack of numbers */ type 

12 public static double max(Generi cStack<Number> stack) { 

13 double max = stack. pop() . doubl eVal ue() ; // Initialize max 
14 

15 while (Istack.isEmptyO) { 

16 double value = stack. pop() .doubl eValueO ; 

17 if (value > max) 

18 max = value; 

19 } 
20 

21 return max; 

22 } 



23 } 

The program in Listing 21.6 has a compile error in line 8 because intStack is not an 
instance of GenericStack<Number>. So you cannot invoke max(intStack). 

The fact is that Integer is a subtype of Number, but GenericStack<Integer> is not a 
subtype of GenericStack<Number>. To circumvent this problem, use wildcard generic 
types. A wildcard generic type has three forms — ?, ? extends T, or ? super T, where T is a 
generic type. 

The first form, ?, called an unbounded wildcard, is the same as ? extends Object. The unbounded wildcard 
second form, ? extends T, called a bounded wildcard, represents T or an unknown subtype bounded wildcard 
of T. The third form, ? super T, called a lower-bound wildcard, denotes T or an unknown lower bound wildcard 
supertype of T. 

You can fix the error by replacing line 12 in Listing 21.6 as follows: 

public static double max(Generi cStack<? extends Number> stack) { 

<? extends Number> is a wildcard type that represents Number or a subtype of Number. So 
it is legal to invoke max(new GenericStack<Integer>()) or max(new Generic- 
Stack<Doubl e>()). 

Listing 21.7 shows an example of using the ? wildcard in the print method that prints 
objects in a stack and empties the stack. <?> is a wildcard that represents any object type. It is 
equivalent to <? Extends Object>. What happens if you replace GenericStack<?> by 
GenericStack<Object>? It would be wrong to invoke print(intStack), because 
instack is not an instance of GenericStack<Object>. Please note that Generi cStack- 
<Integer> is not a subtype of GenericStack<Object>, although Integer is a subtype of 
Object. 

Listing 21.7 WildCardDemo2. java 

1 public class Wi 1 dCardDemo2 { 



2 public static void main(String[] args ) { 

3 Generi cStack<Integer> intStack = new Generi cStack<Integer>() ; GenericStack<Integer> 

4 i ntStack. push(l) ; // 1 is autoboxed into new Integer(l) type 

5 intStack. push(2) ; 

6 intStack. push(-2) ; 
7 

8 print(intStack) ; 

9 } 
10 

11 /** Prints objects and empties the stack */ 

12 public static void pri nt(Generi cStack<?> stack) { wildcardtype 

13 while (Istack.isEmptyO) { 

14 System. out . pri nt(stack. pop() + " ") ; 

15 } 

16 } 



17 } 
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why<? Super T> When is the wildcard <? super T> needed? Consider the example in Listing 21.8. The 

example creates a stack of strings in stackl (line 3) and a stack of objects in stack2 
(line 4) and invokes add(stackl , stack2) (line 8) to add the strings in stackl into 
stack2. GenericStack<? super T> is used to declare stack2 in line 13. If <? super 
T> is replaced by <T>, a compile error will occur on add(stackl , stack2) in line 8, 
because stackl's type is GenericStack<Stri ng> and stack2's type is 
Generi cStack<Object>. <? super T> represents type T or a supertype of T. Object is 
a supertype of Str i ng. 

Listing 21.8 WildCardDemo3. java 

1 public class Wi 1 dCardDemo3 { 

2 public static void main(String[] args) { 

3 Generi cStack<Stri ng> stackl = new Generi cStack<Stri ng>() ; 

4 Generi cStack<Object> stack2 = new Generi cStack<0bject>() ; 

5 stack2.push("Java") ; 

6 stack2 . push(2) ; 

7 stackl. push("Sun"); 

8 add(stackl, stack2) ; 

9 Wi 1 dCardDemo2 . pri nt(stack2) ; 
10 } 
11 

12 public static <T> void add (Generi cStack<T> stackl, 

13 Generi cStack<? super T> stack2) { 

14 while (Istackl.isEmptyO) 

15 stack2 . push(stackl. pop()) ; 

15 } 

16 } 

The inheritance relationship involving generic types and wildcard types is summarized in 
Figure 21.6. In this figure, A and B represent classes or interfaces, and E is a generic type 
parameter. 




E's subclass ? extends E A<B's subclass> A<B> A<B's subclass> 



Figure 2 1.6 The relationship between generic types and wildcard types. 



Generi cStack<Integer> 

type 



<? Super T> type 



21.7 Erasure and Restrictions on Generics 

type erasure Generics are implemented using an approach called type erasure. The compiler uses the 

generic type information to compile the code, but erases it afterward. So the generic informa- 
tion is not available at runtime. This approach enables the generic code to be backward com- 
patible with the legacy code that uses raw types. 

The generics are present at compile time. Once the compiler confirms that a generic type is 

erase generics used safely, it converts it to a raw type. For example, the compiler checks whether generics is 
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used correctly for the following code in (a) and translates it into the equivalent code in (b) for 
runtime use. The code in (b) uses the raw type. 



ArrayLi st<Stri ng> list = new ArrayLi st<Stri ng> () ; 
list, add ("Oklahoma") ; 
String state = list.get(O); 



(a) 



ArrayLi st list = new ArrayLi st(); 

list, add ("Oklahoma") ; 

String state = (String)(list.get(0)) ; 



(b) 



When generic classes, interfaces, and methods are compiled, the compiler replaces the 
generic type with the Object type. For example, the compiler would convert the following 
method in (a) into (b). 



replace generic type 



public static <E> void print(E[] list) { 
for (int i =0; i < list. length; i++) 

System. out. print(list[i] + " ") ; 
System. out. println() ; 

} 



(a) 



public static Object void pri nt(0bject [] list) { 
for (int i =0; i < list. length; i++) 

System. out. print(list[i] + " ") ; 
System. out. pri ntln() ; 

} 



(b) 



If a generic type is bounded, the compiler replaces it with the bounded type. For example, the 
compiler would convert the following method in (a) into (b). 



replace bounded type 



public static <E extends Ceometri cObject> 
boolean equal Area( 
E objectl, 
E object2) { 
return objectl. getArea() == 
object2 .getArea() ; 

} 



public static Ceometri cObject 
boolean equal Area( 

Ceometri cObject objectl, 
Ceometri cObject object2) { 
return objectl. getArea() == 
object2 . getArea() ; 

} 



(a) 



<b) 



It is important to note that a generic class is shared by all its instances regardless of its actual 
concrete type. Suppose 1 istl and 1 ist2 are created as follows: 



ArrayLi st<Stri ng> listl = 
ArrayLi st<Integer> list2 



new ArrayLi st<Stri ng>() ; 
= new ArrayLi st<Integer>() ; 



important fact 



Although ArrayLi st<String> and ArrayLi st<Integer> are two types at compile time, 
only one ArrayLi st class is loaded into the JVM at runtime. 1 istl and 1 ist2 are both 
instances of ArrayLi st. So the following statements display true: 



System. out. pri ntl n(l i stl instanceof ArrayList); 
System. out. pri ntl n(l i st2 instanceof ArrayList); 



But the expression listl i nstanceof ArrayLi st<Stri ng> is wrong. Since ArrayLi st- 
<String> is not stored as a separate class in the JVM, using it at runtime makes no sense. 

Because generic types are erased at runtime, there are certain restrictions on how generic 
types can be used. Here are some of the restrictions: 

Restriction 1: Cannot Use new E() 

You cannot create an instance using a generic type parameter. For example, the following 
statement is wrong: 



E object = new E() ; 



no new E() 



Generics 

The reason is that new E() is executed at runtime, but the generic type E is not available at 
runtime. 

Restriction 2: Cannot Use new E[J 

You cannot create an array using a generic type parameter. For example, the following 
statement is wrong: 

E[] elements = new E [capacity]; 

You can circumvent this limitation by creating an array of the Object type and then cast- 
ing it to E[] , as follows: 

E[] elements = (E[])new Object [capacity] ; 

unavoidable compile warning However, casting to (E[]) causes an unchecked compile warning. The warning occurs 

because the compiler is not certain that casting will succeed at runtime. For example, if E 
is String and new Object □ is an array of Integer objects, (String []) (new 
Object[]) will cause a ClassCastException. This type of compile warning is the 
limitation of Java generics and is unavoidable. 

Generic array creation using a generic class is not allowed, either. For example, the fol- 
lowing code is wrong: 

ArrayLi st<Stri ng> [] list = new ArrayLi st<Stri ng> [10] ; 

You can use the following code to circumvent this restriction: 

ArrayLi st<Stri ng> [] list = (ArrayList<String>[])new 
ArrayLi st [10] ; 

You will get a compile warning. 

Restriction 3: A Generic Type Parameter of a Class Is Not Allowed in a Static Context 

Since all instances of a generic class have the same runtime class, the static variables and 
methods of a generic class are shared by all its instances. Therefore, it is illegal to refer to 
a generic type parameter for a class in a static method, field, or initializer. For example, 
the following code is illegal: 

public class Test<E> { 

public static void m(E ol) { // Illegal 
} 

public static E ol; // Illegal 

static { 

E o2; // Illegal 

} 

} 

Restriction 4: Exception Classes Cannot be Generic 

A generic class may not extend java.lang.Throwable, so the following class declara- 
tion would be illegal: 

public class MyException<T> extends Exception { 
} 



718 Chapter 2 1 



no new E [capacity] 
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Why? If it were allowed, you would have a catch clause for MyException<T> as follows: 
try { 
} 

catch (MyException<T> ex) { 
} 



The JVM has to check the exception thrown from the try clause to see if it matches the 
type specified in a catch clause. This is impossible, because the type information is not 
present at runtime. 



21.8 Case Study: Generic Matrix Class 

This section presents a case study on designing classes for matrix operations using generic 
types. The addition and multiplication operations for all matrices are similar except that their 
element types differ. Therefore, you can design a superclass that describes the common oper- 
ations shared by matrices of all types regardless of their element types, and you can create 
subclasses tailored to specific types of matrices. This case study gives implementations for 
two types: i nt and Rational . For the i nt type, the wrapper class Integer should be used 
to wrap an i nt value into an object, so that the object is passed in the methods for operations. 

The class diagram is shown in Figure 21.7. The methods addMatrix and mul tipl yMatrix 
add and multiply two matrices of a generic type E [] [] . The static method pri ntResul t dis- 
plays the matrices, the operations, and their result. The methods add, multiply, and zero 
are abstract, because their implementations depend on the specific type of the array elements. 
For example, the zero() method returns for the Integer type and 0/1 for the Rational 
type. These methods will be implemented in the subclasses in which the matrix element type 
is specified. 



GenericMatrix<E extends Number> 



#add(elementl:E, element2:E): E 
#multi ply (el ementi: E, element2: E) : E 
#zero(): E 

+addMatrix(matrixl: E[] [] , matrix2: E[][]): E[][] 
+multip1yMatrix(matn'xl: E[][], matrix2: E[][]): E[][] 
+ pri ntResul t (ml: Number[][], m2: Number[][], 
m3: Number[][], op: char): void 



IntegerMatrix | 



- Rational Matrix | 



Figure 21.7 The GenericMatrix class is an abstract superclass for IntegerMatrix and 
Rational Matrix. 



IntegerMatrix and Rational Matrix are concrete subclasses of GenericMatrix. 

These two classes implement the add, multiply, and zero methods defined in the 
GenericMatrix class. 

Listing 21.9 implements the GenericMatrix class. <E extends Number> in line 3 spec- 
ifies that the generic type is a subtype of Number. Three abstract methods add, mul ti pi y, and 
zero are defined in lines 3, 6, and 9. These methods are abstract because we cannot implement 
them without knowing the exact type of the elements. The addMaxtrix (lines 12-30) and 
mul tipl yMatrix (lines 33-57) methods implement the methods for adding and multiplying 
two matrices. All these methods must be nonstatic, because they use generic type E for the class. 
The pri ntResul t method (lines 59-84) is static because it is not tied to specific instances. 
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bounded generic type 
abstract method 

abstract method 

abstract method 

add two matrices 



multiply two matrices 



The matrix element type is generic. This enables you to use an object of any class as long 
as you can implement the abstract add, mul tipl y, and zero methods in subclasses. 

The addMatrix and mul tipl yMatrix methods (lines 12-57) are concrete methods. 
They are ready to use as long as the add, mul tipl y, and zero methods are implemented in 
the subclasses. 

The addMatrix and mul tipl yMatrix methods check the bounds of the matrices before 
performing operations. If the two matrices have incompatible bounds, the program throws an 
exception (lines 16, 36). 

Listing 21.9 GenericMatrix. java 



i 

2 
3 
4 
5 
6 
7 
8 
9 
10 
11 
12 
13 
14 
15 
16 
17 
18 
19 
20 
21 
22 
23 
24 
25 
26 
27 
28 
29 
30 
31 
32 
33 
34 
35 
36 
37 
38 
39 
40 
41 
42 
43 
44 
45 
46 
47 
48 



public abstract class GenericMatrix<E extends Number> { 

/** Abstract method for adding two elements of the matrices */ 
protected abstract E add(E ol, E o2) ; 



/** Abstract method for multiplying two elements 
protected abstract E multiply(E ol, E o2) ; 



of the matrices */ 



/** Abstract method for defining 
protected abstract E zeroQ; 



zero for the matrix element */ 



/** Add two matrices */ 

public E[][] addMatrix(E[] [] matrixl, E[][] matrix2) { 
// Check bounds of the two matrices 
if ((matrixl. length != matrix2 .length) || 

(matri xl[0] . 1 ength != matrix2 .length)) { 
throw new Runti meExcepti on( 

"The matrices do not have the same size"); 

} 

E[] [] result = 

(E[] [])new Number[matrixl. length] [matri xl[0] .length] 

// Perform addition 

for (int i = 0; i < resul t . 1 ength ; i++) 

for (int j = 0; j < result[i] .length; j++) { 

resul t [i ] [j] = add(matrixl[i ] [j] , matrix2 [i] [j]) ; 

} 



return result; 



} 



/** Multiply two matrices */ 
public E[][] multiplyMatrix(E[] [] matrixl, 

// Check bounds 

if (matrixl[0] .length != matrix2 . 1 ength) 
throw new Runti meExcepti on( 

"The matrices do not have compatible size 

} 



E[][] matrix2) { 
{ 

); 



// Create result matrix 
E[] [] result = 

(E[] [])new Number [matrixl. length] [matri x2 [0] .length] 

// Perform multiplication of two matrices 
for (int i = 0; i < resul t . 1 ength ; i++) { 
for (int j = 0; j < resul t[0] .length; j++) { 
resul t [i ] [j] = zeroQ; 
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49 for (int k = 0; k < matrixl[0] .length; k++) { 

50 result[i] [j] = add(result[i] [j] , 

51 multiply(matrixl[i] [k] , matrix2 [k] [j])) ; 

52 } 

53 } 

54 } 
55 

56 return result; 

57 } 
58 

59 /** Print matrices, the operator, and their operation result */ 

60 public static void printResult( display result 

61 Number[][] ml, Number[][] m2, Number[][] m3, char op) { 

62 for (int i = 0; i < ml. length; i++) { 

63 for (int j = 0; j < ml[0] .length; j++) 

64 System. out. print(" " + ml[i][j]); 
65 

66 if (i == ml. length / 2) 

67 System. out. print( " " + op + " " ); 

68 else 

69 System. out. print( " " ); 
70 

71 for (int j = 0; j < m2. length; 

72 System. out. print(" " + m2[i][j]); 
73 

74 if (i == ml. length / 2) 

75 System. out. print( " = " ); 

76 else 

77 System. out. print( " " ); 
78 

79 for (int j = 0; j < m3. length; 

80 System. out. print(m3[i] [j] + " ") ; 
81 

82 System. out . pri ntl n() ; 

83 } 

84 } 



85 } 

Listing 21.10 implements the IntegerMatrix class. The class extends GenericMatrix- 
<Integer> in line 1. After the generic instantiation, the add method in GenericMatrix- 
<Integer> is now Integer add (Integer ol, Integer o2). The add, multiply and 
zero methods are implemented for Integer objects. These methods are still protected, 
because they are invoked only by the addMatrix and mul tipl yMatrix methods. 

Listing 21.10 IntegerMatrix. java 

1 public class IntegerMatrix extends CenericMatrix<Integer> { 

2 /** Implement the add method for adding two matrix elements */ 

3 protected Integer add(Integer ol, Integer o2) { 

4 return ol + o2; 

5 } 
6 

7 /** Implement the multiply method for multiplying two 

8 matrix elements */ 

9 protected Integer mul ti pi y(Integer ol, Integer o2) { 

10 return ol * o2; 

11 } 
12 



extends generic type 
implement add 

implement multiply 
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implement zero 



extends generic type 
implement add 



implement multiply 



implement zero 



create matrices 



create IntegerMatrix 



add two matrices 



multiply two matrices 



13 
14 
15 
16 

17 } 



/** Implement the zero method to specify zero for Integer */ 
protected Integer zero() { 
return 0; 

} 



Listing 21.11 implements the RationalMatrix class. The Rational class was introduced 
in §14.13, "Case Study: The Rational Class." Rational is a subtype of Number. The 
RationalMatrix class extends GenericMatrix<Rational> in line 1. After the generic 
instantiation, the add method in GenericMatrix<Rational > is now Rational 
add(Rational ol, Rational o2). The add, mul ti ply, and zero methods are imple- 
mented for Rational objects. These methods are still protected, because they are invoked 
only by the addMatrix and mul tipl yMatrix methods. 

Listing 2 1. 1 1 RationalMatrix. java 



1 

2 

3 

4 

5 

6 

7 

8 

9 
10 
11 
12 
13 
14 
15 
16 
17 } 



public class RationalMatrix extends CenericMatrix<Rational> { 

/** Implement the add method for adding two rational elements */ 
protected Rational add (Rational rl, Rational r2) { 
return rl.add(r2); 

} 

/** Implement the multiply method for multiplying 

two rational elements */ 
protected Rational multiply(Rational rl, Rational r2) { 
return rl. mul ti pi y(r2) ; 

} 

/** Implement the zero method to specify zero for Rational */ 
protected Rational zero() { 
return new Rational (0, 1) ; 

} 



Listing 21.12 gives a program that creates two Integer matrices (lines 4-5) and an 
IntegerMatrix object (line 8), and adds and multiplies two matrices in lines 12 and 16. 

Listing 21.12 TestlntegerMatrix. java 



1 

2 
3 
4 
5 
6 
7 
8 
9 
10 
11 
12 
13 
14 
15 
16 
17 
18 



public class TestlntegerMatrix { 

public static void main(String[] args) 

// Create Integer arrays ml, m2 
Integer[][] ml = new Integer[] [] {{1, 
Integer[][] m2 = new Integer [][] {{1 , 



3}, 
1}, 



{4, 
{2, 



6}, 
2}, 



{1, 
{0, 



l}}; 
0}}; 



// Create an instance of IntegerMatrix 
IntegerMatrix i ntegerMatri x = new IntegerMatrixO 

System. out. pri ntl n("\nml + m2 is ") ; 
Ceneri cMatri x . pri ntResul t ( 

ml, m2 , integerMatrix.addMatrix(ml, m2) , '+'); 



System. out. pri ntl n("\nml * m2 is ") ; 
Ceneri cMatri x . pri ntResul t( 

ml, m2 , integerMatrix.multiplyMatrix(ml, 



m2), '*'); 
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21.13 


gives 
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pr°5 


;ram that 


creates two Rational matrices (lines 4-10) and a 



Rational Matrix object (line 13) and adds and multiplies two matrices in lines 17 and 21. 

Listing 21.13 Test Rat i onal Mat r i x . j ava 

1 public class TestRati onal Matrix { 



2 public static void main(String[] args) { 

3 // Create two Rational arrays ml and m2 

4 Rational [][] ml = new Rati onal [3] [3] ; create matrices 

5 Rational [][] m2 = new Rati onal [3] [3] ; 

6 for (int i = 0; i < ml. length; i++) 

7 for (int j = 0; j < ml [0] .length; { 

8 ml[i][j] = new Rati onal (i + 1, j + 5); create Rational Matrix 

9 m2[i][j] = new Rati onal (i + 1, j + 6); 
10 } 

11 

12 // Create an instance of Rati onal Matrix add two matrices 

13 RationalMatrix rationalMatrix = new RationalMatrixO ; 
14 

15 System. out. pri ntl n("\nml + m2 is ") ; 

16 CenericMatrix.printResult( multiply two matrices 

17 ml, m2, rationalMatrix. addMatri x(ml , m2) , ' + '); 
18 

19 System. out. pri ntl n("\nml * m2 is ") ; 

20 CenericMatrix.printResult( 

21 ml, m2 , rationalMatrix. multiplyMatrix(ml, m2) , '*'); 

22 } 



23 } 



ml + m2 is 










1/5 1/6 1/7 


1/6 


1/7 


1/8 


11/30 13/42 15/56 


2/5 1/3 2/7 + 


1/3 


2/7 


1/4 = 


= 11/15 13/21 15/28 


3/5 1/2 3/7 


1/2 


3/7 


3/8 


11/10 13/14 45/56 


ml * m2 is 










1/5 1/6 1/7 


1/6 


1/7 


1/8 


101/630 101/735 101/840 


2/5 1/3 2/7 * 


1/3 


2/7 


1/4 = 


= 101/315 202/735 101/420 


3/5 1/2 3/7 


1/2 


3/7 


3/8 


101/210 101/245 101/280 


Key Terms 



actual concrete type 708 unbounded wildcard (<?>) 715 

bounded generic type 712 bounded wildcard (<? 
formal generic type 708 extends E>) 715 

generic instantiation 708 lower bound wildcard 
raw type 713 (<? super E>) 715 
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Chapter Summary 



1 . Generics is the capability to parameterize types. With it you can define a class or a 
method with generic types that can be replaced with concrete types by the compiler. 

2. The key benefit of generics is to enable errors to be detected at compile time rather 
than at runtime. 

3. A generic class or method permits you to specify allowable types of objects that the 
class or method may work with. If you attempt to use the class or method with an 
incompatible object, the compiler can detect the errors. 

4- A generic type defined in a class, interface, or a static method is called a formal 
generic type, which can be replaced later with an actual concrete type. Replacing a 
generic type is called a generic instantiation. 

5. A generic class such as ArrayList used without a type parameter is called a raw 
type. Use of raw type is allowed for backward compatibility with the earlier versions 
of Java. 

6. A wildcard generic type has three forms: ?, ? extends T, or ? super T, where T is 
a generic type. The first form, ?, called an unbounded wildcard, is the same as ? 
extends Object. The second form, ? extends T, called a bounded wildcard, rep- 
resents T or an unknown subtype of T. The third form, ? super T, called a lower 
bound wildcard, denotes T or an unknown supertype of T. 

7. Generics are implemented using an approach called type erasure. The compiler uses 
the generic type information to compile the code but erases it afterward. So the 
generic information is not available at runtime. This approach enables the generic 
code to be backward compatible with the legacy code that uses raw types. 

8. You cannot create an instance using a generic type parameter. 

9. You cannot create an array using a generic type parameter. 

1 0. You cannot use a generic type parameter of a class in a static context. 
I I . Generic type parameters cannot be used in exception classes. 



Review Questions 



Sections 2 1.2-2 1.4 






21.1 Are there any compile errors in (a) and (b)? 


ArrayList dates = new ArrayListO; 
dates . add (new DateO); 
dates . add(new StringO); 




ArrayLi st<Date> dates = 
new ArrayLi st<Date>() ; 
dates, add (new DateO); 
dates. add(new StringO); 




(a) 




(b) 


21.2 What is wrong in (a)? Is the code in (b) correct? 


ArrayList dates = new ArrayListO; 
dates .add (new DateO); 
Date date = dates . get(0) ; 




ArrayLi st<Date> dates = 
new ArrayLi st<Date>() ; 
dates .add (new DateO); 
Date date = dates . get (0) ; 




(a) 




(b) 
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21.3 What are the benefits of using generic types? 

21.4 Write the generic declaration for j ava . 1 ang . Compa rabl e. 

2 1.5 Since you create an instance of ArrayList of strings using new ArrayLi st- 
<String>(), should the constructor in the ArrayList class be defined as 

public ArrayLi st<E>() 
21.6 Can a generic class have multiple generic parameters? 

2 1 .7 How do you define a generic type in a class? How do you define a generic type in 
a method? 

21.8 What is a bounded generic type? 
Sections 21.5-21.6 

2 1.9 What is a raw type? Is GenericStack the same as GenericStack<Object>? 

21.10 What are an unbounded wildcard, a bounded wildcard, and a lower bounded wild- 
card? 

21.11 What happens if lines 12-13 in Listing 21.8 are changed to 

public static <T> void add(Generi cStack<T> stackl, 
Generi cStack<T> stack2) 

21.12 What happens if lines 1 2- 1 3 in Listing 2 1 . 8 are changed to 

public static <T> void add(Generi cStack<? extends T> stackl, 
Generi cStack<T> stack2) 

Section 21.7 

21.13 What is erasure? Why is Java generics implemented using erasure? 

21.14 If your program uses Arrayl_ist<String> and ArrayLi st<Date>, does the 
JVM load both of them? 

21.15 Can you create an instance using new E() for a generic type E? Why? 

21.16 Can a method that uses a generic class parameter be static? Why? 

21.17 Can you define a custom generic exception class? Why? 

Programming Exercises 

21.1 (Revising Listing 21.1) Revise the GenericStack class in Listing 21.1 to imple- 
ment it using an array rather than an ArrayLi st. You should check the array size 
before adding a new element to the stack. If the array is full, create a new array 
that doubles the current array size and copy the elements from the current array to 
the new array. 

2 1 .2 {Generic binary search) Implement the following method using binary search. 

public static <E extends Comparabl e<E» 
int bi narySearch(E[] list, E key) 

21.3 {Generic selection sort) Implement the following method using selection sort. 

public static <E extends Comparabl e<E» 
void selectionSort(E[] list) 
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21.4 

21.5 



(Generic insertion sort) Implement the following method using insertion sort. 

publ ic static <E extends Comparabl e<E» 
void insertionSort(E[] list) 

(Maximum element in an array) Implement the following method that returns the 
maximum element in an array. 

public static <E extends Comparabl e<E» E max(E[] list) 

(Maximum element in a two-dimensional array) Write a generic method that 
returns the maximum element in a two-dimensional array. 

public static <E extends Comparabl e<E» E max(E[][] list) 



Chapter 22 



Java Collections Framework 



Objectives 



To describe the Java Collections Framework hierarchy (§§22.1-22.2). 

To use the common methods defined in the Col 1 ection interface for operating sets and 
lists (§22.3). 

To use the Iterator interface to traverse a collection (§22.4). 

To use the for-each loop to simplify traversing a collection (§22.4). 

To explore how and when to use HashSet (§22.4.1), 
LinkedHashSet (§22.4.2), orTreeSet (§22.4.3) 
to store elements. 

To compare elements using the Comparabl e interface 
and the Comparator interface (§22.5). 

To explore how and when to use Ar rayLi st or 
LinkedList to store elements (§22.6). 

To use the static utility methods in the Col 1 ection s 
class for sorting, searching, shuffling lists, and finding 
the largest and smallest element in collections (§22.7). 

To compare performance of sets and lists (§22.8). 

To distinguish between Vector and Ar rayLi st and to 
use the Stack class for creating stacks (§22.9). 

To explore the relationships among Col 1 ection,Queue, 
LinkedList, and PriorityQueue and to create 
priority queues using the PriorityQueue class (§22.10). 

To tell the differences between Col 1 ection and Map 
and describe when and how to use HashMap, 
LinkedHashMap,and TreeMap to store values 
associated with keys (§22.11). 

To obtain singleton sets, lists, and maps, 
and unmodifiable sets, lists, and maps, using 
the static methods in the Collections class (§22.12). 
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22.1 Introduction 

data structure A data structure is a collection of data organized in some fashion. The structure not only 

stores data but also supports operations for accessing and manipulating the data. You have 
learned Ar rayLi st, which is a data structure to store elements in a list. Java provides several 
more data structures that can be used to organize and manipulate data efficiently. These data 
structures are commonly known as Java Collections Framework. 

container In object-oriented thinking, a data structure, also known as a container, is an object that 

stores other objects, referred to as data or elements. Some people refer to data structures as 
container objects. To define a data structure is essentially to define a class. The class for a data 
structure should use data fields to store data and provide methods to support such operations 
as search, insertion, and deletion. To create a data structure is therefore to create an instance 
from the class. You can then apply the methods on the instance to manipulate the data struc- 
ture, such as inserting an element into or deleting an element from the data structure. 
The Java Collections Framework supports two types of containers: 

collection ■ One for storing a collection of elements, simply called a collection. 

map ■ The other for storing key /value pairs, called a map. 

Maps are efficient data structures for fast searching an element using a key. We will introduce 
maps later in this chapter. Now we turn our attention to collections. 



set 
list 

queue 



22.2 Collections 

The Java Collections Framework supports three major types of collections: Set, List, and 
Queue. An instance of Set stores a group of nonduplicate elements. An instance of Li st 
stores an ordered collection of elements. An instance of Queue stores objects that are 
processed in first-in, first-out fashion. The common features of these collections are defined in 
the interfaces, and implementations are provided in concrete classes, as shown in Figure 22. 1 . 

|j| Note 

All the interfaces and classes defined in the Java Collections Framework are grouped in the 
java.util package. 



NavigableSet [ ^-i- 

I 

J i 



r- SortedSet 



Collection 



Set 



<r 



■ AbstractColl ecti on 



AbstractSet 



<r 



!-- List Id- 4 L .AbstractUst}A- 

AbstractSequenti al Li st | fl 

j-- Deque \ Qi 

Queue [ ^— ■ AbstractQueue | (| 



Zl TreeSet 



■ HashSet | ^— Li nkedHashSet | 

■ Vector | ^— Stack | 

■ ArrayList | 

■ Li nkedLi st I 



■ Priori tyQueue | 



Interfaces 



Abstract Classes 



Concrete Classes 



Figure 22.1 A collection is a container that stores objects. 
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IP Design Guide 

The design of the Java Collections Framework is an excellent example of using interfaces, abstract 
classes, and concrete classes. The interfaces define the framework. The abstract classes provide 
partial implementation for convenience. The concrete classes implement the interfaces with con- 
crete data structures. 

|§l| Note 

All the concrete classes in the Java Collections Framework implement the java.lang. Cloneable Cloneable 
and java.io. Serial izable interfaces. Thus their instances can be cloned and serialized. Serial izable 



22.3 The Collection Interface and the 
AbstractCol lection Class 

The Collection interface is the root interface for manipulating a collection of objects. Its 
public methods are listed in Figure 22.2. The AbstractColl ection class is a convenience 
class that provides partial implementation for the Collection interface. It implements all 
the methods in Collection except the size and iterator methods. These are imple- 
mented in appropriate subclasses. 

The Col 1 ection interface provides the basic operations for adding and removing elements basic operations 
in a collection. The add method adds an element to the collection. The addAl 1 method adds 
all the elements in the specified collection to this collection. The remove method removes an 
element from the collection. The removeAl 1 method removes the elements from this collec- 
tion that are present in the specified collection. The retai nAl 1 method retains the elements in 



«interface» 




java. util. Collection<E> 




+add(o: E) : boolean 




+addAll (c: Collect! on<? extends 


E>) : boolean 


+clear(): void 




+contains(o: Object): boolean 




+containsAll (c: Coll ecti on<?>) : 


boolean 


+equals(o: Object): boolean 




+hashCode() : int 




+ i sEmptyO : boolean 




+ iterator() : Iterator<E> 




+remove(o: Object): boolean 




+removeAll (c: Col 1 ecti on<?>) : boolean 


+retainAll (c: Col 1 ecti on<?>) : boolean 


+size(): int 




+ toArray() : Object [] 





Adds a new element o to this collection. 

Adds all the elements in the collection c to this collection. 

Removes all the elements from this collection. 

Returns true if this collection contains the element o. 

Returns true if this collection contains all the elements in c. 

Returns true if this collection is equal to another collection o. 

Returns the hash code for this collection. 

Returns true if this collection contains no elements. 

Returns an iterator for the elements in this collection. 

Removes the element o from this collection. 

Removes all the elements in c from this collection. 

Retains the elements that are both in c and in this collection. 

Returns the number of elements in this collection. 

Returns an array of Ob j ect for the elements in this collection. 





«interface» 




java. util.Iterator<E> 


+hasNext() . 


boolean 


+next(): E 




+ remove () : 


void 



Returns true if this iterator has more elements to traverse. 

Returns the next element from this iterator. 

Removes the last element obtained using the next method. 



Figure 22.2 The Col 1 ection interface contains the methods for manipulating the elements in a collection, and you 
can obtain an iterator object for traversing elements in the collection. 
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this collection that are also present in the specified collection. All these methods return 
bool ean. The return value is true if the collection is changed as a result of the method exe- 
cution. The cl ear () method simply removes all the elements from the collection. 

§ Note 

The methods addAll , removeAll, and retainAH are similar to the set union, difference, 
and intersection operations. 

The Collection interface provides various query operations. The size method returns 
the number of elements in the collection. The contains method checks whether the collec- 
tion contains the specified element. The contai nsAl 1 method checks whether the collection 
contains all the elements in the specified collection. The i sEmpty method returns true if the 
collection is empty. 

The Collection interface provides the toArrayO method that returns an array repre- 
sentation for the collection. 

A collection may be a set or a list. The Iterator interface provides a uniform way for tra- 
versing elements in various types of collections. The iterator method in the Collection 
interface returns an instance of the Iterator interface, as shown in Figure 22.2, which pro- 
vides sequential access to the elements in the collection using the next() method. You can 
also use the hasNextO method to check whether there are more elements in the iterator, and 
the remove () method to remove the last element returned by the iterator. 

f§| Design Note 

Some of the methods in the Collection interface cannot be implemented in the concrete subclass. 
Unsupported Operations In this case, the method would throw java.lang.UnsupportedOperationException, a 

subclass of RuntimeException. This is a good design that you can use in your project. If a method 
has no meaning in the subclass, you can implement it as follows: 

public void someMethodO { 

throw new UnsupportedOperati onExcepti on 
("Method not supported") ; 

} 

22.4 Sets 

The Set interface extends the Collection interface. It does not introduce new methods or 
no duplicates constants, but it stipulates that an instance of Set contains no duplicate elements. The con- 

crete classes that implement Set must ensure that no duplicate elements can be added to the 
set. That is, no two elements el and e2 can be in the set such that el . equal s(e2) is true. 

The AbstractSet class is a convenience class that extends AbstractCol 1 ection and 
implements Set. The AbstractSet class provides concrete implementations for the 
equal s method and the hashCode method. The hash code of a set is the sum of the hash 
codes of all the elements in the set. Since the size method and iterator method are not 
implemented in the AbstractSet class, AbstractSet is an abstract class. 

Three concrete classes of Set are HashSet, Li nkedHashSet, and TreeSet, as shown in 
Figure 22.3. 

22.41 HashSet 

The HashSet class is a concrete class that implements Set. You can create an empty hash set 
using its no-arg constructor or create a hash set from an existing collection. By default, the 
initial capacity is 16 and load factor is . 75. If you know the size of your set, you may spec- 
ify the initial capacity and load factor in the constructor. Otherwise, use the default setting. 
Load factor is a value between . and 1 . 0. 



set operations 
query operations 



iterator 
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«i nterf ace» 
java.uti 1 . Collection<E> 



«i nterf ace» 
java .util. Set<E> 



java.uti 7 .AbstractSet<E> 



"ST 



java.util.HashSet<E> 



+HashSet() 

+HashSet(c: Collection<? extends E>) 
+HashSet(i ni ti al Capaci ty : int) 

+HashSet(i ni ti al Capaci ty : int, "loadFactor: float) 



java.util.LinkedHashSet<E> 



+LinkedHashSetC) 

+Li nkedHashSet(c : Co"llection<? extends E>) 
+Li nkedHashSet (i ni tial Capaci ty : i nt) 

+Li nkedHashSet (i ni tialCapaci ty : int, loadFactor: float) 



«interface» 
java. util. SortedSet<E> 



+ first(): E 
+ last(): E 

+headSet(toElement: E) : SortedSet<E> 
+ tailSet(fromElement: E) : SortedSet<E> 



4- 



«interface» 
java. util.NavigableSet<E> 



+pollFirstO : E 
+pollLast() : E 
+ lower(e: E) : E 
+higher(e: E):E 
+ floor (e: E) : E 
+ceiling(e: E) : E 



_ 



java.util.TreeSet<E> 



+TreeSet() 

+TreeSet(c: Co"llection<? extends E>) 
+TreeSet(comparator : Comparator<? 

super E>) 
+TreeSet(s: SortedSet<E>) 



Figure 22.3 The Java Collections Framework provides three concrete set classes. 



Load factor measures how full the set is allowed to be before its capacity is increased, load factor 
When the number of elements exceeds the product of the capacity and load factor, the capac- 
ity is automatically doubled. For example, if the capacity is 16 and load factor is 0.75, the 
capacity will be doubled to 32 when the size reaches 12 ( 16 * 0.75 = 12). Higher load factor 
decreases the space costs but increases the search time. Generally, the default load factor 
0. 75 is a good trade-off between time and space costs. 

A HashSet can be used to store duplicate-free elements. For efficiency, objects added to a 
hash set need to implement the hashCode method in a manner that properly disperses the hashCodeO 
hash code. Recall that hashCode is defined in the Object class. The hash codes of two 
objects must be the same if the two objects are equal. Two unequal objects may have the same 
hash code, but you should implement the hashCode method to avoid too many such cases. 
Most of the classes in the Java API implement the hashCode method. For example, the 
hashCode in the Integer class returns its int value. The hashCode in the Character 
class returns the Unicode of the character. The hashCode in the String class returns 
iS . * 31 («-i) + Sl *3i("-2) + ... + Sn _ u where^is s.charAt(i). 
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Listing 22.1 gives a program that creates a hash set to store strings and uses an iterator to 
traverse the elements in the set. 



Listing 22.1 TestHashSet. java 



create set 



add element 



get iterator 



traverse iterator 



1 
2 
3 
4 
5 
6 
7 
8 
9 
10 
11 
12 
13 
14 
15 
16 
17 
18 
19 
20 
21 
22 
23 
24 
25 
26 



import java.util.""; 

public class TestHashSet { 

public static void main(String[] args) { 

// Create a hash set 

Set<String> set = new HashSet<Stri ng>() ; 

// Add strings to the set 
set. add ("London") ; 
set.add("Paris") ; 
set.add("New York") ; 
set.add("San Francisco"); 
set.add("Beijing") ; 
set.add("New York") ; 



System . out . pri ntl n(set ) ; 

// Obtain an iterator for 
Iterator<Stri ng> iterator 



the hash set 

= set.iteratorQ ; 



// Display the elements in the hash set 
while (iterator . hasNext() ) { 

System. out. print(iterator.next() . toUpperCase() + 

} 



); 



[San Francisco, New York, Paris, Beijing, London] 
SAN FRANCISCO NEW YORK PARIS BEIJING LONDON 



The strings are added to the set (lines 9-14). "New York" is added to the set more than once, 
but only one is stored, because a set does not allow duplicates. 

As shown in the output, the strings are not stored in the order in which they are inserted 
into the set. There is no particular order for the elements in a hash set. To impose an order on 
them, you need to use the LinkedHashSet class, which is introduced in the next section. 



for-each loop 



create a set 



Tip 

You can simplify the code in lines 1 8-24 using a for-each loop without using an iterator, as follows: 

for (Object element: set) 
System. out. pri nt(element) ; 

This loop is read as "for each element in the set, do the following." The for-each loop can be used 
for arrays (see §6.2.7) as well as any instance of Collection. 

Since a set is an instance of Col 1 ection, all methods defined in Col 1 ection can be used 
for sets. Listing 22.2 gives an example that explores the methods in the Col 1 ection interface. 

Listing 22.2 TestMethodsInCol lection, java 

1 public class TestMethodsInCollection { 

2 public static void main(String[] args) { 

3 // Create setl 

4 java.util .Set<String> setl = new java . uti 1 . HashSet<Stri ng>() ; 



22.4 Sets 733 



5 

6 

7 

8 

9 
10 
11 
12 
13 
14 
15 
16 
17 
18 
19 
20 
21 
22 
23 
24 
25 
26 
27 
28 
29 
30 
31 
32 
33 
34 
35 
36 
37 
38 
39 
40 
41 
42 
43 
44 
45 

46 } 



// Add strings to setl 
setl. add ("London") ; 
setl.add("Paris") ; 
setl.add("New York") ; 
setl. add("San Francisco"); 
setl.add("Beijing") ; 

System. out. println("setl is " + setl); 

System. out. println(setl.size() + " elements in setl"); 

// Delete a string from setl 
setl. remove("London") ; 

System. out. pri ntl n("\nsetl is " + setl); 

System. out. println(setl.size() + " elements in setl"); 

// Create set2 

java.util .Set<String> set2 = new java . uti 1 . HashSet<Stri ng>() ; 

// Add strings to set2 
set2. add ("London") ; 
set2.add("Shanghai") ; 
set2.add("Paris") ; 

System. out. pri ntl n("\nset2 is " + set2) ; 

System . out . pri ntl n(set2 . si ze() + " elements in set2") ; 

System. out. pri ntl n("\nls Taipei in set2? " 
+ set2.contains("Taipei") ) ; 

setl.addAll (set2) ; 

System. out. println("\nAfter adding set2 to setl, setl is " 

+ setl); 

setl . removeAl 1 (set2) ; 

System. out. pri ntl n("After removing set2 from setl, setl is " 

+ setl); 

setl. retai nAl 1 (set2) ; 

System. out. println("After removing common elements in set2 " 
+ "from setl, setl is " + setl); 



add element 



get size 



remove element 



create a set 



add element 



contains element? 
addAll 

removeAl 1 
retai nAll 



setl is [San Francisco, New York, Paris, Beijing, London] 
5 elements in setl 

setl is [San Francisco, New York, Paris, Beijing] 
4 elements in setl 

set2 is [Shanghai, Paris, London] 
3 elements in set2 

Is Taipei in set2? false 

After adding set2 to setl, setl is 

[San Francisco, New York, Shanghai, Paris, Beijing, London] 

After removing set2 from setl, setl is 
[San Francisco, New York, Beijing] 

After removing common elements in set2 from setl, setl is [] 
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The program creates two sets (lines 4, 22). The size() method returns the number of the ele- 
ments in a set (line 14). Line 17 

setl. remove ("London") ; 

removes "New York" from setl. 

The contains method (line 32) checks whether an element is in the set. 
Line 34 

setl.addAll (set2) ; 

adds set2 to setl. So, setl becomes [San Francisco, New York, Shanghai, Paris, 
Beijing, London]. 

Line 38 

setl . removeAl 1 (set2) ; 

removes set2 from setl. So, setl becomes [San Francisco, New York, Beijing]. 

Line 42 

setl. retai nAl 1 (set2) ; 

retains the common elements in setl. Since setl and set2 have no common elements, 
setl becomes empty. 

22.42 LinkedHashSet 

LinkedHashSet extends HashSet with a linked-list implementation that supports an order- 
ing of the elements in the set. The elements in a HashSet are not ordered, but the elements in 
a LinkedHashSet can be retrieved in the order in which they were inserted into the set. A 
Li nkedHashSet can be created by using one of its four constructors, as shown in Figure 22.3. 
These constructors are similar to the constructors for HashSet. 

Listing 22.3 gives a test program for LinkedHashSet. The program simply replaces 
HashSet by LinkedHashSet in Listing 22.1. 

Listing 22.3 TestLi nkedHashSet. java 

1 import java.util ; 

2 

3 public class TestLi nkedHashSet { 

4 public static void main(String[] args) { 

5 // Create a hash set 

6 Set<String> set = new Li nkedHashSet<Stri ng>() ; 
7 

8 // Add strings to the set 

9 set.add("London") ; 

10 set.add("Paris") ; 

11 set.add("New York") ; 

12 set.add("San Francisco"); 

13 set.add("Bei jing") ; 

14 set. add ("New York") ; 
15 

16 System. out. println(set) ; 
17 

18 // Display the elements in the hash set 

19 for (Object element: set) 

20 System. out. pri nt(el ement . toStringO . toLowerCase() + " ") ; 

21 } 

22 } 



create linked hash set 



add element 



display elements 
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[London, Paris, New York, San Francisco, Beijing] 
london paris new york san francisco beijing 



A LinkedHashSet is created in line 6. As shown in the output, the strings are stored in the 
order in which they are inserted. Since LinkedHashSet is a set, it does not store duplicate 
elements. 

The LinkedHashSet maintains the order in which the elements are inserted. To impose a 
different order (e.g., increasing or decreasing order), you can use the TreeSet class intro- 
duced in the next section. 

# Tip 

[f you don't need to maintain the order in which the elements are inserted, use HashSet, which 
is more efficient than LinkedHashSet. 



22.4.3 TreeSet 

SortedSet is a subinterface of Set, which guarantees that the elements in the set are sorted. 
Additionally, it provides the methods first () and last() for returning the first and last 
elements in the set, and headSet(toEl ement) and tail Set (fromEl ement) for returning 
a portion of the set whose elements are less than toEl ement and greater than or equal to 
fromEl ement. 

NavigableSet extends SortedSet to provide navigation methods lower(e), 
floor(e), ceiling(e), and higher(e) that return elements respectively less than, less 
than or equal, greater than or equal, and greater than a given element and return nul 1 if there 
is no such element. The pol 1 Fi rst () and pol 1 Last () methods remove and return the first 
and last element in the tree set, respectively. 

TreeSet implements the SortedSet interface. To create a TreeSet, use a constructor, 
as shown in Figure 22.3. You can add objects into a tree set as long as they can be compared 
with each other. There are two ways to compare objects. 

■ Use the Comparable interface. Since the objects added to the set are instances of Comparable 
Comparable, they can be compared using the compareTo method. The 
Comparabl e interface was introduced in §14.5. Several classes in the Java API, such 

as String, Date, Calendar, and all the wrapper classes for the primitive types, 

implement the Comparable interface. This approach is referred to as natural order, natural order 

■ If the class for the elements does not implement the Comparabl e interface, or if you 
don't want to use the compareTo method in the class that implements the 
Comparable interface, specify a comparator for the elements in the set. This Comparator 
approach is referred to as order by comparator. It will be introduced in §22.5, "The order by comparator 
Comparator Interface." 

Listing 22.4 gives an example of ordering elements using the Comparabl e interface. The preced- 
ing example in Listing 22.3 displays all the strings in their insertion order. This example rewrites 
the preceding example to display the strings in alphabetical order using the TreeSet class. 



Listing 22.4 TestTreeSet . j ava 

1 import java.util ; 

2 

3 public class TestTreeSet { 

4 public static void main(String[] args) { 

5 // Create a hash set 

6 Set<String> set = new HashSet<Stri ng>() ; create hash set 
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create tree set 



display elements 



7 

8 

9 
10 
11 
12 
13 
14 
15 
16 
17 
18 
19 
20 
21 
22 
23 
24 
25 
26 
27 
28 
29 
30 
31 
32 
33 

34 } 



// Add strings to the set 
set. add ("London") ; 
set.add("Paris") ; 
set. add ("New York") ; 
set.add("San Francisco"); 
set.add("Beijing") ; 
set. add ("New York"); 

TreeSet<Stri ng> treeSet = new TreeSet<Stri ng>(set) ; 
System . out . pri ntl n("Sorted tree set: " + treeSet) ; 

// Use the methods in SortedSet interface 

System. out. pri ntl n("f i rst() : " + treeSet . fi rst()) ; 

System. out. pri ntl n("last() : " + treeSet. last()) ; 

System. out. pri ntl n("headSet() : " + treeSet. headSet("New York")) ; 

System. out. println("tailSet() : " + treeSet. tailSet("New York")) ; 

// Use the methods in NavigableSet interface 
System. out. pri ntl n("lower(\"P\") : " + treeSet. lower("P")) ; 
System. out. pri ntl n("higher(\"P\") : " + treeSet. higher("P")) ; 
System. out. println("floor(\"P\"): " + treeSet . fl oor("P")) ; 
System. out. pri ntl n("ceil ing(\"P\") : " + treeSet. cei 1 i ng("P")) ; 
System . out . pri ntl nC'poll Fi rst() : " + treeSet . pol 1 Fi rst()) ; 
System . out . pri ntl n("poll LastO : " + treeSet . pol 1 Last()) ; 
System . out . pri ntl n("New tree set: " + treeSet); 



Sorted tree set: [Beijing, London, New York, Paris, San Francisco] 

first(): Beijing 

last(): San Francisco 

headSet(): [Beijing, London] 

tailSet(): [New York, Paris, San Francisco] 

lower("P"): New York 

higher("P"): Paris 

floor("P"): New York 

ceiling("P") : Paris 

poll First (): Beijing 

pol 1 Last() : San Francisco 

New tree set: [London, New York, Paris] 



The example creates a hash set filled with strings, then creates a tree set for the same strings. The 
strings are sorted in the tree set using the compareTo method in the Comparabl e interface. 

The elements in the set are sorted once you create a TreeSet object from a HashSet 
object using new TreeSet(hashSet) (line 16). You may rewrite the program to create an 
instance of TreeSet using its no-arg constructor, and add the strings into the TreeSet 
object. Then, every time a string is added to the TreeSet object, the elements in it will be 
reordered. The approach used in the example is generally more efficient because it requires 
only a one-time sorting. 

treeSet. first () returns the first element in treeSet (line 20). treeSet. last() 
returns the last element in treeSet (line 21). treeSet . headSet("New York") returns the 
elements in treeSet before New York (line 22). treeSet . tailSetC'New York") returns 
the elements in treeSet after New York, including New York (line 23). 

treeSet. lower("P") returns the largest element less than "P" in treeSet (line 26). 
treeSet . higher("P") returns the smallest element greater than "P" in treeSet (line 27). 
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treeSet . floor("P") returns the largest element less than or equal to "P" in treeSet 
(line 28). treeSet. ceil ing("P") returns the smallest element greater than or equal to "P" 
in treeSet (line 29). treeSet. poll FirstO removes the first element in treeSet and 
returns the removed element (line 30). treeSet. poll LastO removes the last element in 
treeSet and returns the removed element (line 31). 

|fil Note 

All the concrete classes in Java Collections Framework (see Figure 22.1 ) have at least two constructors. 
One is the no-arg constructor that constructs an empty collection. The other constructs instances from 
a collection. Thus the TreeSet class has the constructor TreeSet (Collection c) for con- 
structing a TreeSet from a collection c. In this example, new TreeSet (hashSet) creates an 
instance of TreeSet from the collection hashSet. 

§ Tip 

If you don't need to maintain a sorted set when updating a set, you should use a hash set, 
because it takes less time to insert and remove elements in a hash set. When you need a set to be 
sorted, you can create a tree set from the hash set. 

22.5 The Comparator Interface 

Sometimes you want to insert elements into a tree set. The elements may not be instances of 
java.lang. Comparable. You can define a comparator to compare these elements. To do 
so, create a class that implements the j ava . uti 1 . Comparator interface. The Comparator 
interface has two methods, compare and equal s. 

■ public int compare (Object elementl, Object element2) 

Returns a negative value if elementl is less than element2, a positive value if 
el ementl is greater than el ement2, and zero if they are equal. 

■ public boolean equal s (Object element) 

Returns true if the specified object is also a comparator and imposes the same order- 
ing as this comparator. 

The equal s method is also defined in the Object class. Therefore, you will not get a com- 
pile error even if you don't implement the equal s method in your custom comparator class. 
However, in some cases implementing this method may improve performance by allowing 
programs to determine quickly whether two distinct comparators impose the same order. 

Listing 22.5 defines a Comparator for geometric objects. The CeometricObject class was 
introduced in §14.2, "Abstract Classes." Line 4 implements Comparator<GeometricObject>. 
Line 5 overrides the compare method to compare two geometric objects. The comparator class 
also implements Serial izable. It is generally a good idea for comparators to implement 
Serial izabl e, as they may be used as ordering methods in serializable data structures such as 
TreeSet. In order for the data structure to serialize successfully, the comparator (if provided) 
must implement Ser i al i zabl e. 

Listing 22.5 Geometri cObjectComparator . java 

1 import java. util .Comparator; 
2 

3 public class Geometri cObjectComparator 

4 implements Comparator<Ceometri c0bject> , java. io. Serializable { implements Comparator 

5 public int compare(Geometri cObject ol, Geometri cObject o2) { implements compare 

6 double areal = ol.getAreaO; 

7 double area2 = o2.getArea(); 
8 

9 if (areal < area2) 
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10 return -1; 

11 else if (areal == area2) 

12 return 0; 

13 else 

14 return 1; 

15 } 

16 } 



If you create a TreeSet using its no-arg constructor, the compareTo method is used to compare 
the elements in the set, assuming that the class of the elements implements the Comparable 
interface. To use a comparator, you have to use the constructor TreeSet (Comparator com- 
parator) to create a sorted set that uses the compare method in the comparator to order the ele- 
ments in the set. 

Listing 22.6 gives a program that demonstrates how to sort elements in a tree set using the 
Comparator interface. The example creates a tree set of geometric objects in lines 6-11. The 
geometric objects are sorted using the compare method in the Comparator interface. 



Listing 22.6 TestTreeSetWi thComparator. java 



display elements 



1 
2 
3 
4 
5 
6 
7 
8 
9 
10 
11 
12 
13 
14 
15 
16 
17 
18 



import java.util.*; 

public class TestTreeSetWi thComparator { 
public static void main(String[] args) { 

// Create a tree set for geometric objects using a comparator 
Set<CeometricObject> set = 

new TreeSet<Geometri cObject>(new Ceometri cObjectComparatorO) ; 
set.add(new Rectangle(4, 5)); 



set.add(new Circle(40)); 
set.add(new Circle(40)); 
set.add(new Rectangle(4, 



D); 



// Display geometric objects in the tree set 

System. out. println("A sorted set of geometric objects"); 

for (Geometri cObject element: set) 

System. out . pri ntl n("area = " + el ement . getAreaQ) ; 



A sorted set of geometric objects 
area = 4.0 
area = 20.0 

area = 5022.548245743669 



The Ci rcl e and Rectangl e classes were defined in §14.2, "Abstract Classes." They are all 
subclasses of GeometricObject. 

Two circles of the same radius are added to the set in the tree set (lines 9-10), but only one 
is stored, because the two circles are equal and the set does not allow duplicates. 



Comparabl e vs. Comparator 



Note 

Comparable is used to compare the objects of the class that implement Comparable. 
Comparator can be used to compare the objects of the class that doesn't implement Comparable. 



22.6 Lists 

A set stores nonduplicate elements. To allow duplicate elements to be stored in a collection, 
you need to use a list. A list can not only store duplicate elements but also allow the user to 
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specify where they are stored. The user can access elements by an index. The List interface 
extends Col 1 ection to define an ordered collection with duplicates allowed. The Li st inter- 
face adds position-oriented operations, as well as a new list iterator that enables the user to tra- 
verse the list bidirectionally. The new methods in the List interface are shown in Figure 22.4. 



«i nterface» 
java.uti 1 . Collection<E> 



«interface» 
java. util.List<E> 



+add (index: int, element: E) : boolean 

+addAll (index: int, c: Collection<? extends E>) 

: boolean 
+get(index: int): E 
+ indexOf (element: Object): int 
+ lastlndex0f (element: Object): int 
+ listIterator() : Li stIterator<E> 
+ HstIterator(startIndex: int): ListIterator<E> 
+ remove(index: int): E 
+set(index: int, element: E) : E 
+subList(fromIndex: int, tolndex: int): List<E> 



Adds a new element at the specified index. 

Adds all the elements in c to this list at the specified 
index. 

Returns the element in this list at the specified index. 
Returns the index of the first matching element. 
Returns the index of the last matching element. 
Returns the list iterator for the elements in this list. 
Returns the iterator for the elements from startlndex. 
Removes the element at the specified index. 
Sets the element at the specified index. 
Returns a sublist from fromlndex to tolndex-l. 



Figure 22.4 The List interface stores elements in sequence, permitting duplicates. 

The add (i ndex , el ement) method is used to insert an element at a specified index, and 
the addAll (index, collection) method to insert a collection at a specified index. The 
remove (i ndex) method is used to remove an element at the specified index from the list. A 
new element can be set at the specified index using the set (i ndex , el ement) method. 

The i ndexOf (el ement) method is used to obtain the index of the specified element's first 
occurrence in the list, and the lastlndexOf (element) method to obtain the index of its last 
occurrence. A sublist can be obtained by using the subList (fromlndex, tolndex) method. 

The 1 istlteratorO or 1 istlterator (startlndex) method returns an instance of 
Listlterator. The Listlterator interface extends the Iterator interface to add bidi- 
rectional traversal of the list. The methods in Listlterator are listed in Figure 22.5. 



«i nterface» 
java. uti 1 . Iterator<E> 



«interface» 
java.utiI.ListIterator<E> 



+add(o: E) : void 
+hasPrevious() : boolean 

+nextlndex() : int 
+previous(): E 
+previousIndex() : int 
+set(o: E) : void 



Adds the specified object to the list. 

Returns true if this list iterator has more elements 

when traversing backward. 
Returns the index of the next element. 
Returns the previous element in this list iterator. 
Returns the index of the previous element. 
Replaces the last element returned by the previous or 

next method with the specified element. 



Figure 22.5 Li stlterator enables traversal of a list bidirectionally. 
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The add (el ement) method inserts the specified element into the list. The element is 
inserted immediately before the next element that would be returned by the next() method 
defined in the Iterator interface, if any, and after the element that would be returned by the 
previous () method, if any. If the list contains no elements, the new element becomes the 
sole element on the list. The set (el ement) method can be used to replace the last element 
returned by the next method or the previous method with the specified element. 

The hasNextO method defined in the Iterator interface is used to check whether the 
iterator has more elements when traversed in the forward direction, and the hasPreviousO 
method to check whether the iterator has more elements when traversed in the backward 
direction. 

The next() method defined in the Iterator interface returns the next element in the 
iterator, and the previous () method returns the previous element in the iterator. The 
nextlndexO method returns the index of the next element in the iterator, and the 
previousIndexO returns the index of the previous element in the iterator. 

The AbstractList class provides a partial implementation for the List interface. The 
AbstractSequential List class extends AbstractList to provide support for linked 
lists. 

22.6. 1 The ArrayLi st and Li nkedLi st Classes 

The ArrayList class (introduced in §11.11) and the LinkedList class are two concrete 
implementations of the List interface. ArrayList stores elements in an array. The array is 
dynamically created. If the capacity of the array is exceeded, a larger new array is created and 
all the elements from the current array are copied to the new array. LinkedList stores ele- 
ments in a linked list. Which of the two classes you use depends on your specific needs. If you 
need to support random access through an index without inserting or removing elements 
except at the end, ArrayList offers the most efficient collection. If, however, your applica- 
tion requires the insertion or deletion of elements anywhere in the list, you should choose 
LinkedList. A list can grow or shrink dynamically. Once it is created, an array is fixed. If 
your application does not require the insertion or deletion of elements, an array is the most 
efficient data structure. 

ArrayList is a resizable-array implementation of the List interface. It also provides 
methods for manipulating the size of the array used internally to store the list, as shown in 
Figure 22.6. Each ArrayList instance has a capacity, which is the size of the array used to 
store the elements in the list. It is always at least as large as the list size. As elements are 
added to an ArrayList, its capacity grows automatically. An ArrayList does not auto- 
trimToSizeO matically shrink. You can use the trimToSizeO method to reduce the array capacity to the 

size of the list. An ArrayList can be constructed using its no-arg constructor, 
Array List (Collect ion), or Array List (initial Capacity). 



java.uti 7 .AbstractLi st<E> 



java.util.ArrayList<E> 



+Arrayl_i st() 

+Arrayl_i st(c: Collection<? extends E>) 
+Ar rayLi st (i ni ti al Capaci ty : i nt) 
+trimToSizeO : void 



Creates an empty list with the default initial capacity. 

Creates an array list from an existing collection. 

Creates an empty list with the specified initial capacity. 

Trims the capacity of this ArrayLi st instance to be 
the list's current size. 



Figure 22.6 ArrayLi st implements Li st using an array. 
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LinkedList is a linked list implementation of the List interface. In addition to imple- 
menting the List interface, this class provides the methods for retrieving, inserting, and 
removing elements from both ends of the list, as shown in Figure 22.7. A Li nkedLi st can be 
constructed using its no-arg constructor or LinkedList (Col lection). 



java. uti 7 .AbstractSequential List<E> 



t- 



java.iilil. Linked Lisl<K> 



+Li nkedLi st() 

+Li nkedLi st(c : Collection<? extends E>) 

+addFi rst(o : E) : void 

+addLast(o : E) : void 

+getFirst(): E 

+getLast(): E 

+removeFi rst() : E 

+removeLast() : E 



Creates a default empty linked list. 

Creates a linked list from an existing collection. 

Adds the object to the head of this list. 

Adds the object to the tail of this list. 

Returns the first element from this list. 

Returns the last element from this list. 

Returns and removes the first element from this list. 

Returns and removes the last element from this list. 



Figure 22.7 Li nkedLi st provides methods for adding and inserting elements at both ends of the list. 



Listing 22.7 gives a program that creates an array list filled with numbers and inserts new 
elements into specified locations in the list. The example also creates a linked list from the 
array list and inserts and removes elements from the list. Finally, the example traverses the list 
forward and backward. 

Listing 22.7 TestArrayAndLi nkedLi st. java 

1 import java.util .*; 

2 

3 public class TestArrayAndLi nkedLi st { 

4 public static void main(String[] args) { 

5 Li st<Integer> arrayList = new ArrayLi st<Integer>() ; array list 

6 arrayList. add(l) ; // 1 is autoboxed to new Integer(l) 

7 arrayList. add(2) ; 

8 arrayList. add(3) ; 

9 arrayList. add(l) ; 

10 arrayList. add(4) ; 

11 arrayList. add(0, 10); 

12 arrayList. add(3, 30); 
13 

14 System. out. println("A list of integers in the array list:"); 

15 System. out. println(arrayList) ; 
16 

17 Li nkedLi st<0bject> li nkedLi st = new Li nkedLi st<Object>(arrayLi st) ; linked list 

18 "I i nkedLi st. add (1, "red"); 

19 1 i nkedLi st . removeLast() ; 

20 li nkedLi st. addFi rst("green") ; 
21 

22 System. out. pri ntl n ("Display the linked list forward:"); 

23 Li stlterator<0bject> listlterator = 1 i nkedLi st . 1 i stlteratorO ; listiterator 

24 while (1 i stlterator . hasNextO) { 

25 System. out. pri nt(l i stlterator . next() + " ") ; 

26 } 

27 System. out. printlnQ ; 
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28 

29 System. out. pri ntl n("Display the linked list backward:"); 
list iterator 30 listlterator = linkedList.listlterator(linkedList.sizeO) ; 

31 while (listlterator. hasPreviousO) { 

32 System. out. print(listIterator.previous() + " ") ; 

33 } 

34 } 

35 } 



A list of integers in the array list: 

[10, 1, 2, 30, 3, 1, 4] 

Display the linked list forward: 

green 10 red 1 2 30 3 1 

Display the linked list backward: 

1 3 30 2 1 red 10 green 



A list can hold identical elements. Integer 1 is stored twice in the list (lines 6, 9). ArrayList 
and LinkedList are operated similarly. The critical difference between them pertains to 
internal implementation, which affects their performance. ArrayList is efficient for retriev- 
ing elements and for inserting and removing elements from the end of the list. LinkedList 
is efficient for inserting and removing elements anywhere in the list. 

ij| Tip 

Arrays. asLi st (T. . . a) Java provides the static asList method for creating a list from a variable-length argument list of 

method a generic type. Thus you can use the following code to create a list of strings and a list of integers: 

List<String> listl = Arrays . asLi st("red" , "green", "blue"); 
List<Integer> list2 = Arrays. asList(10, 20, 30, 40, 50); 



22.7 Static Methods for Lists and Collections 

You can use TreeSet to store sorted elements in a set. But there is no sorted list. However, 
the Java Collections Framework provides static methods in the Collections class that can 
be used to sort a list. The Collections class also contains the binarySearch, reverse, 
shuffle, copy, and fill methods on lists, and max, min, disjoint, and frequency 
methods on collections, as shown in Figure 22.8. 

You can sort the comparable elements in a list in its natural order through the compareTo 
method in the Comparable interface. You may also specify a comparator to sort elements, 
sort list For example, the following code sorts strings in a list. 

List<String> list = Arrays . asLi st("red" , "green", "blue"); 
Col 1 ecti ons . sort(l i st) ; 
System. out. pri ntl n (list) ; 

The output is [blue, green, red], 

ascending order The preceding code sorts a list in ascending order. To sort it in descending order, you may 

descending order simply use the Collections . reverseOrderO method to return a Comparator object 

that orders the elements in reverse order. For example, the following code sorts a list of strings 

in descending order. 

List<String> list = Arrays . asLi st("yellow" , "red", "green", "blue"); 
Col 1 ecti ons . sort (1 i st , Collections. reverseOrderO) ; 
System. out. pri ntl n (list) ; 



The output is [yellow, red, green, blue]. 
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java.util.Collections 



List 



Collection 



+ sort(1ist: List): void 

+ sort(list: List, c: Comparator): void 

+ bi narySearch(l i st : List, key: Object): int 

+ bi narySearch(l i st : List, key: Object, c: 
Comparator) : i nt 

+ reverse(l i st : List): void 
+ reverseOrder() : Comparator 
+ shuff1e(list: List): void 
+ shuff1e(list: List, rmd: Random): void 
+ copy(des: List, src: List): void 
+ nCopies(n: int, o: Object): List 
+ fill(list: List, o: Object): void 
+ max(c: Collection): Object 
+ max(c: Collection, c: Comparator): Object 
+ min(c: Collection): Object 
+ min(c: Collection, c: Comparator): Object 
+ disjoint(cl: Collection, c2: Collection): 
boolean 

+ f requency(c : Collection, o: Object): int 



Sorts the specified list. 

Sorts the specified list with the comparator. 

Searches the key in the sorted list using binary search. 

Searches the key in the sorted list using binary search 

with the comparator. 
Reverses the specified list. 
Returns a comparator with the reverse ordering. 
Shuffles the specified list randomly. 
Shuffles the specified list with a random object. 
Copies from the source list to the destination list. 
Returns a list consisting of n copies of the object. 
Fills the list with the object. 
Returns the max object in the collection. 
Returns the max object using the comparator. 
Returns the mi n object in the collection. 
Returns the mi n object using the comparator. 
Returns true if cl and c2 have no elements in common. 



Returns the number of occurrences of the specified 
element in the collection. 



Figure 22.8 The Col 1 ecti ons class contains static methods for manipulating lists and collections. 



You can use the bi narySearch method to search for a key in a list. The list must be presorted bi narySearch 
in increasing order. If the key is not in the list, the method returns —(insertion point +7). 
Recall that the insertion point is where the item would fall in the list if it were present. For exam- 
ple, the following code searches the keys in a list of integers and a list of strings. 

Li st<Integer> "listl = 

Arrays. asList(2, 4, 7, 10, 11, 45, 50, 59, 60, 66); 
System. out. println("(l) Index: " + Collections. binarySearchfJistl, 7)); 
System. out. println("(2) Index: " + Collections. binarySearchfJistl, 9)); 

List<String> list2 = Arrays . asLi st("bl ue" , "green", "red"); 
System. out. println("(3) Index: " + 

Col 1 ecti ons . bi narySearch (1 i st2 , "red")) ; 
System. out. println("(4) Index: " + 

Col 1 ecti ons . bi narySearch (1 i st2 , "cyan")) ; 

The output of the preceding code is 



(1) Index: 2 

(2) Index: -4 

(3) Index: 2 

(4) Index: -2 



You can use the reverse method to reverse the elements in a list. For example, the following reverse 
code displays [blue, green, red, yellow]. 

List<String> list = Arrays . asLi st("yellow" , "red", "green", "blue"); 
Col 1 ecti ons . reverse (1 i st) ; 
System. out. println(list) ; 
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shuffle You can use the shuffle(List) method to randomly reorder the elements in a list. For 

example, the following code shuffles the elements in 1 ist. 

Li st<Stri ng> list = Arrays . asLi st("yellow" , "red", "green", "blue"); 
Col 1 ecti ons . shuff 1 e(l i st) ; 
System. out. println (list) ; 

You can also use the shuf f 1 e (Li st , Random) method to randomly reorder the elements in 
a list with a specified Random object. Using a specified Random object is useful to generate a 
list with identical sequences of elements for the same original list. For example, the following 
code shuffles the elements in 1 i st. 

List<String> listl = Arrays. asList("yellow", "red", "green", "blue"); 
List<String> list2 = Arrays . asLi st("yel low" , "red", "green", "blue"); 
Collections. shuffle(listl, new Random(20)) ; 
Col 1 ecti ons . shuff 1 e(l i st2 , new Random(20)); 
System. out. println (listl) ; 
System. out. pri ntl n(l i st2) ; 

You will see that 1 i stl and 1 i st2 have the same sequence of elements before and after the 
shuffling. 

copy You can use the copyCdet , src) method to copy all the elements from a source list to a 

destination list on the same index. The destination must be as long as the source list. If it is 
longer, the remaining elements in the source list are not affected. For example, the following 
code copies 1 i st2 to 1 i stl. 

List<String> listl = Arrays. asLi st("yellow" , "red", "green", "blue"); 
List<String> list2 = Arrays . asLi st("white" , "black"); 
Collections. copy(listl, list2); 
System. out. println (listl) ; 

The output for listl is [white, black, green, blue]. The copy method performs a 
shallow copy. Only the references of the elements from the source list are copied. 
nCopi es You can use the nCopi es (i nt n , Ob j ect o) method to create an immutable list that con- 

sists of n copies of the specified object. For example, the following code creates a list with 
five Cal endar objects. 

Li st<Gregori anCal endar> listl = Col 1 ecti ons . nCopi es 
(5, new Cregori anCal endar(2005 , 0, 1)); 

The list created from the nCopies method is immutable, so you cannot add, remove, or 
update elements in the list. All the elements have the same references, 
fill You can use the fill (List 1 ist , Object o) method to replace all the elements in the list 

with the specified element. For example, the following code displays [bl ack , bl ack , bl ack] . 

List<String> list = Arrays . asLi st("red" , "green", "blue"); 
Col 1 ecti ons . f i 11 (1 i st , "bl ack") ; 
System. out. println (list) ; 

max and min methods You can use the max and mi n methods for finding the maximum and minimum elements in a 

collection. The elements must be comparable using the Comparable interface or the 
Comparator interface. For example, the following code displays the largest and smallest 
strings in a collection. 

Col 1 ecti on<Stri ng> collection = Arrays . asLi st("red" , "green", "blue"); 
System . out . pri ntl n (Col 1 ecti ons . max (col 1 ecti on) ) ; 
System . out . pri ntl n (Col 1 ecti ons . mi n (col 1 ecti on) ) ; 
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The disjoint(collectionl, collection2) method returns true if the two collec- disjoint method 
tions have no elements in common. For example, in the following code, disjoint(collec- 
tionl, co"llection2) returns false, but disjoint(collectionl, collection3) 
returns true. 



Col 1 ecti on<Stri ng> collectionl = Arrays . asLi st("red" , "cyan"); 
Col 1 ecti on<Stri ng> collection2 = Arrays . asLi st("red" , "blue"); 
Col 1 ecti on<Stri ng> collection3 = Arrays. asList("pink", "tan"); 
System . out . pri ntl n(Col 1 ecti ons . di s joi nt(col 1 ectionl, col 1 ecti on2) ) ; 
System . out . pri ntl n (Col 1 ecti ons . di s joi nt (col 1 ecti onl, col 1 ecti on 3) ) ; 



The f requency(col 1 ection , el ement) method finds the number of occurrences of the frequency method 
element in the collection. For example, f requency(col 1 ection , "red") returns 2 in the 
following code. 

Col 1 ecti on<Stri ng> collection = Arrays . asLi st("red" , "cyan", "red"); 
System . out . pri ntl n (Col 1 ecti ons . frequency (col 1 ecti on , "red")) ; 



22.8 Performance of Sets and Lists 

We now conduct an interesting experiment to test the performance of sets and lists. Listing 
22.8 gives a program that shows the execution time of adding and removing elements in a 
hash set, linked hash set, tree set, array list, and linked list. 

Listing 22.8 SetListPerformanceTest. java 

1 import java.util ; 

2 

3 public class SetListPerformanceTest { 



4 public static void main(String[] args) { 

5 // Create a hash set, and test its performance 

6 Collection<Integer> setl = new HashSet<Integer>() ; ahashset 

7 System. out. pri ntl n ("Time for hash set is " + 

8 getTestTime(setl, 500000) + " milliseconds")- 

9 

10 // Create a linked hash set, and test its performance 

11 Collection<Integer> set2 = new Li nkedHashSet<Integer>() ; a linked hash set 

12 System. out. pri ntl n("Time for linked hash set is " + 

13 getTestTime(set2, 500000) + " milliseconds"); 
14 

15 // Create a tree set, and test its performance 

16 Collection<Integer> set3 = new TreeSet<Integer>() ; atreeset 

17 System. out. pri ntl n ("Time for tree set is " + 

18 getTestTime(set3, 500000) + " milliseconds"); 
19 

20 // Create an array list, and test its performance 

21 Collection<Integer> listl = new ArrayLi st<Integer>() ; anarraylist 

22 System. out. pri ntl n("Time for array list is " + 

23 getTestTime(listl, 60000) + " milliseconds"); 
24 

25 // Create a linked list, and test its performance 

26 Collection<Integer> list2 = new Li nkedLi st<Integer>() ; alinkedlist 

27 System. out. pri ntl n("Time for linked list is " + 

28 getTestTime(list2, 60000) + " milliseconds"); 

29 } 
30 

31 public static long getTestTime(Collection<Integer> c, int size) { 

32 long startTime = System . cur rentTi meMi 1 1 i s () ; start time 
33 



746 Chapter 22 Java Collections Framework 



shuffle 

add to container 
shuffle 

remove from container 
end time 

return elapsed time 



34 
35 
36 
37 
38 
39 
40 
41 
42 
43 
44 
45 
46 
47 
48 
49 
50 
51 
52 
53 

54 } 



// Add numbers 0, 1, 2, size - 1 to the array list 

Li st<Integer> list = new ArrayLi st<Integer>() ; 
for (int i =0; i < size; i++) 
list.add(i) ; 

Collections. shuffle(list) ; // Shuffle the array list 

// Add the elements to the container 
for (int element: list) 
c.add(element) ; 

Collections. shuffle(list) ; // Shuffle the array list 

// Remove the element from the container 
for (int element: list) 
c . remove (el ement) ; 

long endTime = System. currentTimeMillis() ; 

return endTime - startTime; // Return the execution time 



Time for hash set is 1437 milliseconds 
Time for linked hash set is 1891 milliseconds 
Time for tree set is 2891 milliseconds 
Time for array list is 13797 milliseconds 
Time for linked list is 15344 milliseconds 



The getTestTime method creates a list of distinct integers from to size - 1 (lines 35-37), 
shuffles the list (line 39), adds the elements from the list to a container c (lines 42-43), shuf- 
fles the list again (line 45), removes the elements from the container (lines 48^-9), and finally 
returns the execution time (line 52). 

The program creates a hash set (line 6), a linked hash set (line 11), a tree set (line 16), an 
array list (line 21), and a linked list (line 26). The program obtains the execution time for 
adding and removing 500000 elements in the three sets and adding and removing 60000 ele- 
ments in the two lists. 

sets are better As you see, sets are much more efficient than lists. If sets are sufficient for your application, 

use sets. Furthermore, if no particular order is needed for your application, choose hash sets. 

The program tested general remove operations for array lists and linked lists. Their com- 
plexity is about the same. Please note that linked lists are more efficient than array lists for 
insertion and deletion anywhere in the list except at the end. 

22.9 The Vector and Stack Classes 

The Java Collections Framework was introduced with Java 2. Several data structures were 
supported earlier, among them the Vector and Stack classes. These classes were redesigned 
to fit into the Java Collections Framework, but all their old-style methods are retained for 
compatibility. 

Vector is the same as ArrayLi st, except that it contains synchronized methods for access- 
ing and modifying the vector. Synchronized methods can prevent data corruption when a vector 
is accessed and modified by two or more threads concurrently. For the many applications that do 
not require synchronization, using ArrayLi st is more efficient than using Vector. 

The Vector class implements the Li st interface. It also has the methods contained in the 
original Vector class defined prior to Java 2, as shown in Figure 22.9. 
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«i nterface» 
java . uti 7 . List<E> 



3" 



java.util.Vector<E> 



+Vector() 

+Vector(c: Collection<? extends E>) 
+Vector(initialCapacity: int) 
+Vector(initCapacity : int, capacitylncr: int) 
+addElement(o: E) : void 
+capacity(): int 

+copyInto(anArray : Object[]): void 
+elementAt (index: int): E 
+elements(): Enumeration<E> 
+ensureCapaci ty() : void 
+fi rstElementO : E 

+insertElementAt(o: E, index: int): void 
+lastElement() : E 
+removeAl 1 El ements() : void 
+removeElement(o: Object): boolean 
+removeEl ementAt(i ndex : int): void 
+setElementAt(o: E, index: int): void 
+setSize(newSize: int): void 
+trimToSize() : void 



Creates a default empty vector with initial capacity 10. 

Creates a vector from an existing collection. 

Creates a vector with the specified initial capacity. 

Creates a vector with the specified initial capacity and increment. 

Appends the element to the end of this vector. 

Returns the current capacity of this vector. 

Copies the elements in this vector to the array. 

Returns the object at the specified index. 

Returns an enumeration of this vector. 

Increases the capacity of this vector. 

Returns the first element in this vector. 

Inserts o to this vector at the specified index. 

Returns the last element in this vector. 

Removes all the elements in this vector. 

Removes the first matching element in this vector. 

Removes the element at the specified index. 

Sets a new element at the specified index. 

Sets a new size in this vector. 

Trims the capacity of this vector to its size. 



Figure 22.9 The Vector class in Java 2 implements Li st and also retains all the methods in the original Vector class. 



Most of the additional methods in the Vector class listed in the UML diagram in Figure 
22.9 are similar to the methods in the List interface. These methods were introduced 
before the Java Collections Framework. For example, addElement (Object element) is 
the same as the add (Object element) method, except that the addElement method is 
synchronized. Use the ArrayList class if you don't need synchronization. It works much 
faster than Vector. 

§ Note 

The elementsO method returns an Enumeration. The Enumeration interface was intro- 
duced prior to Java 2 and was superseded by the Iterator interface. 

# Note 

Vector is widely used in Java programming because it was the Java resizable array implementa- 
tion before Java 2. Many of the Swing data models use vectors. 

In the Java Collections Framework, Stack is implemented as an extension of Vector, as 
illustrated in Figure 22.10. 

The Stack class was introduced prior to Java 2. The methods shown in Figure 22.10 were 
used before Java 2. The empty () method is the same as isEmpty(). The peek() method 
looks at the element at the top of the stack without removing it. The pop() method removes 
the top element from the stack and returns it. The push(Object el ement) method adds the 
specified element to the stack. The search (Object element) method checks whether the 
specified element is in the stack. 
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j ava . uti 1 . Vecto r<E> 



java.util.Stack<E> 



+Stack() 

+empty(): boolean 
+peek(): E 
+pop(): E 
+push(o: E) : E 
+search(o: Object): int 



Creates an empty stack. 

Returns true if this stack is empty. 

Returns the top element in this stack. 

Returns and removes the top element in this stack. 

Adds a new element to the top of this stack. 

Returns the position of the specified element in this stack. 



Figure 22.10 The Stack class extends Vector to provide a last-in, first-out data structure. 



22.10 Queues and Priority Queues 

A queue is a first-in, first-out data structure. Elements are appended to the end of the queue 
and are removed from the beginning of the queue. In a priority queue, elements are assigned 
priorities. When accessing elements, the element with the highest priority is removed first. 
This section introduces queues and priority queues in the Java API. 

Queue interface The Queue interface extends j ava. uti 1 .Collection with additional insertion, extrac- 

tion, and inspection operations, as shown in Figure 22. 1 1 . 

The offer method is used to add an element to the queue. This method is similar to the add 
method in the Col 1 ection interface, but the offer method is preferred for queues. The pol 1 
and remove methods are similar, except that pol 1 () returns nul 1 if the queue is empty, 
whereas remove () throws an exception. The peek and element methods are similar, except 

queue operations that peek() returns nul 1 if the queue is empty, whereas el ement () throws an exception. 

22.10.1 Deque and LinkedList 

The LinkedList class implements the Deque interface, which extends the Queue interface, 
as shown in Figure 22.12. So you can use LinkedList to create a queue. 



«i nterface» 
java.uti 7 . Collection<E> 



I 



«interface» 
java. util. Queue<E> 



+offer(el ement: E ) : boolean 
+pon(): E 

+ remove(): E 

+peek(): E 

+element() : E 



Inserts an element to the queue. 

Retrieves and removes the head of this queue, or null 
if this queue is empty. 

Retrieves and removes the head of this queue and 
throws an exception if this queue is empty. 

Retrieves, but does not remove, the head of this queue, 
returning null if this queue is empty. 

Retrieves, but does not remove, the head of this queue, 
throwing an exception if this queue is empty. 



Figure 22.1 1 The Queue interface extends Col 1 ection to provide additional insertion, 
extraction, and inspection operations. 
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«i nterface» 
java . uti 7 . Conection<E> 



7T 



«i nterface» 
java . uti 7 .List<E> 



4^ 



«i nterface» 
java . ot7 7 . Queue<E> 



:erfa< 

7'7.D£ 



«i nterface» 
java . uti 7 . Deque<E> 



java. uti 1 . Li nkedLi st<E> | 
Figure 22.12 Li nkedLi st implements List and Deque. 



Deque supports element insertion and removal at both ends. The name deque is short for 
"double-ended queue" and is usually pronounced "deck". The Deque interface extends 
Queue with additional methods for inserting and removing elements from the both ends of the 
queue. The methods addFi rst(e), removeFi rst(), addLast(e), removeLastO, 
getFi rst(), and getLastO are defined in the Deque interface. 

Listing 22.9 shows an example of using a queue to store strings. Line 4 creates a queue 
using Li nkedLi st. Four strings are added to the queue in lines 5-8. The size() method 
defined in the Collection interface returns the number of elements in the queue (line 10). 
The removeO method retrieves and removes the element at the head of the queue (line 11). 



Listing 22.9 TestQueue. java 



i 

2 
3 
4 
5 
6 
7 
8 
9 
10 
11 
12 
13 



public class TestQueue { 

public static void main(String[] args) { 
java.util .Queue<String> queue = 

new java. uti 1 . Li nkedLi st<Stri ng>() ; 
queue. offer("Oklahoma") ; 
queue . offer ("Indiana") ; 
queue . offer("Georgia") ; 
queue . offer("Texas") ; 

while (queue. size() > 0) 

System. out. print(queue. remove() + " ") ; 



creates a queue 
inserts an element 



queue size 
remove element 



Oklahoma Indiana Georgia Texas 




The PriorityQueue class implements a priority queue, as shown in Figure 22.13. By PriorityQueue class 
default, the priority queue orders its elements according to their natural ordering using 
Comparable. The element with the least value is assigned the highest priority and thus is 
removed from the queue first. If there are several elements with the same highest priority, the 
tie is broken arbitrarily. You can also specify an ordering using Comparator in the construc- 
tor PriorityQueue(initialCapacity , comparator). 

Listing 22. 10 shows an example of using a priority queue to store strings. Line 5 creates a pri- 
ority queue for strings using its no-arg constructor. This priority queue orders the strings using 
their natural order, so the strings are removed from the queue in increasing order. Lines 16-17 
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«i nterface» 




java. util . Queue<E> 






java.util.PriorityQueue<E> 


+PriorityQueue() 




+Pri ori tyQueue (i ni ti al Capaci ty 


int) 


+PriorityQueue(c: Collection<? 


extends 


E>) 




+Pri ori tyQueue (i ni ti al Capaci ty 


int, 


comparator: Comparator? super E>) 



Creates a default priority queue with initial capacity 11. 

Creates a default priority queue with the specified initial 
capacity. 

Creates a priority queue with the specified collection. 

Creates a priority queue with the specified initial 
capacity and the comparator. 



Figure 22.13 The Priori tyQueue class implements a priority queue. 



a default queue 
inserts an element 



a queue with comparator 



comparator 



create a priority queue using the comparator obtained from Col 1 ections . reverseOrder (), 
which orders the elements in reverse order, so the strings are removed from the queue in 
decreasing order. 

Listing 22.10 Pri ori tyQueueDemo. java 



1 

2 
3 
4 
5 
6 
7 
8 
9 
10 
11 
12 
13 
14 
15 
16 
17 
18 
19 
20 
21 
22 
23 
24 
25 
26 
27 
28 



import java. util.*; 



public class Pr 
public static 

Priori tyQue 
queuel.offe 
queuel.offe 
queuel.offe 
queuel.offe 

System . out . 
while (queu 
System. ou 

} 

Priori tyQue 
4, Collec 
queue2 . offe 
queue2 . offe 
queue2 . offe 
queue2 . offe 

System . out 
while (queu 
System. ou 

} 



i ori tyQueueDemo { 

void main(String[] args) { 
ue<String> queuel = new PriorityQueue<String>() ; 
r ("Oklahoma") ; 
r("Indiana") ; 
r("Georgia") ; 
r("Texas") ; 

pri ntl n("Priority queue using Comparable:"); 
el.sizeO > 0) { 
t.print(queuel. remove() + " ") ; 



ue<String> queue2 = new Pri ori tyQueue<Stri ng>( 

tions . reverseOrderO ) ; 

r ("Oklahoma") ; 

r("Indiana") ; 

r("Georgia") ; 

r("Texas") ; 

pri ntl n("\nPriority queue using Comparator:"); 

e2.size() > 0) { 

t. pri nt(queue2 . remove() + " ") ; 



Priority queue using Comparable: 
Georgia Indiana Oklahoma Texas 
Priority queue using Comparator: 
Texas Oklahoma Indiana Georgia 
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22.1 I Maps 



Suppose your program stores a million students and frequently searches for a student using 
the social security number. An efficient data structure for this task is the map. A map is a con- 
tainer that stores the elements along with the keys. The keys are like indexes. In List, the 
indexes are integers. In Map, the keys can be any objects. A map cannot contain duplicate 
keys. Each key maps to one value. A key and its corresponding value form an entry, which is 
actually stored in a map, as shown in Figure 22.14. 

There are three types of maps: HashMap, Li nkedHashMap, and TreeMap. The common fea- 
tures of these maps are defined in the Map interface. Their relationship is shown in Figure 22.15. 

The Map interface provides the methods for querying, updating, and obtaining a collection 
of values and a set of keys, as shown in Figure 22.16. 



why map? 



Search keys 



- Corresponding 
element values 



A map- 



iL^zir^— i r 


li=]i= 


= 1 


l = = 


= 1 




|L= = 


= 1 



Entry 



Figure 22.14 The entries consisting of key/value pairs are stored in a map 
SortedMap | ^- - - NavigableMap | ^- 



Map 1 4- 



Interfaces 

Figure 22.15 A map stores key/value pairs. 

«interface» 
java.util.Map<K, V> 



AbstractMap | ^J- 



Abstract Classes 



ZZZZ TreeMap | 

- HashMap \ § Li nkedHashMap | 



Concrete Classes 



+clear(): void 

+contai nsKey(key: Object): boolean 

+containsValue(value: Object): boolean 

+entrySet() : Set<Map . Entry<K , V» 

+get(key: Object): V 

+ i sEmptyO : boolean 

+keySet(): Set<K> 

+put(key: K, value: V) : V 

+putAll (m: Map<? extends K,? extends 

V>) : void 
+remove(key: Object): V 
+size(): int 
+val ues() : Collection<V> 



Removes all entries from this map. 
Returns true if this map contains entries for the 
specified key. 

Returns true if this map maps one or more keys to the 

specified value. 
Returns a set consisting of the entries in this map. 
Returns the value for the specified key in this map. 
Returns true if this map contains no entries. 
Returns a set consisting of the keys in this map. 
Puts a mapping in this map. 
Adds all the entries from m to this map. 

Removes the entries for the specified key. 
Returns the number of entries in this map. 
Returns a collection consisting of the values in this map. 



Figure 22.1 6 The Map interface maps keys to values. 
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update methods 



query methods 



keySet () 
val ues() 
entrySetQ 



The update methods include clear, put, putAll, and remove. The clearO method 
removes all entries from the map. The put (K key , V val ue) method associates a value with 
a key in the map. If the map formerly contained a mapping for this key, the old value associ- 
ated with the key is returned. The putAl 1 (Map m) method adds the specified map to this 
map. The remove (Object key) method removes the map elements for the specified key 
from the map. 

The query methods include containsKey, containsVal ue, isEmpty, and size. The 
containsKey (Object key) method checks whether the map contains a mapping for the 
specified key. The containsVal ue (Object value) method checks whether the map con- 
tains a mapping for this value. The i sEmpty () method checks whether the map contains any 
mappings. The size() method returns the number of mappings in the map. 

You can obtain a set of the keys in the map using the keySet () method, and a collection 
of the values in the map using the val ues() method. The entrySetO method returns a set 
of objects that implement the Map. Entry<K, V> interface, where Entry is an inner interface 
for the Map interface, as shown in Figure 22.17. Each object in the set is a specific key/value 
pair in the underlying map. 



AbstractMap 



concrete implementation 

HashMap 

LinkedHashMap 



insertion order 
access order 



TreeMap 



SortedMap 



«interface» 
java.util.Map.Entry<K, V> 



+getKey(): K 
+getValue() : V 
+setValue(value: V) : void 



Returns the key corresponding to this entry. 
Returns the value corresponding to this entry. 
Replaces the value in this entry with a new value. 



Figure 22.1 7 The Map . Entry interface operates on an entry in the map. 

The AbstractMap class is a convenience class that implements all the methods in the Map 
interface except the entrySetO method. 

The SortedMap interface extends the Map interface to maintain the mapping in ascending 
order of keys with additional methods f i rstKeyO and 1 astKey () for returning the lowest 
and highest key, headMap(toKey) for returning the portion of the map whose keys are less 
than toKey, and tail Map (f romKey) for returning the portion of the map whose keys are 
greater than or equal to f romKey. 

The HashMap, LinkedHashMap, and TreeMap classes are three concrete implementa- 
tions of the Map interface, as shown in Figure 22.18. 

The HashMap class is efficient for locating a value, inserting a mapping, and deleting a 
mapping. 

LinkedHashMap extends HashMap with a linked-list implementation that supports an 
ordering of the entries in the map. The entries in a HashMap are not ordered, but the entries in 
a LinkedHashMap can be retrieved either in the order in which they were inserted into the 
map (known as the insertion order) or in the order in which they were last accessed, from 
least recently to most recently accessed (access order). The no-arg constructor constructs a 
LinkedHashMap with the insertion order. To construct a LinkedHashMap with the access 
order, use the LinkedHashMap(initialCapacity, loadFactor, true). 

The TreeMap class is efficient for traversing the keys in a sorted order. The keys can be 
sorted using the Comparabl e interface or the Comparator interface. If you create a TreeMap 
using its no-arg constructor, the compareTo method in the Comparable interface is used to 
compare the elements in the map, assuming that the class of the elements implements the 
Comparable interface. To use a comparator, you have to use the TreeMap (Comparator 
comparator) constructor to create a sorted map that uses the compare method in the com- 
parator to order the elements in the map based on the keys. 

SortedMap is a subinterface of Map, which guarantees that the entries in the map are 
sorted. Additionally, it provides the methods firstKeyO and lastKeyO for returning 
the first and last keys in the map, and headMap(toKey) and tail Map(f romKey) for 
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«i nte 
java.util 



rface» 
.Map<K, V> 



3 A 



java.util .AbstractMap<K, V> 



java.util.HashMap<K,V> 



+HashMap() 

+HashMap("initialCapacity: int, load Factor: float) 
+HashMap(m: Map<? extends K, ? extends V>) 



java.util.LinkedHashMap<K,Y> 



+Li nkedHashMapO 

+LinkedHashMap(m: Map<? extends K,? extends V>) 

+Li nkedHashMap(i ni ti al Capaci ty : int, 

loadFactor: float, accessOrder: boolean) 



«interface» 
java. utiI.SortedMap<K, V> 



+firstKey(): K 
+ lastKey(): K 

■^■comparator O : Comparator<? super K>) 
+headMap(toKey: K) : SortedMap<K,V> 
+tailMap(fromKey: K): SortedMap<K,V> 



«interface» 
java. utiI.Navigab!eMap<K, V> 



+ floorKey(key: K) : K 

+ceilingKey(key: K) : K 

+ lowerKey(key: K) : K 

+higherKey(key: K) : K 

+pol 1 Fi rstEntryO : Map.EntrySet<K, V> 

+poll LastEntryQ : Map.EntrySet<K, V> 



java.util.TreeMap<K,V> 



+TreeMap() 

+TreeMap(m: Map<? extends K,? extends V>) 
+TreeMap(c: Comparator<? super K>) 



Figure 22.1 8 The Java Collections Framework provides three concrete map classes. 



returning a portion of the map whose keys are less than toKey and greater than or equal to 
f romKey. 

NavigableMap extends SortedMap to provide navigation methods lowerKey(key), NavigableMap 
floorKey(key), ceil ingKey(key), and higherKey(key) that return keys respectively 
less than, less than or equal, greater than or equal, and greater than a given key and return 
null if there is no such key. The pol 1 Fi rstEntryO and poll LastEntryO methods 
remove and return the first and last entry in the tree map, respectively. 

® Note 

Prior to Java 2, java.util . Hashtable was used for mapping keys with elements. 

Hashtable was redesigned to fit into the Java Collections Framework with all its methods Hashtable 

retained for compatibility. Hashtable implements the Map interface and is used in the same 

way as HashMap, except that Hashtable is synchronized. 

Listing 22. 1 1 gives an example that creates a hash map, a linked hash map, and a tree map that 
map students to ages. The program first creates a hash map with the student's name as its key 
and the age as its value. The program then creates a tree map from the hash map and displays 
the mappings in ascending order of the keys. Finally, the program creates a linked hash map, 
adds the same entries to the map, and displays the entries. 
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Listing 22. 1 1 Tes tMap . j ava 

1 import java.util.*; 

2 

3 public class TestMap { 

4 public static void main(String[] args) { 

5 // Create a HashMap 

create map 6 Map<String, Integer> hashMap = new HashMap<Stri ng , Integer>(); 

add entry 7 hashMap . put ("Smith" , 30); 

8 hashMap. put("Anderson", 31); 

9 hashMap. put("Lewis", 29); 
10 hashMap. put("Cook", 29); 
11 

12 System. out. pri ntl n("Display entries in HashMap"); 

13 System. out. pri ntl n(hashMap + "\n") ; 
14 

15 // Create a TreeMap from the previous HashMap 

tree map 16 Map<String, Integer> treeMap = 

17 new TreeMap<Stri ng , Integer>(hashMap) ; 

18 System. out. pri ntl n ("Display entries in ascending order of key"); 

19 System. out. pri ntl n(treeMap) ; 
20 

21 // Create a Li nkedHashMap 

linked hash map 22 Map<String, Integer> 1 i nkedHashMap = 

23 new Li nkedHashMap<Stri ng , Integer>(16, 0.75f, true); 

24 li nkedHashMap. put("Smith", 30); 

25 li nkedHashMap. put("Anderson", 31); 

26 linkedHashMap.put("Lewis", 29); 

27 li nkedHashMap. put("Cook", 29); 
28 

29 // Display the age for Lewis 

30 System. out. println("The age for " + "Lewis is " + 

31 1 i nkedHashMap. get("Lewis") .intValueO) ; 
32 

33 System. out. pri ntl n("\nDisplay entries in Li nkedHashMap") ; 

34 System . out . pri ntl n (1 i nkedHashMap) ; 

35 } 

36 } 




Display entries in HashMap 

{Cook=29, Smith=30, Lewis=29, Anderson=31} 



Display entries in ascending order of key 
{Anderson=31, Cook=29, Lewis=29, Smith=30} 
The age for Lewis is 29 

Display entries in Li nkedHashMap 
{Smith=30, Anderson=31, Cook=29, Lewis=29} 



As shown in the output, the entries in the HashMap are in random order. The entries in the 
TreeMap are in increasing order of the keys. The entries in the Li nkedHashMap are in the 
order of their access, from least recently accessed to most recently. 

All the concrete classes that implement the Map interface have at least two constructors. One 
is the no-arg constructor that constructs an empty map, and the other constructs a map from an 
instance of Map. Thus new TreeMap<String, Integer>(hashMap) (lines 16-17) 
constructs a tree map from a hash map. 
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You can create an insertion-ordered or access-ordered linked hash map. An access-ordered 
linked hash map is created in lines 22-23. The most recently accessed entry is placed at the 
end of the map. The entry with the key Lewis is last accessed in line 31, so it is displayed last 
in line 34. 

# Tip 

[f you don't need to maintain an order in a map when updating it, use a HashMap. When you 
need to maintain the insertion order or access order in the map, use a Li nkedHashMap. When 
you need the map to be sorted on keys, use a TreeMap. 

22. 1 I.I Case Study: Occurrences of Words 

This case study writes a program that counts the occurrences of words in a text and displays 
the words and their occurrences in alphabetical order of words. The program uses a TreeMap 
to store an entry consisting of a word and its count. For each word, check whether it is already 
a key in the map. If not, add to the map an entry with the word as the key and value 1. Other- 
wise, increase the value for the word (key) by 1 in the map. Assume the words are case insen- 
sitive; e.g., Good is treated the same as good. 
Listing 22.12 gives the solution to the problem. 

Listing 22.12 CountOccurrenceOfWords . java 

1 import java.util.*; 
2 

3 public class CountOccurrenceOfWords { 

4 public static void main(String[] args) { 



5 // Set text in a string 

6 String text = "Good morning. Have a good class. " + 

7 "Have a good visit. Have fun!"; 

8 

9 // Create a TreeMap to hold words as key and count as value 
10 TreeMap<Stri ng , Integer> map = new TreeMap<Stri ng , Integer>(); tree map 

11 

12 String [] words = text . split ("[ \n\t\r. ,;:!?(){") ; split string 

13 for (int i = 0; i < words . 1 ength ; i++) { 

14 String key = words [i ]. toLowerCaseO ; 
15 

16 if (key.lengthO > 0) { 

17 if (map.get(key) == null) { 

18 map. put (key, 1); add entry 

19 } 

20 else { 

21 int value = map.get(key) .intValue() ; 

22 value++; 

23 map. put (key, value); add entry 

24 } 

25 } 

26 } tree map 
27 

28 // Get all entries into a set 

29 Set<Map . Entry<Stri ng , Integer» entrySet = map . entrySet() ; entry set 
30 

31 // Get key and value from each entry 

32 for (Map.Entry<String, Integer> entry: entrySet) 

33 System. out. println(entry.getValue() + "\t" + entry. getKeyQ ) ; display entry 



34 } 

35 } 
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The program creates a TreeMap (line 10) to store pairs of words and their occurrence counts. 
The words serve as the keys. Since all elements in the map must be stored as objects, the 
count is wrapped in an Integer object. 

The program extracts a word from a text using the spl i t method (line 12) in the Stri ng 
class (see §9.2.7). For each word extracted, the program checks whether it is already stored as 
a key in the map (line 17). If not, a new pair consisting of the word and its initial count (1) is 
stored to the map (line 18). Otherwise, the count for the word is incremented by 1 (lines 
21-23). 

The program obtains the entries of the map in a set (line 29), and traverses the set to dis- 
play the count and the key in each entry (lines 32-33). 

Since the map is a tree map, the entries are displayed in increasing order of words. To dis- 
play them in ascending order of the occurrence counts, see Exercise 22.8. 

Now sit back and think how you would write this program without using map. Your new 
program will be longer and more complex. You will find that map is a very efficient and pow- 
erful data structure for solving problems such as this. 

22.12 Singleton and Unmodifiable Collections 
and Maps 

The Collections class contains the static methods for lists and collections. It also contains 
the methods for creating singleton sets, lists, and maps, and for creating unmodifiable sets, 
lists, and maps, as shown in Figure 22.19. 

The Col 1 ections class defines three constants: one for an empty set, one for an empty list, 
and one for an empty map (EMPTY_SET, EMPTY_LIST, and EMPTY_MAP). The class also pro- 
vides the singleton (Object o) method for creating an immutable set containing only a sin- 
gle item, the singletonList(Object o) method for creating an immutable list containing 



java.util.Collections 



+ sing1eton(o: Object): Set 
+ sing1etonList(o: Object): List 
+ sing1etonMap(key: Object, value: Object): Map 
+ unmodifiedCollection(c: Collection): Collection 
+ unmodifiableList(list: List): List 
+ unmodifiableMap(m: Map): Map 
+ unmodifiableSet(s: Set): Set 

+ unmodifiableSortedMap(s : SortedMap): SortedMap 
+unmodifiableSortedSet(s : SortedSet): SortedSet 



Returns a singleton set containing the specified object. 
Returns a singleton list containing the specified object. 
Returns a singleton map with the key and value pair. 
Returns an unmodified collection. 
Returns an unmodified list. 
Returns an unmodified map. 
Returns an unmodified set. 
Returns an unmodified sorted map. 
Returns an unmodified sorted set. 



Figure 22.19 The Col 1 ections class contains the static methods for creating singleton and unmodifiable sets, lists, 
and maps. 
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only a single item, and the singl etonMap (Object key, Object value) method for creat- 
ing an immutable map containing only a single mapping. 

The Collections class also provides six static methods for creating read-only collec- 
tions: unmodifiableCollection(Collection c), unmodifiableList(List 1 ist), 
unmodi fiabl eMap(Map m), unmodi fiabl eSet(Set set), unmodi fiableSorted- 
MapCSortedMap m), and unmodi fiabl eSortedSet(SortedSet s). The read-only col- 
lections prevent the data in the collections from being modified, and they offer better 
performance for read-only operations. 

Key Terms 



collection 728 
comparator 735 
data structure 728 
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linked hash map 752 
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Chapter Summary 



1. The Java Collections Framework supports sets, lists, queue, and maps. They are 
defined in the interfaces Set, List, Queue, and Map. 

2. A set stores a group of nonduplicate elements. 

3. A list stores an ordered collection of elements. 
4- A map stores key/value pairs. 

5 . All the concrete classes in the Java Collections Framework implement the CI oneabl e 
and Seri al i zabl e interfaces. Thus their instances can be cloned and serialized. 

6. A set stores nonduplicate elements. To allow duplicate elements to be stored in a collec- 
tion, you need to use a list. A list not only can store duplicate elements but also allows the 
user to specify where they are stored. The user can access elements by an index. 

7. Three types of sets are supported: HashSet, Li nkedHashSet, and TreeSet. HashSet 
stores elements in an unpredictable order. Li nkedHashSet stores elements in the order 
they were inserted. TreeSet stores elements sorted. All the methods in HashSet, 
Li nkedHashSet, and TreeSet are inherited from the Col 1 ection interface. 

8. Two types of lists are supported: ArrayList and LinkedList. ArrayList is a 
resizable-array implementation of the List interface. All the methods in Ar rayLi st 
are defined in List. LinkedList is a linked-list implementation of the List inter- 
face. In addition to implementing the List interface, this class provides the methods 
for retrieving, inserting, and removing elements from both ends of the list. 

9. The Vector class implements the List interface. In Java 2, Vector is the same as 
ArrayList, except that the methods for accessing and modifying the vector are 
synchronized. The Stack class extends the Vector class and provides several meth- 
ods for manipulating the stack. 

10. The Queue interface represents a queue. The Priori tyQueue class implements 
Queue for a priority queue. 
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I I . The Col 1 ecti on interface represents a collection of elements stored in a set or a list. 
The Map interface maps keys to the elements. The keys are like indexes. In Li st, the 
indexes are integers. In Map, the keys can be any objects. A map cannot contain dupli- 
cate keys. Each key can map to at most one value. The Map interface provides the 
methods for querying, updating, and obtaining a collection of values and a set of 
keys. 

12. Three types of maps are supported: HashMap, LinkedHashMap, and TreeMap. 

HashMap is efficient for locating a value, inserting a mapping, and deleting a map- 
ping. LinkedHashMap supports ordering of the entries in the map. The entries in a 
HashMap are not ordered, but the entries in a LinkedHashMap can be retrieved 
either in the order in which they were inserted into the map (known as the insertion 
order) or in the order in which they were last accessed, from least recently accessed 
to most recently (access order). TreeMap is efficient for traversing the keys in a 
sorted order. The keys can be sorted using the Comparable interface or the 
Comparator interface. 

Review Questions 

Sections 22.1-22.3 

22.1 Describe the Java Collections Framework. List the interfaces, convenience 
abstract classes, and concrete classes. 

22.2 Can a collection object be cloned and serialized? 

22.3 What method do you use to add all the elements from one collection to this collection? 

22.4 When should a method throw an UnsupportedOperationException? 

Section 22.4 

22.5 How do you create an instance of Set? How do you insert a new element in a set? 
How do you remove an element from a set? How do you find the size of a set? 

22.6 What are the differences between HashSet, Li nkedHashSet, and TreeSet? 

22.7 How do you traverse the elements in a set? Can you traverse the elements in a set 
in an arbitrary order? 

22.8 How do you sort the elements in a set using the compareTo method in the 
Comparable interface? How do you sort the elements in a set using the 
Comparator interface? What would happen if you added an element that could 
not be compared with the existing elements in a tree set? 

22.9 Suppose that setl is a set that contains the strings "red", "yellow", "green", 
and that set2 is another set that contains the strings "red", "yellow", "blue". 
Answer the following questions: 

■ What are setl and set2 after executing setl.addAll (set2)? 

■ What are setl and set2 after executing setl.add(set2)? 

■ What are setl and set2 after executing setl . removeAl 1 (set2)? 

■ What are setl and set2 after executing setl . remove(set2)? 

■ What are setl and set2 after executing setl. retainAll (set2)? 

■ What is setl after executing setl.clearO? 

22. 1 Show the output of the following code: 
i mport j ava . uti 1 . * ; 

public class Test { 
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public static void mai n(Stri ng [] args) { 

Li nkedHashSet<Stri ng> setl = new Li nkedHashSet<Stri ng>() ; 

setl.addC'New York") ; 

Li nkedHashSet<Stri ng> set2 = setl; 

Li nkedHashSet<Stri ng> set3 = 

(Li nkedHashSet<Stri ng>) (setl. cl one()) ; 
setl.add("Atlanta"); 

System. out . pri ntl n("setl is " + setl); 
System. out . pri ntl n("set2 is " + set2) ; 
System. out . pri ntl n("set3 is " + set3) ; 

} 

} 

22. 1 I Show the output of the following code: 

i mport j ava . uti 1 . * ; 
import java.io.*; 

public class Test { 

public static void mai n(Stri ng [] args) throws Exception { 
ObjectOutputStream output = new ObjectOutputStream( 

new FileOutputStream("c:\\test.dat")) ; 
Li nkedHashSet<Stri ng> setl = new Li nkedHashSet<Stri ng>() ; 
setl.addC'New York") ; 
Li nkedHashSet<Stri ng> set2 = 

(Li nkedHashSet<Stri ng>) setl. clone () ; 
setl. add ("Atlanta") ; 
output .wri teObject(setl) ; 
output .wri te0bject(set2) ; 
output . cl ose() ; 

ObjectlnputStream input = new ObjectInputStream( 

new FileInputStream("c:\\test.dat")) ; 
setl = (LinkedHashSet)input. readObject() ; 
set2 = (LinkedHashSet)input. readObject() ; 
System. out . pri ntl n (setl) ; 
System. out . pri ntl n(set2) ; 
output . cl ose() ; 

} 

} 

Section 22.5 

22.12 What are the differences between the Comparable interface and the Comparator 
interface? In which package is Comparabl e, and in which package is Comparator? 

22.1 3 The Comparator interface contains the equal s method. Why is the method not 
implemented in the GeometricObjectComparator class in this section? 

Section 22.6 

22.14 How do you add and remove elements from a list? How do you traverse a list in 
both directions? 

22.15 Suppose that 1 istl is a list that contains the strings "red", "yellow", "green", 
and that 1 ist2 is another list that contains the strings "red", "yellow", "blue". 

Answer the following questions: 

■ What are 1 istl and 1 ist2 after executing 1 istl . addAll (1 ist2)? 

■ What are 1 istl and 1 ist2 after executing 1 i stl . add(l ist2)? 

■ What are 1 istl and 1 ist2 after executing 1 istl. removeAll (1 ist2)? 

■ What are 1 istl and 1 ist2 after executing 1 istl . remove (1 ist2)? 
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■ What are 1 istl and 1 ist2 after executing 1 istl . retainAll CI ist2)? 

■ What is listl after executing 1 istl. clear ()? 

22.16 What are the differences between ArrayList and LinkedList? Are all the 
methods in ArrayLi st also in Li nkedLi st? What methods are in Li nkedLi st 
but not in ArrayLi st? 

22. 1 7 How do you create a set or a list from an array of objects? 
Section 22.7 

22. 1 8 Are all the methods in the Col 1 ections class static? 

22. 1 9 Which of the following static methods in the Col 1 ections class are for lists, and 
which are for collections? 

sort, bi narySearch , reverse, shuffle, max, min, disjoint, 
frequency 

22.20 Show the printout of the following code: 

i mport j ava . uti 1 . * ; 

public class Test { 

public static void man n(Stri ng [] args) { 
List<String> list = 

Arrays . asLi st("yellow" , "red", "green", "blue"); 
Col 1 ecti ons . reverse(l i st) ; 
System. out. println(list) ; 

List<String> listl = 

Arrays . asLi st("yellow" , "red", "green", "blue"); 
List<String> list2 = Arrays . asLi st("white" , "black"); 
Collections. copy(listl, list2); 
System. out. println(listl) ; 

Coll ecti on<Stri ng> cl = Arrays . asLi st("red" , "cyan"); 
Coll ecti on<Stri ng> c2 = Arrays . asLi st("red" , "blue"); 
Coll ecti on<Stri ng> c3 = Arrays. asList("pink", "tan"); 
System. out . pri ntl n (Coll ecti ons .di sjoi nt(cl, c2)) ; 
System. out . pri ntl n (Coll ecti ons .di sjoi nt(cl, c3)) ; 

Coll ecti on<Stri ng> collection = 

Arrays. asList("red", "cyan", "red"); 
System . out . pri ntl n (Col 1 ecti ons . frequency (col 1 ecti on , "red")) ; 

} 

} 

22.21 Which method can you use to sort the elements in an ArrayList or a 
LinkedList? Which method can you use to sort an array of strings? 

22.22 Which method can you use to perform binary search for elements in an 
ArrayList or a LinkedList? Which method can you use to perform binary 
search for an array of strings? 

22.23 Write a statement to find the largest element in an array of comparable objects. 
Section 22.9 

22.24 How do you create an instance of Vector? How do you add or insert a new ele- 
ment into a vector? How do you remove an element from a vector? How do you 
find the size of a vector? 

22.25 How do you create an instance of Stack? How do you add a new element into a stack? 
How do you remove an element from a stack? How do you find the size of a stack? 
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22.26 Does Listing 22.1, TestHashSet.java, compile and run if line 7 (Set set = new 
HashSetQ) is replaced by one of the following statements? 



Collection set = new Li nkedHashSetO ; 
Collection set = new TreeSetO; 
Collection set = new ArrayLi st() ; 
Collection set = new Li nkedLi st() ; 
Collection set = new VectorO; 
Collection set = new StackQ ; 



Section 22.10 

22.27 Is java.util .Queue a subinterface of java.util . Collection, java.- 
util .Set, or java.util . List? Does Li nkedLi st implement Queue? 

22.28 How do you create a priority queue for integers? By default, how are elements 
ordered in a priority queue? Is the element with the least value assigned the high- 
est priority in a priority queue? 

22.29 How do you create a priority queue that reverses the natural order of the elements? 
Section 22.1 1 

22.30 How do you create an instance of Map? How do you add into a map an entry con- 
sisting of a key and a value? How do you remove an entry from a map? How do 
you find the size of a map? How do you traverse entries in a map? 

22.3 1 Describe and compare HashMap, LinkedHashMap, and TreeMap. 

22.32 Show the printout of the following code: 

public class Test { 

public static void main(String[] args) { 
Map map = new Li nkedHashMapO ; 
map.put("123", "John Smith"); 
map . put("lll" , "George Smith"); 
map.put("123", "Steve Yao") ; 
map.put("222", "Steve Yao"); 
System. out. println("(l) " + map); 
System. out. println("(2) " + new TreeMap(map)) ; 

} 

} 
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Section 22.4 

22.1 (Performing set operations on hash sets) Create two hash sets {"George", "Jim", 
"John", "Blake", "Kevin", "Michael"} and {"George", "Katie", "Kevin", 
"Michel 1 e", "Ryan"} and find their union, difference, and intersection. (You may 
clone the sets to preserve the original sets from being changed by these set methods.) 

22.2 (Displaying nonduplicate words in ascending order) Write a program that reads 
words from a text file and displays all the nonduplicate words in ascending order. 
The text file is passed as a command-line argument. 

22.3** (Counting the keywords in Java source code) Write a program that reads a Java 
source-code file and reports the number of keywords (including nul 1 , true, and 
f al se) in the file. Pass the Java file name from the command line. 

(Hint: Create a set to store all the Java keywords.) 
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Section 22.5 

22.4 (Performing set operations on array lists) Create two array lists {"George", 
"Jim", "John", "Blake", "Kevin", "Michael"} and {"George", 
"Katie", "Kevin", "Michelle", "Ryan"} and find their union, difference, 
and intersection. (You may clone the lists to preserve the original lists from 
being changed by these methods.) 

22.5* (Displaying words in ascending alphabetical order) Write a program that reads 
words from a text file and displays all the words (duplicates allowed) in ascend- 
ing alphabetical order. The text file is passed as a command-line argument. 

Section 22.7 

22.6* (Storing numbers in a linked list) Write a program that lets the user enter numbers 
from a graphical user interface and display them in a text area, as shown in Figure 
22.20. Use a linked list to store the numbers. Do not store duplicate numbers. 
Add the buttons Sort, Shuffle, and Reverse to sort, shuffle, and reverse the list. 



I Exercise22_6 



|n| x| 



Enter a number: j?8] | 



£5 4545 23 13" 4 ; T 8 



Sort Shuffle Reverse 



Figure 22.20 The numbers are stored in a list and displayed in the text area. 



Section 22.1 1 

22.7* (Counting the occurrences of numbers entered) Write a program that reads an 
unspecified number of integers and finds the one that has the most occur- 
rences. Your input ends when the input is 0. For example, if you entered 2 3 40 
354-3332 0, the number 3 occurred most often. Please enter one number 
at a time. If not one but several numbers have the most occurrences, all of them 
should be reported. For example, since 9 and 3 appear twice in the list 9 30 3 
9 3 2 4, both occurrences should be reported. 

22.8** (Revising Listing 22.12, CountOccurrenceOfWords.java) Rewrite Listing 22.12 
to display the words in ascending order of occurrence counts. 

Hint: Create a class named WordOccurrence that implements the Comparabl e 
interface. The class contains two fields, word and count. The compareTo method 
compares the counts. For each pair in the hash set in Listing 22.12, create an 
instance of WordOccurrence and store it in an array list. Sort the array list using 
the Col lections, sort method. What would be wrong if you stored the 
instances of WordOccurrence in a tree set? 

22.9** (Counting the occurrences of words in a text file) Rewrite Listing 22.12 to read 
the text from a text file. The text file is passed as a command-line argument. 
Words are delimited by whitespace, punctuation marks (,;.:?), quotation 
marks ( ' "), and parentheses. Count words in case-insensitive fashion (e.g., 
consider Good and good to be the same word). Don't count the word if the 
first character is not a letter. Display the output in alphabetical order of words 
with each word preceded by its occurrence count. 

22.1 0*** (Syntax highlighting) Write a program that converts a Java file into an HTML 
file. In the HTML file, the keywords, comments, and literals are displayed in 
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bold navy, green, and blue, respectively. Use the command line to pass a Java 
file and an HTML file. For example, the following command 

java Exercise22_10 Wei come . j ava Welcome.HTML 

converts Compute Area.j ava into ComputeArea.HTML. Figure 22.21(a) shows 
a Java file. The corresponding HTML file is shown in Figure 22.21(b). 



P welcome.java - Notepad 



Fie Ertt Format View Help 



Jo].*] 



// Th i b. appliLaLion displays Welcome Lo Java! 
public class Welcome { 

publ il italic void ma iri(SLr ing [] aryb) { 
System, out. print! nC'Wel come to Java!"); 

} 



(a) 



] 



_l 



/ Intro to lava Programming, OE - nul - Mozla 



Fte Edt view History Bookmarks Took Hefp 



| J |fle:///L:/t;xtrL"be 1 i , \' | /tki>ine.hi:nil 



fir 



// This dppliuaLiun displays Welcome Lo ^ 
public class Welcome { 

public static void main (SLrinq [ ] dtqa) 
system. out .println ( "welcome to Java!" 



:■ 



| Done 



(b) 



Figure 22.2 1 The Java code in plain text in (a) is displayed in HTML with syntax highlighted in (b). 



(Guessing the capitals) Rewrite Exercise 9.22 so that the questions are ran- 
domly displayed. 

(Sort points in a plane) Write a program that meets the following require- 
ments: 

■ Define a class named Point with two data fields x and y to represent a 
point's x and y coordinates. Implement the Comparabl e interface for com- 
paring the points on x-coordinates and on y-coordinates if x-coordinates are 
identical. 

■ Define a class named CompareY that implements Comparator<Point>. 

Implement the compare method to compare two points on their y-coordinates 
and on their x-coordinates if y-coordinates are identical. 

■ Randomly create 100 points and apply the Arrays. sort method to dis- 
play the points in increasing order of their x-coordinates and in increasing 
order of their y-coordinates, respectively. 

22. 1 3** (Game: lottery) Revise Exercise 3. 15 to add an additional $2,000 award if two 
digits from the user input are in the lottery number. 

(Hint: Sort the three digits for lottery and for user input in two lists and use the 
Collection's containsAll method to check whether the two digits in the 
user input are in the lottery.) 

22.14** (Guessing the capitals using maps) Rewrite Exercise 9.22 to store pairs of 
state and its capital in a map. Your program should prompt the user to enter a 
state and should display the capital for the state. 

22. |5*** (Game: Sudoku) Revise Exercise 18.25 to display all solutions of the Sudoku 
game, as shown in Figure 22.22(a). When you click the Solve button, the pro- 
gram stores all solutions in an Array List. Each element in the list is a two- 
dimensional 9-by-9 grid. If the program has multiple solutions, the Next button 
appears as shown in Figure 22.22(b). You can click the Next button to display 
the next solution, as shown in Figure 22.22(c). When the Clear button is 
clicked, the cells are cleared and the Next button is hidden. 



22.1 I* 
22.12* 
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Figure 22.22 The program can display multiple Sudoku solutions. 



Chapter 



Algorithm Efficiency 

Objectives 

■ To estimate algorithm efficiency using the Big O notation (§23.2). 

■ To explain growth rates and why constants and nondominating terms can 
be ignored in the estimation (§23.2). 

■ To determine the complexity of various types of algorithms (§23.3). 

■ To analyze the binary search algorithm (§23.4.1). 

■ To analyze the selection sort algorithm (§23.4.2). 

■ To analyze the insertion sort algorithm (§23.4.3). 

■ To analyze the Towers of Hanoi algorithm (§23.4.4). 

■ To describe common growth functions (constant, 
logarithmic, log-linear, quadratic, cubic, exponential) ( 
§23.4.5). 

■ To design efficient algorithms for finding Fibonacci 
numbers (§23.5). 

■ To design efficient algorithms for finding gcd (§23.6). 

■ To design efficient algorithms for finding prime 
numbers (§23.7). 

■ To design efficient algorithms for finding a closest pair 
of points (§23.8). 
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23.1 Introduction 

what is algorithm efficiency? Suppose two algorithms perform the same task, such as search (linear search vs. binary 

search) or sort (selection sort vs. insertion sort). Which one is better? To answer this question, 
we might implement these algorithms in Java and run the programs to get execution time. But 
there are two problems with this approach: 

1 . First, many tasks run concurrently on a computer. The execution time of a particular 
program depends on the system load. 

2. Second, the execution time depends on specific input. Consider, for example, linear 
search and binary search. If an element to be searched happens to be the first in the list, 
linear search will find the element quicker than binary search. 

It is very difficult to compare algorithms by measuring their execution time. To overcome 
these problems, a theoretical approach was developed to analyze algorithms independent of 
computers and specific input. This approach approximates the effect of a change on the size 
of the input. In this way, you can see how fast an algorithm's execution time increases as the 
growth rate input size increases, so you can compare two algorithms by examining their growth rates. 

t|lt Pedagogical Note 

[f you are not taking a data structures course, you may skip this chapter. 

23.2 Big Notation 

Consider linear search. The linear search algorithm compares the key with the elements in the 
array sequentially until the key is found or the array is exhausted. If the key is not in the array, 
it requires n comparisons for an array of size n. If the key is in the array, it requires nil com- 
parisons on average. The algorithm's execution time is proportional to the size of the array. If 
you double the size of the array, you will expect the number of comparisons to double. The 
algorithm grows at a linear rate. The growth rate has an order of magnitude of n. Computer 
scientists use the Big O notation to represent "order of magnitude." Using this notation, the 
complexity of the linear search algorithm is 0{n), pronounced as "order ofn." 

For the same input size, an algorithm's execution time may vary, depending on the input. 
An input that results in the shortest execution time is called the best-case input, and an input 
that results in the longest execution time is the worst-case input. Best case and worst case are 
not representative, but worst-case analysis is very useful. You can be assured that the algo- 
rithm will never be slower than the worst case. An average-case analysis attempts to deter- 
mine the average amount of time among all possible inputs of the same size. Average-case 
analysis is ideal, but difficult to perform, because for many problems it is hard to determine 
the relative probabilities and distributions of various input instances. Worst-case analysis is 
easier to perform, so the analysis is generally conducted for the worst case. 

The linear search algorithm requires n comparisons in the worst case and nil comparisons 
in the average case if you are nearly always looking for something known to be in the list. 
Using the Big O notation, both cases require 0(n) time. The multiplicative constant (1/2) can 
be omitted. Algorithm analysis is focused on growth rate. The multiplicative constants have 
no impact on growth rates. The growth rate for nil or lOOn is the same as for n, as illustrated 
in Table 23.1. Therefore, 0[n) = 0(n/l) = <9(100«). 

Consider the algorithm for finding the maximum number in an array of n elements. To find 
the maximum number if n is 2, it takes one comparison; if n is 3, two comparisons. In general, 
it takes n — 1 comparisons to find the maximum number in a list of n elements. Algorithm 
analysis is for large input size. If the input size is small, there is no significance in estimating 
an algorithm's efficiency. As n grows larger, the n part in the expression n — 1 dominates the 
complexity. The Big O notation allows you to ignore the nondominating part (e.g., —1 in the 



Big O notation 

best-case 
worst-case 

average-case 



ignoring multiplicative 
constants 



large input size 

ignoring nondominating 
terms 
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Table 23.1 Growth Rates 



n ^^^^ 


n 


n/2 


lOOn 




100 


100 


50 


10000 


200 


200 


100 


20000 




2 


2 


2 


/(200) //(100) 



expression n — 1) and highlight the important part (e.g., n in the expression n — 1). So, the 
complexity of this algorithm is 0(ri). 

The Big O notation estimates the execution time of an algorithm in relation to the input 
size. If the time is not related to the input size, the algorithm is said to take constant time with constant time 
the notation 0(1). For example, a method that retrieves an element at a given index in an array 
takes constant time, because the time does not grow as the size of the array increases. 

The following mathematical summations are often useful in algorithm analysis: useful summations 

n(n + 1) 

l + 2 + 3 + -- -- + («-l)+n = — 

v ' 2 

a + a 1 + a 2 + « 3 + • ■ • ■ + fl^'" 1 ) + a" = ^ - 1 

a — I 

2° + 2 1 + 2 2 + 2 3 + • ■ • ■ + 2(" _1 ) + 2" = 2 — 1 = 2 n+1 - 1 

2 - 1 

23.3 Examples: Determining Big 

This section gives several examples of determining Big O for repetition, sequence, and selec- 
tion statements. 

Example I 

Consider the time complexity for the following loop: 

for ("i =1; "i <= n; { 
k = k + 5; 

} 

It is a constant time, c, for executing 
k = k + 5; 

Since the loop is executed n times, the time complexity for the loop is 

T(n) = (a constant c) * n = O(n). 

Example 2 

What is the time complexity for the following loop? 

for ("i =1; i <= n; { 
for (j = 1; j <= n; { 
k = k + i + j ; 

} 

} 
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It is a constant time, c, for executing 
k = k + i + j ; 

The outer loop executes n times. For each iteration in the outer loop, the inner loop is exe- 
cuted n times. So, the time complexity for the loop is 

T(n) = (a constant c) * n * n = 0(n 2 ) 

quadratic time An algorithm with the 0(n 2 ) time complexity is called a quadratic algorithm. The quadratic 

algorithm grows quickly as the problem size increases. If you double the input size, the time 
for the algorithm is quadrupled. Algorithms with a nested loop are often quadratic. 

Example 3 

Consider the following loop: 

for (i =1; i <= n; { 
for (j = 1; j <= i ; { 
k = k + i + j ; 

} 

} 

The outer loop executes n times. For i = 1,2,..., the inner loop is executed one time, two 
times, and n times. So, the time complexity for the loop is 

T(n) = c + 2c + 3c + 4c + ■ • • + nc 
= cn(n + l)/2 
= (c/2)« 2 + (c/2)« 
= 0(n 2 ) 

Example 4 

Consider the following loop: 

for (i =1; i <= n; { 
for (j = 1; j <= 20; { 
k = k + i + j ; 

} 

} 

The inner loop executes 20 times, and the outer loop n times. So, the time complexity for the 
loop is 

T(n) = 20 * c * n = 0{n) 

Example 5 

Consider the following sequences: 

for (j = 1; j <= 10; { 
k = k + 4; 

} 

for (i = 1 ; i <= n ; i ++) { 
for (j = 1; j <= 20; { 
k = k + i + j ; 

} 

} 
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The first loop executes 10 times, and the second loop 20 * n times. So, the time complexity 
for the loop is 

T{n) = 10 * c + 20 * c*n = O(n) 



Example 6 

Consider the following selection statement: 

if (list.contains(e)) { 
System. out. println(e) ; 

} 

el se 

for (Object t: list) { 
System . out . pri ntl n(t) ; 

} 

Suppose the list contains n elements. The execution time for 1 ist . contains(e) is 
O(n). The loop in the el se clause takes 0(n) time. So, the time complexity for the entire 
statement is 

T(n) = if test time + worst-case time (if clause, else clause) 
= 0{n) + 0{n) = 0{n) 



Example 7 

Consider the computation of a 11 for an integer n. A simple algorithm would multiply a n 
times, as follows: 

result = 1; 

for (int i = 1; i <= n; i++) 
result *= a; 

The algorithm takes 0(n) time. Without loss of generality, assume n = 2 k . You can improve 
the algorithm using the following scheme: 

result = a; 

for (int i = 1; i <= k; i++) 
result = result * result; 

The algorithm takes O(logn) time. For an arbitrary n, you can revise the algorithm and prove 
that the complexity is still O(logn). (See Review Question 23.7.) 

^ Note 

For simplicity, since 0(log n) = 0(log 2 n) = 0(log a n), the constant base is omitted. omitting base 

23.4 Analyzing Algorithm Time Complexity 

You have used many algorithms in this book. This section will analyze the complexity of 
several well-known algorithms: binary search, selection sort, insertion sort, and Tower of 
Hanoi. 

23.4-1 Analyzing Binary Search 

The binary search algorithm presented in Listing 6.7, BinarySearch.java, searches a key in a 
sorted array. Each iteration in the algorithm contains a fixed number of operations, denoted by 
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c. Let T(n) denote the time complexity for a binary search on a list of n elements. Without loss 
of generality, assume n is a power of 2 and k = log n. Since binary search eliminates half of 
the input after two comparisons, 

T{n) = r(j) + c = T (£) +c + c = t(£} + kc 

= T(l) + c log n = 1 + (log n)c 
= O(logn) 

Ignoring constants and nondominating terms, the complexity of the binary search algorithm is 
logarithmic time 0(\og n). An algorithm with the O(logn) time complexity is called a logarithmic algorithm. 

The base of the log is 2, but the base does not affect a logarithmic growth rate, so it can be 
omitted. The logarithmic algorithm grows slowly as the problem size increases. If you square 
the input size, you only double the time for the algorithm. 



23.4-2 Analyzing Selection Sort 

The selection sort algorithm presented in Listing 6.8, SelectionSort.java, finds the smallest 
number in the list and places it first. It then finds the smallest number remaining and places it 
after the first, and so on until the list contains only a single number. The number of compar- 
isons is n — 1 for the first iteration, n — 2 for the second iteration, and so on. Let T(ri) denote 
the complexity for selection sort and c denote the total number of other operations such as 
assignments and additional comparisons in each iteration. So, 

T(n) = (n - 1) + c + (n - 2) + c + ■■■ + 2 + c + l+ c 

(«-l)(«-l + l) n 2 n 

= hen — 1= V cn — c 

2 V ; 2 2 

= 0{n 2 ) 

Therefore, the complexity of the selection sort algorithm is 0(n 2 ). 



23.4-3 Analyzing Insertion Sort 

The insertion sort algorithm presented in Listing 6.9, InsertionSort.java, sorts a list of values 
by repeatedly inserting a new element into a sorted partial array until the whole array is 
sorted. At the kth iteration, to insert an element into an array of size k, it may take k compar- 
isons to find the insertion position, and k moves to insert the element. Let T(n) denote the 
complexity for insertion sort and c denote the total number of other operations such as assign- 
ments and additional comparisons in each iteration. So, 

T(n) = (2 + c) + (2 X 2 + c) + ■ • • + (2 X (n - 1) + c) 
= 2(1 + 2 + ■•• + n - 1) + c(n - 1) 
(n - \)n 

= 2 h cm — c = n — n + cn — c 

2 

= 0(n 2 ) 



Therefore, the complexity of the insertion sort algorithm is 0(n 2 ). So, the selection sort and 
insertion sort are of the same time complexity. 
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23.4-4 Analyzing the Towers of Hanoi Problem 

The Towers of Hanoi problem presented in Listing 20.8, TowersOfHanoi.java, recursively 
moves n disks from tower A to tower B with the assistance of tower C as follows: 

1. Move the first n — 1 disks from A to C with the assistance of tower B. 

2. Move disk n from A to B. 

3. Move n — 1 disks from C to B with the assistance of tower A. 

Let T(n) denote the complexity for the algorithm that moves n disks and c denote the constant 
time to move one disk; i.e., r(l) is c. So, 

T{n) = T(n - 1) + c + T(n - 1) 
= 2T(n - 1) + c 
= 2(2T(n - 2) + c) + c 
= 2(2(2T(n - 3) + c) + c) + c 
= 2" _1 r(l) + 2"~ 2 c + ■•• + 2c + c 
= 2 n ~ l c + 2"- 2 c + ■■■ +2c + c = (2" - \)c = 0(2") 

An algorithm with 0(2") time complexity is called an exponential algorithm. As the input 0(2") 

size increases, the time for the exponential algorithm grows exponentially. Exponential algo- exponential time 

rithms are not practical for large input size. 

23.4-5 Comparing Common Growth Functions 

The preceding sections analyzed the complexity of several algorithms. Table 23.2 lists some 
common growth functions and shows how growth rates change as the input size doubles from 
n = 25 to n = 50. 

These functions are ordered as follows, as illustrated in Figure 23.1. 

0(1) < O(logn) < 0(n) < O(nlogn) < 0{n 2 ) < 0(« 3 ) < 0(2") 



Table 23.2 Change of Growth Rates 



Function 


Name 


n = 25 


n = 50 


/(50)//(25) 


0(1) 


Constant time 


1 


1 


1 


Oflog n) 


Logarithmic time 


4.64 


5.64 


1.21 


0{n) 


Linear time 


25 


50 


2 


0(«log n) 


Log-linear time 


116 


282 


2.43 


0(n 2 ) 


Quadratic time 


625 


2500 


4 


0(n 3 ) 


Cubic time 


15625 


125000 


8 


0(2") 


Exponential time 


3.36 X 10 7 


1.27 X 10 15 


3.35 X 10 7 



23.5 Case Studies: Finding Fibonacci Numbers 

Section 20.3, "Problem: Computing Fibonacci Numbers," gave a recursive method for finding 
the Fibonacci number, as follows: 

/** The method for finding the Fibonacci number */ 
public static long fib(long index) { 
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if (index == 0) // Base case 

return 0; 
else if (index == 1) // Base case 

return 1; 

else // Reduction and recursive calls 
return fib(index - 1) + fib(index - 2) ; 

} 




Figure 23.1 As the size n increases, the function grows. 



We can now prove that the complexity of this algorithm is 0(2"). For convenience, let the 
index be n. Let T{n) denote the complexity for the algorithm that finds fib(n) and c denote the 
constant time for comparing index with and 1 ; i.e., T(l) is c. So, 

T(n) = T(n - 1) + T(n - 2) + c 

< 2T(n - 1) + c 

< 2(2T(n - 2) + c) + c 
= 2 2 T(n - 2) + 2c + c 

Similar to the analysis of the Towers of Hanoi problem, we can show that T{n) is 0(2"). 

This algorithm is not efficient. Is there an efficient algorithm for finding a Fibonacci num- 
ber? The trouble in the recursive f i b method is that the method is invoked redundantly with 
the same arguments. For example, to compute fib(4), fib(3) and fib(2) are invoked. To 
compute f ib(3), f ib(2) and f ib(l) are invoked. Note that f ib(2) is redundantly invoked. 
We can improve it by avoiding repeated calling of the f i b method with the same argument. 
Note that a new Fibonacci number is obtained by adding the preceding two numbers in the 
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Figure 23.2 Variables fO, f 1, and f 2 store three consecutive Fibonacci 
numbers in the series. 
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sequence. If you use two variables fO and f 1 to store the two preceding numbers, the new 
number f 2 can be immediately obtained by adding f with f 1. Now you should update f and 
f 1 by assigning f 1 to fO and assigning f 2 to f 1, as shown in Figure 23.2. 
The new method is implemented in Listing 23.1. 

Listing 23.1 ImprovedFi bonacci . java 

1 import java. util .Scanner; 
2 

3 public class ImprovedFi bonacci { 



4 /** Main method */ 

5 public static void main(String args[]) { 

6 // Create a Scanner 

7 Scanner input = new Scanner(System . i n) ; 

8 System . out . pri nt("Enter an index for the Fibonacci number: ") ; 

9 int index = i nput . nextlnt () ; input 
10 

11 // Find and display the Fibonacci number 

12 System. out. pri ntln( 

13 "Fibonacci number at index " + index + " is " + fib(index)); invoke fib 

14 } 
15 

16 /** The method for finding the Fibonacci number */ 

17 public static long fib(long n) { 

18 long fO = 0; // For fib(0) fO 

19 long fl = 1; // For fib(l) fl 

20 long f2 = 1; // For fib(2) f2 
21 

22 if (n == 0) 

23 return fO; 

24 else if (n == 1) 

25 return fl; 

26 else if (n == 2) 

27 return f2; 
28 

29 for (int i =3; i <= n; i++) { 

30 fO = fl; update f0,fl,f2 

31 fl = f2; 

32 f2 = fO + fl; 

33 } 
34 

35 return f 2 ; 

36 } 



37 } 



Enter an index for the Fibonacci number: 
Fibonacci number at index 6 is 8 




Enter an index for the Fibonacci number: 
Fibonacci number at index 7 is 13 



Obviously, the complexity of this new algorithm is 0{n). This is a tremendous improve- O(n) 
ment over the recursive 0(2") algorithm. 
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23.6 Case Studies: Finding Greatest Common Divisors 

This section presents several algorithms in the search for an efficient algorithm for finding the 
greatest common divisor between two integers. 

The greatest common divisor of two integers is the largest number that can evenly divide 
both integers. Listing 4.8, GreatestCommonDivisor.java, presented a brute-force algorithm 
gcd for finding the greatest common divisor (GCD) of two integers m and n. The algorithm checks 

whether k (for k = 2, 3, 4, and so on) is a common divisor for nl and n2, until k is greater 
than nl or n2. The algorithm can be described as follows: 

public static int gcd(int m, int n) { 
int gcd = 1; 

for (int k = 2; k <= m && k <= n; k++) { 
if (m % k == && n % k == 0) 
gcd = k; 

} 

return gcd; 

} 

assume m a « Assuming m > n, the complexity of this algorithm is obviously 0(n). 

0(n) Is there any better algorithm for finding the gcd? Rather than searching a possible divisor 

from 1 up, it is more efficient to search from n down. Once a divisor is found, the divisor is 
improved solutions the gcd. So you can improve the algorithm using the following loop: 

for (int k = n; k >= 1; k--) { 
if (m % k == && n % k == 0) { 
gcd = k; 
break; 

} 

} 

This algorithm is better than the preceding one, but its worst-case time complexity is still 
0(ii). 

A divisor for a number n cannot be greater than n / 2 . So you can further improve the 
algorithm using the following loop: 

for (int k=m/2; k>=l; k--) { 
if (m % k == && n % k == 0) { 
gcd = k; 
break; 

} 

} 

However, this algorithm is incorrect, because n can be a divisor for m. This case must be con- 
sidered. The correct algorithm is shown in Listing 23.2. 



Listing 23.2 GCD1 . j ava 



1 import java.util .Scanner; 

2 

3 public class GCD1 { 

4 /** Find gcd for integers m and n */ 

5 public static int gcd(int m, int n) { 

6 int gcd = 1; 
7 

check divisor 8 i f (m % n == 0) return n; 

9 
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10 for (int k=n/2; k>=l; k--) { 

11 if (m % k == && n % k == 0) { 

12 gcd = k; gcd found 

13 break; 

14 } 

15 } 
16 

17 return gcd; 

18 } 
19 

20 /** Main method */ 

21 public static void main(String[] args) { 

22 // Create a Scanner 

23 Scanner input = new Scanner(System.in) ; 
24 

25 // Prompt the user to enter two integers 

26 System . out . pri nt("Enter first integer: ") ; 

27 int m = i nput . nextlntO ; input 

28 System . out . pri nt("Enter second integer: ") ; 

29 int n = i nput . nextlntO ; input 
30 

31 System. out. pri ntl n("The greatest common divisor for " + m + 

32 " and " + n + " is " + gcd(m, n)); 

33 } 

34 } 



Enter first integer: 2525 
Enter second integer: 125 
The greatest common divisor for 2525 and 125 is 25 



Enter first integer: 3 
Enter second integer: 3 
The greatest common divisor for 3 and 3 is 3 



Assuming m > n, the for loop is executed at most n / 2 times, which cuts the time by half 
from the previous algorithm. The time complexity of this algorithm is still 0(n), but practi- O(n) 
cally, it is much faster than the algorithm in Listing 4.8. 

§ Note 

The Big notation provides a good theoretical estimate of algorithm efficiency. However, two 
algorithms of the same time complexity are not necessarily equally efficient. As shown in the pre- 
ceding example, both algorithms in Listings 4-8 and 23.2 have the same complexity, but in 

practice the one in Listing 23.2 is obviously better. practical consideration 

A more efficient algorithm for finding gcd was discovered by Euclid around 300 B.C. This 
is one of the oldest known algorithms. It can be defined recursively as follows: improved solutions 

Let gcd(m , n) denote the gcd for integers m and n: 

■ If m % n is 0, gcd (m , n) is n. 

■ Otherwise, gcd Cm, n)isgcd(n, m%n). 

It is not difficult to prove the correctness of the algorithm. Suppose m % n = r. So, m = qn + r, 
where q is the quotient of m / n. Any number that is divisible by m and n must also be divisible 
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base case 



reduction 



input 
input 



by r. Therefore, gcd(m , n) is the same as gcd(n , r), where r = m % n. The algorithm can 
be implemented as in Listing 23.3. 

Listing 23.3 GCD2.java 

1 import java.util .Scanner; 



2 

3 


public class GCD2 { 




4 


/' 


•'* Find gcd for integers m and n */ 




5 


public static int gcd(int m, int n) { 




6 




if (m % n == 0) 




7 




return n; 




8 




el se 




9 




return gcd(n, m % n) ; 




10 


} 






11 








12 


/' 


'* Main method */ 




13 


public static void main(String[] args) { 




14 




// Create a Scanner 




15 




Scanner input = new Scanner(System.in) ; 




16 








17 




// Prompt the user to enter two integers 


18 




System . out . pri nt("Enter first integer: 


'); 


19 




int m = i nput . nextlnt() ; 




20 




System . out . pri nt("Enter second integer: 


"); 


21 




int n = i nput . nextlnt() ; 




22 








23 




System. out. pri ntln ("The greatest common 


divisor 


24 




" and " + n + " is " + gcd(m, n)); 




25 


} 






26 


} 







Enter first integer: 2525 |^ Enter 
Enter second integer: 125 |^ Eriter 

The greatest common divisor for 2525 and 125 is 25 



Enter first integer: 3 ^ Enter 

Enter second integer: 3 |* j _ E " ter 

The greatest common divisor for 3 and 3 is 3 



best case 
average case 
worst case 



In the best case when m % n is 0, the algorithm takes just one step to find the gcd. It is difficult 
to analyze the average case. However, we can prove that the worst-case time complexity is 
O(logn). 

Assuming m > n, we can show that m % n < m / 2, as follows: 

■ If n <= m / 2, m % n < m / 2, since the remainder of m divided by n is always less than n. 

■ Ifn>m/2, m%n = m- n<m/2. Therefore, m % n < m / 2. 

Euclid's algorithm recursively invokes the gcd method. It first calls gcd Cm, n), then calls 
gcdCn , m % n), and gcdCm % n , n % Cm % n)), and so on, as follows: 

gcd(m, n) 
= gcd(n, m % n) 
= gcd(m % n, n % (m % n)) 
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Since m % n < m / 2 and n % (m % n) < n / 2, the argument passed to the gcd method is reduced 

by half after every two iterations. After invoking gcd two times, the second parameter is less 

than nl2. After invoking gcd four times, the second parameter is less than n/4. After invoking 

n 

gcd six times, the second parameter is less than — r. Let k be the number of times the gcd method 

n 

is invoked. After invoking gcd k times, the second parameter is less than 7j^j > which is 
greater than or equal to 1 . That is, ^ 

— — — > 1 => n > 2 (A:/2) => log«>/fc/2 => £<21og« 

2' / ) 

Therefore, k < 2 log n. So, the time complexity of the gcd method is 0(logn). 

The worst case occurs when the two numbers result in most divisions. It turns out that two 
successive Fibonacci numbers will result in most divisions. Recall that the Fibonacci series 
begins with and 1, and each subsequent number is the sum of the preceding two numbers in 
the series, such as: 

1 1 2 3 5 8 13 21 34 55 89 ... 



The series can be recursively defined as 

fib(O) = 0; 
fib(l) = 1; 

fib(index) = fib (index - 2) + fib (index - 1); index >= 2 

For two successive Fibonacci numbers fib(index) and f ib(index -1), 

gcd(fib(index) , fib(index - 1)) 

= gcd(fi b(i ndex - 1), fib(index - 2)) 

= gcd(fi b(i ndex - 2), fib(index - 3)) 

= gcd(fi b(i ndex - 3), fib(index - 4)) 

= gcd(fib(2), fib(l)) 
= 1 

For example, 

gcd(21, 13) 
= gcd(13, 8) 
= gcd(8, 5) 
= gcd(5, 3) 
= gcd(3, 2) 
= gcd (2, 1) 
= 1 

So, the number of times the gcd method is invoked is the same as the index. We can prove that 
index < 1.44 log n, where n = fib(index — 1 ). This is a tighter bound than index — 2 log n. 
Table 23.3 summarizes the complexity of three algorithms for finding the gcd. 



Table 23.3 Comparisons of GCD Algorithms 

Listing 4.8 Listing 23.2 Listing 23.3 



Complexity 0(n) O(n) 0(log n) 



778 Chapter 23 Algorithm Efficiency 



what is prime? 



23.7 Case Studies: Finding Prime Numbers 

A $100,000 award awaits the first individual or group who discovers a prime number with at 
least 10,000,000 decimal digits (www.eff.org/awards/coop.php). This section presents several 
algorithms in the search for an efficient algorithm for finding the prime numbers. 

An integer greater than 1 is prime if its only positive divisor is 1 or itself. For example, 2, 
3, 5, and 7 are prime numbers, but 4, 6, 8, and 9 are not. 

How do you determine whether a number n is prime? Listing 4.14 presented a brute-force 
algorithm for finding prime numbers. The algorithm checks whether 2, 3, 4, 5, . . . , or n - 1 
is divisible by n. If not, n is prime. This algorithm takes 0(n) time to check whether n is 
prime. Note that you need to check only whether 2, 3, 4, 5, . . . , and n/2 is divisible by n. If 
not, n is prime. The algorithm is slightly improved, but it is still of 0{ri). 

In fact, we can prove that if n is not a prime, n must have a factor that is greater than 1 and 
less than or equal to\/w. Here is the proof. Since n is not a prime, there exist two numbers p 
and q such that n = pq with 1 < p S q. Note that n = \fri\fn. p must be less than or equal 
to yn. Hence, you need to check only whether 2, 3, 4, 5, . . . , or Vn is divisible by n. If not, 
n is prime. This significantly reduces the time complexity of the algorithm to o(\4). 

Now consider the algorithm for finding all the prime numbers up to n. A straightforward 
implementation is to check whether i is prime for i = 2, 3, 4, . . . , n. The program is given in 
Listing 23.4. 



Listing 23.4 PrimeNumbers . java 



check prime 



increase count 



5 
6 
7 
8 
9 
10 
11 
12 
13 
14 
15 
16 
17 
18 
19 
20 
21 
22 
23 
24 
25 
26 
27 
28 
29 
30 
31 
32 
33 
34 



1 import java. util .Scanner; 
2 

3 public class PrimeNumbers { 

4 public static void main(String[] args) { 
Scanner input = new Scanner(System.in) ; 
System . out . pri nt("Find all prime numbers <= n, enter n: 
int n = i nput . nextlntQ ; 



); 



final int NUMBER_PER_LINE =10; // Display 10 per line 
int count = 0; // Count the number of prime numbers 
int number =2; //A number to be tested for primeness 

System. out. println("The prime numbers are:"); 

// Repeatedly find prime numbers 
while (number <= n) { 

// Assume the number is prime 

boolean isPrime = true; // Is the current number prime? 
// Test if number is prime 

for (int divisor = 2; divisor <= (int) (Math . sqrt(number)) ; 
divisor++) { 

if (number % divisor == 0) { // If true, number is not prime 
isPrime = false; // Set isPrime to false 
break; // Exit the for loop 

} 

} 

// Print the prime number and increase the count 
if (isPrime) { 

count++; // Increase the count 

if (count % NUMBER_PER_LINE == 0) { 

// Print the number and advance to the new line 
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35 System . out . pri ntf("%7d\n" , number); 

36 } 

37 else 

38 System. out. pri ntf ("%7d" , number); 

39 } 
40 

41 // Check if the next number is prime check next number 

42 number++; 

43 } 
44 

45 System. out. pri ntl n("\n" + count + 

46 " prime(s) less than or equal to " + n) ; 



47 } 

48 } 



Find all prime numbers <= 


n, enter n: 1000 










The prime numbers are: 












2 3 5 


7 11 13 


17 


19 


23 


29 


31 37 41 


43 47 53 


59 


61 


67 


71 


168 prime(s) less than or 


equal to 1000 











The program is not efficient if you have to compute Math . sqrt (number) for every iteration 
of the for loop (line 21). A good compiler should evaluate Math . sqrt(number) only once 
for the entire for loop. To ensure this happens, you may explicitly replace line 21 by the fol- 
lowing two lines: 

int squareRoot = (int) (Math . sqrt(number)) ; 

for (int divisor = 2; divisor <= squareRoot; divisor++) { 

In fact, there is no need to actually compute Math . sqrt(number) for every number. You 
need look only for the perfect squares such as 4, 9, 16, 25, 36, 49, and so on. Note that for all 
the numbers between 36 and 48, inclusively, their (int) (Math . sqrt (number)) is 6. With 
this insight, you can replace the code in lines 16-26 with the following: 

int squareRoot = 1; 

// Repeatedly find prime numbers 
while (number <= n) { 

// Assume the number is prime 

boolean isPrime = true; // Is the current number prime? 
if (squareRoot * squareRoot < number) squareRoot++; 

// Test if number is prime 

for (int divisor = 2; divisor <= squareRoot; divisor++) { 
if (number % divisor == 0) { // If true, number is not prime 
isPrime = false; // Set isPrime to false 
break; // Exit the for loop 

} 

} 

Now we turn our attention to analyzing the complexity of this program. Since it takes yi 
steps in the for loop (lines 21-27) to check whether number i is prime, the algorithm takes 
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V2 + V3 + V4 + • ■ • + \/n steps to find all the prime numbers less than or equal to n. 
Observe that 

V2 + V3 + V4 + ■•• + \4< nVn 



check prime 



Therefore, the time complexity for this algorithm is Oynvnj. 

To determine whether i is prime, the algorithm checks whether 2, 3, 4, 5, . . . , and \fi are 
divisible by i. This algorithm can be further improved. In fact, you need to check only whether 
the prime numbers from 2 to are possible divisors for i. 

We can prove that if i is not prime, there must exist a prime number p such that i = pq and 
p < q. Here is the proof. Assume that i is not prime; let p be the smallest factor of ;. p must 
be prime, otherwise, p has a factor k with 2 < k < p. k is also a factor of i, which contradicts 
that p be the smallest factor of Therefore, if i is not prime, you can find a prime number 
from 2 to that is divisible by i. This leads to a more efficient algorithm for finding all 
prime numbers up to n, as shown in Listing 23.5. 

Listing 23.5 EfficientPrimeNumbers. java 

import java. util .Scanner; 



increase count 



1 
2 
3 
4 
5 
6 
7 
8 
9 
10 
11 
12 
13 
14 
15 
16 
17 
18 
19 
20 
21 
22 
23 
24 
25 
26 
27 
28 
29 
30 
31 
32 
33 
34 
35 
36 
37 
38 
39 
40 



public class EfficientPrimeNumbers { 

public static void main(String[] args) { 
Scanner input = new Scanner(System . i n) ; 

System . out . pri nt("Find all prime numbers <= n, enter n: ") ; 
int n = i nput . nextlntO ; 

// A list to hold prime numbers 
java. uti 1 . Li st<Integer> list = 

new java. uti 1 .ArrayLi st<Integer>() ; 

final int NUMBER_PER_LINE = 10; // Display 10 per line 
int count = 0; // Count the number of prime numbers 
int number =2; //A number to be tested for primeness 
int squareRoot = 1; // Check whether number <= squareRoot 

System. out. println("The prime numbers are \n") ; 

// Repeatedly find prime numbers 
while (number <= n) { 

// Assume the number is prime 

boolean isPrime = true; // Is the current number prime? 

if (squareRoot * squareRoot < number) squareRoot++; 

// Test whether number is prime 
for (int k = 0; k < list.sizeO 
&& list.get(k) 
if (number % list.get(k) == 0) 

isPrime = false; // Set isPrime to false 
break; // Exit the for loop 

} 

} 

// Print the prime number and increase the count 
if (isPrime) { 

count++; // Increase the count 

1 i st . add(number) ; // Add a new prime to the list 
if (count % NUMBER_PER_LINE == 0) { 



<= squareRoot; k++) { 

{ // If true, not prime 
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41 // Print the number and advance to the new line 

42 System. out. pri ntl n(number) ; 

43 } 

44 el se 

45 System. out. print(number + " ") ; 

46 } 
47 

48 // Check whether the next number is prime 

49 number++; check next number 

50 } 
51 

52 System. out. pri ntl n("\n" + count + 

53 " prime(s) less than or equal to " + n) ; 



54 } 

55 } 



Find all prime numbers 


<= n, enter n: 1000 


•J Enter 








The prime numbers are: 












2 3 5 


7 11 13 


17 


19 


23 


29 


31 37 41 


43 47 53 


59 


61 


67 


71 


168 prime(s) less than 


or equal to 1000 











Let Tr(i) denote the number of prime numbers less than or equal to i. The primes under 20 are 
2, 3, 5, 7, 11, 13, 17, and 19. So, tt(2) is 1, 77(3) is 2, 77(6) is 3, and tt(20) is 8. It has been 

i 

proved that ir(i) is approximately (see primes.utm.edu/howmany.shtml). 

log; 

For each number i , the algorithm checks whether a prime number less than or equal to Vi 
is divisible by z. The number of the prime numbers less than or equal to Vi is 

Vi iVi 

-p = . Thus, the complexity for finding all prime numbers up to n is 

log Vi lo S * 

2V2 2V3 2V4 2V5 2V6 2V7 2V8 iVn 

H H H H H H + ••• H 

log 2 log 3 log 4 log 5 log 6 log 7 log 8 log n 



V 1 v n 

Since < for i < n and n > 16, 

log i log n 

2V2 2V3 2V4 2V5 2V6 2V7 2V8 iVn 2nVn 

H H H H H H + ••• H < 

log 2 log 3 log 4 log 5 log 6 log 7 log 8 log n log n 

Therefore, the complexity of this algorithm is CM 



nw n 



log « 
fnVn\ 

Is there any algorithm better than 0\ ? Let us examine the well-known Eratosthenes 

\ log n J 

algorithm for finding prime numbers. Eratosthenes (276-194 B.C.) was a Greek mathemati- 
cian who devised a clever algorithm, known as the Sieve of Eratosthenes, for finding all prime Sieve of Eratosthenes 
numbers <«. His algorithm is to use an array named primes of n Boolean values. Initially, 
all elements in primes are set true. Since the multiples of 2 are not prime, set primes[2 * 
i] to false for all 2 < i < n/2, as shown in Figure 23.3. Since we don't care about 
pri mes [0] and pri mes [1] , these values are marked X in the figure. 
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primes array 



index 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 
initial XXTTTTTTTTTT T T TTT TT TTT T T T T T T 
k = 2 xxTTFTFT FTFT F T F TF TF TFT FT FT FT 

£ = 3 xxttftft ffft f t f fftftff ft ft f f 
^ = 5 X x(t)(t)f(t)f(t)fff(t)f(t)f ff(t)f(t)ff f(t)ffff 

Figure 23.3 The values in primes are changed with each prime number k. 

Since the multiples of 3 are not prime, set pr i mes [3 * i ] to f al se for all 3 s i : < n /3. 
Since the multiples of 5 are not prime, set primes[5 * i] to false for all 5 ^ i ' ^ n/5. 
Note that you don't need to consider the multiples of 4, because the multiples of 4 are also the 
multiples of 2, which have already been considered. Similarly, multiples of 6, 8, 9 need not be 
considered. You only need to consider the multiples of a prime number k = 2, 3, 5, 7, 11, . . . , 
and set the corresponding element in primes to false. Afterward, if primes[i] is still 
true, then i is a prime number. As shown in Figure 23.3, 2, 3, 5, 7, 11, 13, 17, 19, 23 are 
prime numbers. Listing 23.6 gives the program for finding the prime numbers using the Sieve 
of Eratosthenes algorithm. 

Listing 23.6 Si eveOf Eratosthenes, java 

1 import java. util .Scanner; 
2 

3 public class Si eveOf Eratosthenes { 

4 public static void main(String[] args) { 

5 Scanner input = new Scanner(System . i n) ; 

6 System . out . pri nt("Find all prime numbers <= n, enter n: ") ; 

7 int n = i nput . nextlntQ ; 



initialize sieve 



nonpnme 



sieve 



8 
9 
10 
11 
12 
13 
14 
15 
16 
17 
18 
19 
20 
21 
22 
23 
24 
25 
26 
27 
28 
29 
30 
31 
32 
33 
34 
35 
36 



int count = 0; // Count the number of prime numbers found so far 
// Print prime numbers 

for (int i = 2; i < pri mes . 1 ength ; i++) { 



// Initialize primes[i] to true 

for (int i = 0; i < pri mes . 1 ength ; i++) { 



boolean[] primes = new boolean[n +1]; // Prime number sieve 



} 

} 



for (int k = 2; k <= n / k; k++) { 
if (primes[k]) { 

for (int i = k; i <= n / k; i++) { 

pri mes [k * i] = false; // k * i is not prime 

} 

} 

} 



primes [i] = true; 

} 



System. out. pri ntl n("\n" + count + 



if (primes[i]) { 



el se 



if (count % 10 == 0) 



count++; 



System. out. pri ntf ("%7d" , i); 



System. out. pri ntf("%7d\n", i) ; 
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37 " prime(s) less than or equal to " + n) ; 

38 } 

39 } 



Find all prime numbers 


<= n, enter n: 1000 


* — ' Enter 








The prime numbers are: 












2 3 5 


7 11 13 


17 


19 


23 


29 


31 37 41 


43 47 53 


59 


61 


67 


71 


168 prime(s) less than 


or equal to 1000 











Note that k <= n / k (line 16). Otherwise, k * i would be greater than n (line 19). What is the 
time complexity of this algorithm? 

For each prime number k (line 17), the algorithm sets primes [k * i] to fal se (line 19). 
This is performed n / k - k + 1 times in the for loop (line 18). Thus, the complexity for find- 
ing all prime numbers up to n is 

n n n n n 

2 + 1H 3+1H 5 + 1H 7 + 1+ 11 + 1... 

2 3 5 7 11 

( n n n n n \ , , ss 

= 01- + - + - + - + — + ■■■ < Oimrin)) 
V2 3 5 7 11 / v v. " 



n 

Ol n 



log n 

( n V n 

This upper bound 0\ is very loose. The actual time complexity is much better than 

V log n J 

fnVn\ 

0\ . The Sieve of Eratosthenes algorithm is good for a small n such that the array 

\ log fl J 

primes can fit in the memory. 

Table 23.4 summarizes the complexity of three algorithms for finding all prime numbers 

up to n. 

Table 23.4 Comparisons of Prime-Number Algorithms 

Listing 4.14 Listing 23.4 Listing 23.5 Listing 23.6 

nvn\ ( nyn 



Complexity ( M 2) o(nVn) 0[- O 



log n } \ l°g " 



23.8 Case Studies: Closest Pair of Points 

Given a set of points, the closest-pair problem is to find the two points that are nearest to each 
other. Section 7.3, "Problem: Finding a Closest Pair," presented an intuitive algorithm for 
finding a closest pair of points. The algorithm computes the distances between all pairs of 
points and finds the one with the minimum distance. Clearly, the algorithm takes 0(n 2 ) time. 
Can you beat this algorithm? 

One approach you can use is to divide and conquer, as described in Listing 23.7: 

Listing 23.7 Algorithm for Finding a Closest Pair 

Step 1: Sort the points in increasing order of x-coordi nates . For the 
points with the same x-coordi nates , sort on y-coordi nates . This results 
in a sorted list S of points. 
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Step 2: Divide S into two subsets Si and S2 of the equal size using the 
midpoint in the sorted list. Let the midpoint be in Si. Recursively find 
the closest pair in Si and S2. Let d 1 and di denote the distance of the 
closest pairs in the two subsets, respectively. 

Step 3: Find the closest pair between a point in Si and a point in S2 and 
denote their distance to be c/3. The closest pair is the one with the 
distance mi n(di, d^ , c/3) . 

Selection sort and insertion sort take 0(n 2 ) time. In Chapter 24 we will introduce merge sort and 
heap sort. These sorting algorithms take O(nlogn) time. So, Step 1 can be done in 0(n\ogn) time. 

Step 3: can be done in 0(n) time. Let d = min(<ij, d^). We already know that the closest- 
pair distance cannot be larger than d. For a point in S\ and a point in S2 to form a closest pair in 
S, the left point must be in stripL and the right point in stripR, as pictured in Figure 23.4(a). 



stri pL 



r 

stri pR 



mid 



(a) 



stri pL 



stri pRi 



-4 



(b) 



istri pL 


stri pR 1 


1 • 
1 • 


• 


I p 

1 • 


• 1 

• 






1 • 


• 1 
• 1 



(e) 



Figure 23.4 The midpoint divides the points into two sets of equal size. 



Further, for a point p in stripL, you need only consider a right point within the d X 2d rec- 
tangle, as shown in 23.2(b). Any right point outside the rectangle cannot form a closest pair with p. 
Since the closest-pair distance in S2 is greater than or equal to d, there can be at most six points in 
the rectangle. So, for each point in stripL, at most six points in stripR need to be considered. 

For each point p in stri pL, how do you locate the points in the corresponding d X 2d rectangle 
area in stripR? This can be done efficiently if the points in stripL and stripR are sorted in 
increasing order of their y-coordinates. Let poi ntsOrderedOnY be the list of the points sorted in 
increasing order of ^-coordinates, poi ntsOrderedOnY can be obtained beforehand in the algorithm. 
stripL and stripR can be obtained from poi ntsOrderedOnY in Step 3 as shown in Listing 23.8 

Listing 23.8 Algorithm for obtaining stripL and stripR 

1 for each point p in poi ntsOrderedOnY 

2 if (p is in SI and mid.x - p.x <= d) 
stripL 3 append p to stripL; 

4 else if (p is in S2 and p.x - mid.x <= d) 
stripR 5 append p to stripR; 

Let the points in stripL and stripR be {pq, p\,..., p^} and {q , gj, . . . , q t }. A closest pair 
between a point in stri pL and a point in stri pR can be found using the algorithm described 
in Listing 23.9. 

Listing 23.9 Algorithm for Finding a Closest Pair in 
Step 3 

1 d = minCdl, d2) ; 

2 r = 0; // r is the index in stripR 
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3 for (each point p "in stn'pL) { 

4 // Skip the points below the rectangle area 

5 while (r < stri pR. 1 ength && q[r].y <= p.y - d) 

6 r++; 
7 

8 let rl = r; 

9 while (rl < stripR. length && |q[rl].y - p.y| <= d) { 

10 // Check if (p, q[rl]) is a possible closest pair 

11 if (distanced, q[rl]) < d) { 

12 d = distance(p, q[rl]); update closest pair 

13 (p, q[rl]) is now the current closed pair; 

14 } 
15 

16 rl = rl + 1; 

17 } 

18 } 

The points in stripL are considered from po, p\, . . . , p% in this order. For a point p in 
stripL, skip the points in stripR that are below p.y - d (lines 5-6). Once a point is 
skipped, it will no longer be considered. The while loop (lines 9-17) checks whether (p, 
q[rl]) is a possible closest pair. There are at most six such q[rl]'s. So, the complexity for 
finding a closest pair in Step 3 is 0(ri). 

Let T(n) denote the time complexity for the algorithm. So, 

T(n) = 2T(n/2) + O(n) = 0{n log n) 

Therefore, a closest pair of points can be found in 0(nlog n) time. The complete implementa- 
tion of this algorithm is left as an exercise (see Exercise 23.9). 

23.9 Preview of Other Algorithms 

The examples in this chapter have demonstrated how to analyze and design efficient algo- 
rithms for several well-known problems. Chapter 24 will introduce efficient algorithms for 
internal and external sorting. Chapter 25 will introduce efficient algorithms for implement- 
ing lists, stacks, and queues. Chapter 26 will introduce efficient algorithms for implement- 
ing trees, heaps, and priority queues. Chapters 27-28 will introduce efficient algorithms and 
data structures for graph problems. Chapters 45-47 will introduce AVL trees, splay trees, 2- 
3 trees, B-trees, and red-black trees. Chapter 48 will introduce hashing. For the algorithms 
in these chapters, we will also analyze their complexities. Recurrence relations are a useful 
tool for analyzing algorithm complexity. Table 23.5 summarizes the common recurrence 
relations. 



Table 23.5 Common Recurrence Functions 



Recurrence Relation 


Result 




Example 


T{n) 


= T(n/2) + 0(1) 


T(n) = 


0(log n) 


Binary search, Euclid's GCD 


T{n) 


= T(n - 1) + 0(1) 


T(n) = 


0(77) 


Linear search 


T(n) 


= 27/(77/2) + 0(1) 


T(n) = 


0(77) 




T(n) 


= 2T{n/2) + 0(n) 


T(n) = 


0(7! log 7!) 


Merge sort (Chapter 26) 


T{n) 


= 27/(n/2) + 0(n log n) 


T(n) = 


0(77 log 2 77) 




T{n) 


= T(n - 1) + 0(n) 


T(n) = 


0(77 2 ) 


Selection sort, insertion sort 


T(n) 


= 27/(n - 1) + 0(1) 


T(n) = 


0(2") 


Towers of Hanoi 


T(n) 


= T(n - 1) + T{n - 2) + 0(1) 


T(n) = 


0(2") 


Recursive Fibonacci algorithm 
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average-case analysis 766 
best-case analysis 766 
Big O notation 766 
constant time 767 
exponential time 77 1 



growth rate 766 
logarithmic time 770 
quadratic time 768 
worst-case analysis 766 



Chapter Summary 



1 . The Big O notation is a theoretical approach for analyzing the performance of an 
algorithm. It estimates how fast an algorithm's execution time increases as the input 
size increases. So you can compare two algorithms by examining their growth rates. 

2. An input that results in the shortest execution time is called the best-case input and 
one that results in the longest execution time is called the worst-case input. Best case 
and worst case are not representative, but worst-case analysis is very useful. You can 
be assured that the algorithm will never be slower than the worst case. 

3. An average-case analysis attempts to determine the average amount of time among 
all possible input of the same size. Average-case analysis is ideal, but difficult to per- 
form, because for many problems it is hard to determine the relative probabilities and 
distributions of various input instances. 

4- If the time is not related to the input size, the algorithm is said to take constant time 
with the notation 0(1). 

5 . Linear search takes 0(n) time. An algorithm with the 0(n) time complexity is called 
a linear algorithm. Binary search takes O(logn) time. An algorithm with the O(logn) 
time complexity is called a logarithmic algorithm. 

6. The worst-time complexity for selection sort and insertion sort is 0( n 2 ) . An algorithm 
with the 0(n 2 ) time complexity is called a quadratic algorithm. 

7. The time complexity for the Towers of Hanoi problem is 0(2"). An algorithm with 
the 0(2") time complexity is called an exponential algorithm. 

8. A Fibonacci number at a given index can be found in 0(n) time. 

9. Euclid's gcd algorithm takes 0(\ogn) time. 



1 0. All prime numbers less than or equal to n can be found in O 




) 



time. 



Review Questions 



Sections 23.2 



23.1 Put the following growth functions in order: 



4032 



, 44 log n, 10/1 log n, 500, 2n z , — , 3n 



23.2 Count the number of iterations in the following loops. 
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int count = 1; 




while (count < 30) 


{ 


count = count * 


2; 


} 





(a) 


int count = 1; 




while (count < n) 


{ 


count = count * 


2; 


} 





int count = 15; 




while (count < 30) 


{ 


count = count * 


3; 


} 




(b) 


int count = 15; 




while (count < n) 


{ 


count = count * 


3; 


} 





(c) 



Id) 



23.3 How many stars are displayed in the following code if n is 10? How many if n is 
20? Use the Big O notation to estimate the time complexity. 



for (int i =0; i < n; i++) { 
System. out. printC * ') ; 

} 



for (int i = 0; 


i < n ; 


{ 


for (int j = 


0; j < 


n; j++) { 


System. out. 


pri nt( ' 


*'); 


} 






} 







for (int k = 0; k < n; k++) { 




for (int k = 0; k < 10; k++) { 


for (int i =0; i < n; i++) { 




for (int i = 0; i < n; i++) { 


for (int j = 0; j < n; j++) { 




for (int j = 0; j < n; j++) { 


System. out. printC*') ; 




System. out . pri nt( ' - ' ) ; 


} 




} 


} 




} 


} 




} 



23.4 Use the Big O notation to estimate the time complexity of the following methods: 



public static void mA(int n) { 
for (int i =0; i < n; i++) { 
System. out . pri nt(Math . random ()) ; 

} 

} 



public static void mB(int n) { 
for (int i =0; i < n; i++) { 
for (int j = 0; j < i; j++) 

System. out . pri nt(Math . random ()) ; 

} 

} 



public static void mC(int[] m) { 

for (int i =0; i < m. length; i++) { 
System. out. print(m[i]) ; 

} 

for (int i = m. length - 1; i >= 0; ) 
{ 

System. out. print(m[i]) ; 

i — ; 

} 



public static void mD(int[] m) { 

for (int i =0; i < m. length; i++) { 
for (int j = 0; j < i; j++) 
System. out. pn'nt(m[i] * m[j]); 

} 

} 



23.5 Estimate the time complexity for adding two n X m matrices, and for multiplying 
an n X m matrix by an m X k matrix. 
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23.6 Analyze the following sorting algorithm: 

for (int i = 0; i < list. length -1; { 
if (list[i] > list[i + 1]) { 
swap list[i] with list[i + 1] ; 
i = -1; 

} 

} 

23.7 Example 7 in §23.3 assumes n = 2 . Revise the algorithm for an arbitrary n and 
prove that the complexity is still 0(log«). 



Programming Exercises 

23.1* {Maximum consecutive increasingly ordered substring) Write a program that 
prompts the user to enter a string and displays the maximum consecutive increas- 
ingly ordered substring. Analyze the time complexity of your program. Here is a 
sample run: 



Enter 
Wei 



a string: Welcome 



23.2** {Maximum increasingly ordered subsequence) Write a program that prompts the 
user to enter a string and displays the maximum increasingly ordered substring. 
Analyze the time complexity of your program. Here is a sample run: 




23.3* {Pattern matching) Write a program that prompts the user to enter two strings and 
tests whether the second string is a substring in the first string. Suppose the neigh- 
boring characters in the string are distinct. (Don't use the indexOf method in 
the String class.) Analyze the time complexity of your algorithm. Your algo- 
rithm needs to be at least 0(n) time. Here is a sample run of the program: 



Enter a 


string si: 


Welcome to Dava |H Enter 


Enter a 


string s2: 


COme |^ Enter 


matched 


at index 3 





23.4* {Pattern matching) Write a program that prompts the user to enter two strings and 
tests whether the second string is a substring in the first string. (Don't use the 
indexOf method in the String class.) Analyze the time complexity of your 
algorithm. Here is a sample run of the program: 



Enter a 


string si: 


Mississippi ^mer 


Enter a 


string s2: 


Sip ^ Enter 


matched 


at i ndex 6 
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23.5* (Same-number subsequence) Write an 0{n) program that prompts the user to 
enter a sequence of integers ending with and finds longest subsequence with the 
same number. Here is a sample run of the program: 



Enter a series of numbers ending with 0: 

24488882440 
The longest same number sequence starts at index 

3 with 4 values of 8 



23.6* (Execution time for GCD) Write a program that obtains the execution time for 
finding the GCD of every two consecutive Fibonacci numbers from the index 40 
to index 45 using the algorithms in Listings 23.2 and 23.3. Your program should 
print a table like this: 





40 


41 


42 


43 


44 


45 


Listing 
Listing 


23.2 GCD1 

23.3 GCD2 





(Hint: You can use the code template below to obtain the execution time.) 

long startTime = System . currentTi meMi 1 1 i s() ; 
perform the task; 

long endTime = System. currentTi meMi 11 i s() ; 
long executionTime = endTime - startTime; 

23.7** (Execution time for prime numbers) Write a program that obtains the execution 
time for finding all the prime numbers less than 8,000,000, 10,000,000, 
12,000,000, 14,000,000, 16,000,000, and 18,000,000 using the algorithms in List- 
ings 23.4-23.6. Your program should print a table like this: 





8000000 10000000 12000000 14000000 16000000 18000000 


Listing 


23.4 




Listing 


23.5 




Listing 


23.6 





23.8** (AH prime numbers up to 10,000,000,000) Write a program that finds all 
prime numbers up to 10 , 000 , 000 , 000. There are approximately 455,052,511 
such prime numbers. Your program should meet the following requirements: 

■ Your program should store the prime numbers in a binary data file, named 
Exercise23_8.dat. When a new prime number is found, the number is 
appended to the file. 

■ To find whether a new number is prime, your program should load the prime 
numbers from the file to an array of the 1 ong type of size 10000. If no num- 
ber in the array is a divisor for the new number, continue to read the next 
10000 prime numbers from the data file, until a divisor is found or all num- 
bers in the file are read. If no divisor is found, the new number is prime. 
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■ Since this program takes a long time to finish, you should run it as a batch 
job from a Unix machine. If the machine is shut down and rebooted, your 
program should resume by using the prime numbers stored in the binary 
data file rather than start over from the scratch. 

23.9 (Last 100 prime numbers) Exercise 23.8 stores the prime numbers in a file 
named Exercise23_8.dat. Write an efficient program that reads the last 100 
numbers in the file. 

(Hint: Don't read all numbers from the file. Skip all numbers before the last 
100 numbers in the file.) 

23.10 (Number of prime numbers) Exercise 23.8 stores the prime numbers in a file 
named Exercise23_8.dat. Write a program that finds the number of the prime 
numbers less than or equal to 10, 100, 1,000, 10,000, 100,000, 
1,000,000, 10,000,000, 100,000,000, 1,000,000,000, and 
10,000,000,000. Your program should read the data from 
Exercise23_8.dat. Note that the data file may continue to grow as more prime 
numbers are stored to the file. 

23.1 I *** (Closest pair of points) Section 23.8 introduced an algorithm for finding a 
closest pair of points using a divide-and-conquer approach. Implement the 
algorithm to meet the following requirements: 

■ Define the classes Point and CompareY in the same way as in Exercise 
22.12. 

■ Define a class named Pair with data fields pi and p2 to represent two 
points, and a method named getDistanceO that returns the distance of 
the two points. 

■ Implement the following methods: 

/** Return the distance of the closest pair of points */ 
public static Pair getCl osestPai r(double[] [] points) 

/** Return the distance of the closest pair of points */ 
public static Pair getCl osestPai r(Point[] points) 

/** Return the distance of the closest pair of points 

* in points0rdered0nX[low. .high] . This is a recursive 

* method, poi ntsOrderedOnX and poi ntsOrderedOnY are 

* not changed in the subsequent recursive calls. 

*/ 

public static Pair distance(Point[] poi ntsOrderedOnX, 
int low, int high, Point[] poi ntsOrderedOnY) 

/** Compute the distance between two points pi and p2 */ 
public static double di stance(Poi nt pi, Point p2) 

/** Compute the distance between points Cxi, yl) 

and Cx2, y2) */ 
public static double di stanceCdouble xl, double yl, 
double x2, double y2) 



Chapter 



Sorting 

Objectives 

■ To study and analyze time efficiency of various sorting algorithms (§§24.2-24.7). 

■ To design, implement, and analyze bubble sort (§24.2). 

■ To design, implement, and analyze merge sort (§24.3). 

■ To design, implement, and analyze quick sort (§24.4). 

■ To design and implement a heap (§24.5). 

■ To design, implement, and analyze heap sort (§24.5). 

■ To design, implement, and analyze bucket sort and 
radix sort (§24.6). 

■ To design, implement, and analyze external sort for large 
amounts of data in a file (§24.7). 
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24.1 Introduction 

why study sorting? Sorting is a classic subject in computer science. There are three reasons to study sorting algo- 

rithms. First, sorting algorithms illustrate many creative approaches to problem solving, and 
these approaches can be applied to solve other problems. Second, sorting algorithms are good 
for practicing fundamental programming techniques using selection statements, loops, meth- 
ods, and arrays. Third, sorting algorithms are excellent examples to demonstrate algorithm 
performance. 

what data to sort? The data to be sorted might be integers, doubles, characters, or objects. Section 6.10, 

"Sorting Arrays," presented selection sort and insertion sort for numeric values. The selection 
sort algorithm was extended to sort an array of objects in §14.10, "Sorting an Array of 
Objects." The Java API contains several overloaded sort methods for sorting primitive type 
values and objects in the java.util .Arrays and java.util .Collections class. For 
simplicity, this section assumes: 

1 . data to be sorted are integers, 

2. data are stored in an array, and 

3 . data are sorted in ascending order. 

The programs can be easily modified to sort other types of data, to sort in descending order, or 
to sort data in an Ar rayLi st or a Li nkedLi st. 

There are many algorithms for sorting. You have already learned selection sort and inser- 
tion sort. This chapter introduces bubble sort, merge sort, quick sort, bucket sort, radix sort, 
and external sort. 

§ Note 

The whole chapter is optional. No chapter in the book depends on this chapter. 



24.2 Bubble Sort 

The bubble sort algorithm makes several passes through the array. On each pass, successive 
neighboring pairs are compared. If a pair is in decreasing order, its values are swapped; other- 
wise, the values remain unchanged. The technique is called a bubble sort or sinking sort, 
because the smaller values gradually "bubble" their way to the top and the larger values sink 
to the bottom. After first pass, the last element becomes the largest in the array. After the sec- 
ond pass, the second-to-last element becomes the second largest in the array. This process is 
continued until all elements are sorted, 
bubble sort illustration Figure 24.1(a) shows the first pass of a bubble sort of an array of six elements (29548 1). 

Compare the elements in the first pair (2 and 9), and no swap is needed because they are 
already in order. Compare the elements in the second pair (9 and 5), and swap 9 with 5 
because 9 is greater than 5. Compare the elements in the third pair (9 and 4), and swap 9 with 



2|9|5|4|8|1 
2 5 9 4 8 1 
2 5 4 9 8 1 
2 5 4 8 9 1 
2 5 4 8 1 9 



2|5|4|8|l|9 
2 4 5 8 1 9 
2 4 5 8 1 9 
2 4 5 1 8 9 



2|4|5|l|5|9 
2 4 5 1 8 9 
2 4 1 5 8 9 



(a) 1st pass (b) 2nd pass (c) 3rd pass (d) 4th pass (e) 5th pass 
Figure 24.1 Each pass compares and orders the pairs of elements sequentially. 
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4. Compare the elements in the fourth pair (9 and 8), and swap 9 with 8. Compare the ele- 
ments in the fifth pair (9 and 1), and swap 9 with 1. The pairs being compared are highlighted 
and the numbers already sorted are italicized. 

The first pass places the largest number (9) as the last in the array. In the second pass, as 
shown in Figure 24.1(b), you compare and order pairs of elements sequentially. There is no 
need to consider the last pair, because the last element in the array is already the largest. In the 
third pass, as shown in Figure 24.1(c), you compare and order pairs of elements sequentially 
except the last two elements, because they are already ordered. So in the kth pass, you don't 
need to consider the last k — 1 elements, because they are already ordered. 

The algorithm for bubble sort can be described in Listing 24. 1 : algorithm 

Listing 24-1 Bubble Sort Algorithm 

1 for (int k = 1; k < list. length; k++) { 



2 // Perform the kth pass 

3 for (int i = 0; i < list. length - k; i++) { 

4 if (list[i] > list[i + 1]) 

5 swap list[i] with list[i + 1]; 

6 } 



7 } 

Note that if no swap takes place in a pass, there is no need to perform the next pass, because 
all the elements are already sorted. You may use this property to improve the preceding algo- 
rithm as in Listing 24.2. 

Listing 24-2 Improved Bubble Sort Algorithm 

1 boolean needNextPass = true; 

2 for (int k = 1; k < list. length && needNextPass; k++) { 



3 // Array may be sorted and next pass not needed 

4 needNextPass = false; 

5 // Perform the kth pass 

6 for (int i = 0; i < list. length - k; i++) { 

7 if (list[i] > list[i + 1]) { 

8 swap list[i] with list[i + 1]; 

9 needNextPass = true; // Next pass still needed 

10 } 

11 } 



12 } 

The algorithm can be implemented as in Listing 24.3: 

Listing 24.3 BubbleSort. java 

1 public class BubbleSort { 



2 /** Bubble sort method */ 

3 public static void bubbl eSort(int [] list) { 

4 boolean needNextPass = true; 

5 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^ 

6 for (int k = 1; k < list. length && needNextPass; k++) { 

7 // Array may be sorted and next pass not needed 

8 needNextPass = false; 

9 for (int i = 0; i < list, length - k; i++) { perform one pass 

10 if (list[i] > list[i + 1]) { 

11 // Swap list[i] with list[i + 1] 

12 int temp = list[i] ; 

13 list[i] = list[i + 1] ; 

14 list[i + 1] = temp; 
15 
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16 needNextPass = true; // Next pass still needed 

17 } 

18 } 

19 } 

20 } 
21 

22 /** A test method */ 

23 public static void main(String[] args) { 

24 int[] list = {2, 3, 2, 5, 6, 1, -2, 3, 14, 12}; 

25 bubbleSort(list) ; 

26 for (int i = 0; i < list. length; i++) 

27 System. out. pri nt(l i st [i ] + " ") ; 

28 } 

29 } 



-2 1 2 2 3 3 5 6 12 14 



24.2.1 Bubble Sort Time 

In the best-case, the bubble sort algorithm needs just the first pass to find that the array is 
already sorted. No next pass is needed. Since the number of comparisons is n — 1 in the first 
pass, the best-case time for bubble sort is 0(n). 

In the worst case, the bubble sort algorithm requires n — 1 passes. The first pass takes 
n — 1 comparisons; the second pass takes n — 2 comparisons; and so on; the last pass takes 
1 comparison. So, the total number of comparisons is: 

(n - 1) + (n - 2) + •■• +2 + 1 

= (n-l)n = I _ n = 

2 2 2 K ' 

Therefore, the worst-case time for bubble sort is 0(n 2 ). 



24.3 Merge Sort 

The merge sort algorithm can be described recursively as follows: The algorithm divides the 
array into two halves and applies merge sort on each half recursively. After the two halves are 
sorted, merge them. The algorithm is given in Listing 24.4. 



Listing 24-4 Merge Sort Algorithm 



1 public static void mergeSort(int [] list) { 

base condition 2 if (list, length > 1) { 

sort first half 3 mergeSort(l i st [0 ... list, length / 2]); 

sort second half 4 mergeSort(l i st [1 i st . 1 ength / 2 + 1 ... 1 i st . 1 ength] ) ; 

merge two halves 5 merge list[0 ... list, length / 2] with 

6 list [list. length / 2 + 1 ... 1 ist. length] ; 

7 } 

8 } 



merge sort illustration Figure 24.2 illustrates a merge sort of an array of eight elements (29548 1 67). The original 

array is split into (2 9 5 4) and (8 16 7). Apply merge sort on these two subarrays recursively 
to split (1 9 5 4) into (1 9) and (5 4) and (8 16 7) into (8 1) and (6 7). This process continues 
until the subarray contains only one element. For example, array (2 9) is split into subarrays (2) 
and (9). Since array (2) contains a single element, it cannot be further split. Now merge (2) 
with (9) into a new sorted array (2 9); merge (5) with (4) into a new sorted array (4 5). Merge 
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split 
[2T9 



2 9 5 4 



5 4 



16 7 



split 



9 5 



merge 



split 
merge ' — y 



2 4 



merge 



59 



1 6 



1 6 7 



16 



divide 



conquer 



1 2 4 5 6 7 8 9 



Figure 24.2 Merge sort employs a divide-and-conquer approach to sort the array. 



(2 9) with (4 5) into a new sorted array (2 4 5 9), and finally merge (2 4 5 9) with (1 6 7 8) into 
a new sorted array (1 2 4 5 6 7 8 9). 

The recursive call continues dividing the array into subarrays until each subarray contains 
only one element. The algorithm then merges these small subarrays into larger sorted subar- 
rays until one sorted array results. 

The merge sort algorithm is implemented in Listing 24.5. 

Listing 24-5 MergeSort . java 

1 public class MergeSort { 



2 /** The method for sorting the numbers */ 

3 public static void mergeSort(int [] list) { 

4 if (list, length > 1) { base case 

5 // Merge sort the first half 

6 int[] firstHalf = new int [1 ist. length / 2]; 

7 System. arraycopyO i st , 0, firstHalf, 0, list. length / 2); 

8 mergeSort(f i rstHal f) ; sort first half 
9 

10 // Merge sort the second half 

11 int secondHal f Length = list. length - list. length / 2; 

12 int[] secondHalf = new int [secondHal f Length] ; 

13 System. arraycopyO ist, list. length / 2, 

14 secondHalf, 0, secondHal f Length) ; 

15 mergeSort(secondHalf) ; sort second half 
16 

17 // Merge firstHalf with secondHalf 

18 int[] temp = merge(fi rstHal f, secondHalf); merge two halves 

19 System. arraycopy (temp, 0, list, 0, temp . 1 ength) ; copy to original array 

20 } 

21 } 
22 

23 /** Merge two sorted lists */ 

24 private static int[] merge(int[] listl, int[] list2) { 

25 int[] temp = new int[listl. length + 1 i st2 . 1 ength] ; 
26 

27 int currentl = 0; // Current index in listl 

28 int current2 = 0; // Current index in list2 

29 int current3 = 0; // Current index in temp 
30 
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31 while (currentl < listl. length && current2 < list2. length) { 

32 if (listl[currentl] < 1 i st2 [current2] ) 



1 istl to temp 


33 


temp [current3++] 


= listl[currentl++] ; 




34 


el se 




1 ist2 to temp 


35 


temp [cur rent 3++] 


= Iist2[current2++] ; 





ISO 




"1 

s 




3 7 
J / 








J o 




wrnie ^currentl < iibti. lengrn^j 


rest of 1 istl to temp 


39 




temp[current3++] = 1 i stl[currentl++] ; 




40 








41 




while (current2 < 1 i st2 . 1 ength) 


rest of 1 i st2 to temp 


42 




temp[current3++] = 1 i st2 [current2++] ; 




43 








44 




return temp; 




45 


} 






46 








47 


/' 


•* A test method */ 



48 public static void main(String[] args) { 

49 int[] list = {2, 3, 2, 5, 6, 1, -2, 3, 14, 12}; 

50 mergeSort(l i st) ; 

51 for (int i = 0; i < list. length; i++) 

52 System. out. pri nt(l i st [i ] + " ") ; 

53 } 

54 } 



The mergeSort method (lines 3-21) creates a new array f i rstHal f , which is a copy of the 
first half of list (line 7). The algorithm invokes mergeSort recursively on fi rstHal f 
(line 8). The length of the fi rstHal f is list, length / 2 and the length of the 
secondHal f is 1 i st . 1 ength - 1 i st . 1 ength / 2. The new array secondHal f was cre- 
ated to contain the second part of the original array 1 i st. The algorithm invokes mergeSort 
recursively on secondHal f (line 15). After fi rstHal f and secondHal f are sorted, they 
are merged to become a new sorted array in temp (line 18). Finally, temp is assigned to the 
original array list (line 19). So, array 1 i st is now sorted. 

The merge method (lines 24-45) merges two sorted arrays. This method merges arrays 
listl and list2 into a temporary array temp. So, temp. length is listl. length + 
1 ist2 .length (line 25). currentl and current2 point to the current element to be con- 
sidered in 1 i stl and 1 i st2 (lines 27-28). The method repeatedly compares the current ele- 
ments from 1 i stl and 1 i st2 and moves the smaller one to temp, currentl is increased by 
1 (line 33) if the smaller one is in 1 istl and current2 is increased by 1 (line 35) if the 
smaller one is in 1 ist2. Finally, all the elements in one of the lists are moved to temp. If 
there are still unmoved elements in 1 istl, copy them to temp (lines 38-39). If there are still 
unmoved elements in 1 ist2, copy them to temp (lines 41^42). The method returns temp as 
the new sorted array in line 44. 

Figure 24.3 illustrates how to merge two arrays listl (2 45 9) and 1 i st2 (1 6 7 8). Ini- 
tially the current elements to be considered in the arrays are 2 and 1. Compare them and move 
the smaller element 1 to temp, as shown in Figure 24.3(a). current2 and current3 are 
increased by 1. Continue to compare the current elements in the two arrays and move the 
smaller one to temp until one of the arrays is completely moved. As shown in Figure 24.3(b), 
all the elements in 1 ist2 are moved to temp and currentl points to element 9 in 1 istl. 
Copy 9 to temp, as shown in Figure 24.3(c). 



time analysis 



24.3.1 Merge Sort Time 

Let T(n) denote the time required for sorting an array of n elements using merge sort. Without 
loss of generality, assume n is a power of 2. The merge sort algorithm splits the array into two 
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currentl 



current2 



currentl 



current2 



currentl current2 




1 

















current3 

(a) After moving 1 to temp 




1 


2 


4 


5 


6 


7 


00 | 






current3 

(b) After moving all the 

elements in 1 i st2 to temp 



Figure 24.3 Two sorted arrays are merged into one sorted array. 



current3 



(c) After moving 9 to 
temp 



subarrays, sorts the subarrays using the same algorithm recursively, and then merges the sub- 
arrays. So, 



T(n) 



+ T 



+ mergetime 



The first T[ — ] is the time for sorting the first half of the array and the second T[ — ) is the 



time for sorting the second half. To merge two subarrays, it takes at most n — 1 comparisons 
to compare the elements from the two subarrays and n moves to move elements to the tempo- 
rary array. So, the total time is 2n — 1. Therefore, 



T(n) 



+ T - I + In - 1 = 0(n log n) 



The complexity of merge sort is 0(n log n). This algorithm is better than selection sort, inser- 
tion sort, and bubble sort. The sort method in the j ava . uti 1 . Arrays class is implemented 
using a variation of the merge sort algorithm. 



0(n log n) merge sort 



24.4 Quicksort 

Quick sort, developed by C. A. R. Hoare (1962), works as follows: The algorithm selects an 
element, called the pivot, in the array. Divide the array into two parts such that all the elements 
in the first part are less than or equal to the pivot and all the elements in the second part are 
greater than the pivot. Recursively apply the quick sort algorithm to the first part and then the 
second part. The algorithm is described in Listing 24.6. 

Listing 24-6 Quick Sort Algorithm 



i 

2 
3 
4 
5 
6 
7 
8 
9 
10 



public static void quickSort(int[] list) { 
if (list. length > 1) { 
select a pivot; 

partition list into listl and list2 such that 
all elements in listl <= pivot and 
list2 > 



all elements in 
qui ckSort(l i stl) ; 
quickSort(list2) ; 



pivot 



listl 



1 i st2 



base condition 
select the pivot 
partition the list 



sort first part 
sort second part 
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how to partition 



quick sort illustration 



Each partition places the pivot in the right place. The selection of the pivot affects the perfor- 
mance of the algorithm. Ideally, you should choose the pivot that divides the two parts evenly. 
For simplicity, assume the first element in the array is chosen as the pivot. Exercise 24.4 pro- 
poses an alternative strategy for selecting the pivot. 

Figure 24.4 illustrates how to sort an array (5 29384016 7) using quick sort. Choose the 
first element 5 as the pivot. The array is partitioned into two parts, as shown in Figure 24.4(b). 
The highlighted pivot is placed in the right place in the array. Apply quick sort on two partial 
arrays (42 1 30) and then (896 7). The pivot 4 partitions (42 1 30) into just one partial array 
(0 2 1 3), as shown in Figure 24.4(c). Apply quick sort on (0 2 1 3). The pivot partitions it to 
just one partial array (2 1 3), as shown in Figure 24.4(d). Apply quick sort on (2 1 3). The 
pivot 2 partitions it to (1) and (3), as shown in Figure 24.4(e). Apply quick sort on (1). Since 
the array contains just one element, no further partition is needed. 

The quick sort algorithm is implemented in Listing 24.7. There are two overloaded 
quicksort methods in the class. The first method (line 2) is used to sort an array. The sec- 
ond is a helper method (line 6) that sorts a partial array with a specified range. 



pivot 



|5|2|9|3|8|4|0|1|6|7| (a) The original array 



pivot 

JL 



pivot 



|4|2|1|3|0|5|8|9|6|7| (b) The original array is partitioned 



pivot 



1 1 2 1 1 1 3 I 4 1 
pivot 

2 13 



(c) The partial array (4 2 1 3 0) is 
partitioned 



(d) The partial array (0 2 13) is 
partitioned 



12 3 



(e) The partial array (2 1 3) is 
partitioned 



Figure 24-4 The quick sort algorithm is recursively applied to partial arrays. 



Listing 24-7 Quicksort, java 



sort method 



helper method 



recursive call 



1 
2 
3 
4 
5 
6 
7 
8 
9 
10 
11 
12 
13 
14 
15 
16 
17 
18 
19 



public class Quicksort { 

public static void qui ckSort(int [] list) { 
qui ckSort(l i st , 0, list. length - 1); 

} 

private static void qui ckSort(int [] list, int first, int last) { 
if (last > fi rst) { 

int pivotlndex = partitionfjist, first, last); 
qui ckSortO i st , first, pivotlndex - 1); 
qui ckSort(l i st , pivotlndex + 1, last); 

} 

} 

/** Partition the array 1 i st [fi rst . . 1 ast] */ 

private static int partition(int[] list, int first, int last) { 
int pivot = list [first]; // Choose the first element as the pivot 
int low = first + 1; // Index for forward search 
int high = last; // Index for backward search 
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20 while (high > low) { 

21 // Search forward from left 

22 while (low <= high && list[low] <= pivot) forward 

23 1 ow++ ; 
24 

2 5 // Search backward from right 

26 while (low <= high && list[high] > pivot) backward 

27 high--; 
28 

29 // Swap two elements in the list 

30 if (high > low) { 

31 int temp = list[high]; swap 

32 list[high] = list[lowj; 

33 list [low] = temp; 

34 } 

35 } 
36 

37 while (high > first && list [high] >= pivot) 

38 high--; 
39 

40 // Swap pivot with list [high] 

41 if (pivot > list[high]) { 

42 list [first] = list [high]; 

43 list [high] = pivot; place pivot 

44 return high; pivot's new index 

45 } 

46 else { 

47 return first; pivot's original index 

48 } 

49 } 
50 

51 /** A test method */ 

52 public static void main(String[] args) { 

53 int[] list = {2, 3, 2, 5, 6, 1, -2, 3, 14, 12}; 

54 quickSort(list) ; 

55 for (int i =0; i < list. length; i++) 

56 System. out. pri nt(l i st [i ] + " ") ; 

57 } 



58 } 



-2 1 2 2 3 3 5 6 12 14 




The partition method (lines 15^-9) partitions array 1 ist [first . .last] using the pivot. The 
first element in the partial array is chosen as the pivot (line 16). Initially 1 ow points to the second ele- 
ment in the partial array (line 17) and high points to the last element in the partial array (line 18). 

The method search for the first element from left forward in the array that is greater than 
the pivot (lines 22-23), then search for the first element from right backward in the array that 
is less than or equal to the pivot (lines 26-27). Swap these two elements. Repeat the same 
search and swap operations until all the elements are searched in a while loop (lines 20-35). 

The method returns the new index for the pivot that divides the partial array into two parts if 
the pivot has been moved (line 44). Otherwise, return the original index for the pivot (line 47). 

Figure 24.5 illustrates how to partition an array (5 29 3 8 4 1 6 7). Choose the first ele- partition illustration 
ment 5 as the pivot. Initially low is the index that points to element 2 and high points to ele- 
ment 7, as shown in Figure 24.5(a). Advance index 1 ow forward to search for the first element 
(9) that is greater than the pivot and move index hi gh backward to search for the first element 
(1) that is less than or equal to the pivot, as shown in Figure 24.5(b). Swap 9 with 1, as shown 
in Figure 24.5(c). Continue the search and move low to point to element 8 and high to point 
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(a) Initialize pivot, low, and high 
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(b) Search forward and backward 
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(c) 9 is swapped with 1 



pivot low 



high 



5 


2 


1 


3 


8 


4 





9 


6 


7 



pivot low 



high 



(d) Continue search 
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(e) 8 is swapped with 
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(f) When high < low, search is over 
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(g) Pivot is in the right place 



0(n) partition time 
0{rr) worst-case time 



0(n log n) best-case time 



The index of the pivot is returned 

Figure 24.5 The partition method returns the index of the pivot after it is put in the right place. 

to element 0, as shown in Figure 24.5(d). Swap element 8 with 0, as shown in Figure 24.5(e). 
Continue to move 1 ow until it passes high, as shown in Figure 24.5(f). Now all the elements 
are examined. Swap the pivot with element 4 at index high. The final partition is shown in 
Figure 24.5(g). The index of the pivot is returned when the method is finished. 

24-4- 1 Quick Sort Time 

To partition an array of n elements, it takes n comparisons and n moves in the worst case. So, 
the time required for partition is 0(n). 

In the worst case, the pivot divides the array each time into one big subarray with the other 
empty. The size of the big subarray is one less than the one before divided. The algorithm 
requires (n - 1) + (n - 2) + ■ • • + 2 + 1 = 0{n 2 ) time. 

In the best case, the pivot divides the array each time into two parts of about the same size. 
Let T(n) denote the time required for sorting an array of n elements using quick sort. So, 



recursive quick sort on 
two subarrays 



partition time 




Similar to the merge sort analysis, T(n) = 0(n log n). 
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On the average, each time the pivot will not divide the array into two parts of the same size 
or one empty part. Statistically, the sizes of the two parts are very close. So the average time 

is O(wlogw). The exact average-case analysis is beyond the scope of this book. O(nlogn) average-case time 

Both merge sort and quick sort employ the divide-and-conquer approach. For merge sort, quick sort vs. merge sort 
the bulk of work is to merge two sublists, which takes place after the sublists are sorted. For 
quick sort, the bulk of work is to partition the list into two sublists, which takes place before 
the sublists are sorted. Merge sort is more efficient than quick sort in the worst case, but the 
two are equally efficient in the average case. Merge sort requires a temporary array for merg- 
ing two subarrays. Quick sort does not need additional array space. So, quick sort is more 
space efficient than merge sort. 
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Heap sort uses a binary heap, which is a complete binary tree. A binary tree is a hierarchical root 

structure. It either is empty or consists of an element, called the root, and two distinct binary left subtree 

trees, called the left subtree and right subtree. The length of a path is the number of the edges right subtree 

in the path. The depth of a node is the length of the path from the root to the node. length 

A heap is a binary tree with the following properties: depth 

■ It is a complete binary tree. 

■ Each node is greater than or equal to any of its children. 

A binary tree is complete if each of its levels is full, except that the last level may not be full complete binary tree 
and all the leaves on the last level are placed leftmost. For example, in Figure 24.6, the binary 
trees in (a) and (b) are complete, but the binary trees in (c) and (d) are not complete. Further, 
the binary tree in (a) is a heap, but the binary tree in (b) is not a heap, because the root (39) is 
less than its right child (42). 




|§3| Pedagogical Note 

A heap can be implemented efficiently for inserting keys and for deleting the root. Follow the link heap animation 

www.cs.armstrong.edu/liang/animation/HeapAnimation.html to see how a heap works, as shown in 
Figure 24-7. 

24.5.1 Storing a Heap 

A heap can be stored in an ArrayLi st or an array if the heap size is known in advance. The 
heap in Figure 24.8(a) can be stored using the array in Figure 24.8(b). The root is at posi- 
tion 0, and its two children are at positions 1 and 2. For a node at position ;, its left child is 
at position 2z + 1, its right child is at position 2i + 2, and its parent is (i — 1) /2. For 
example, the node for element 39 is at position 4, so its left child (element 14) is at 9 
(2X4 + 1), its right child (element 33) is at 10 (2 X 4 + 2), and its parent (element 42) 
is at 1 ((4 - l)/2). 
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Heap Animation by Y. Daniel Liang (Note: the keys are integers) 
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Figure 24-7 The animation tool enables you to insert a key and delete the root visually. 
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(b) A heap stored in an array 



Figure 24.8 A binary heap can be implemented using an array. 

24.5.2 Adding a New Node 

To add a new node to the heap, first add it to the end of the heap and then rebuild the tree as 
follows: 

Let the last node be the current node; 

while (the current node is greater than its parent) { 

Swap the current node with its parent; 

Now the current node is one level up; 

} 

Suppose the heap is initially empty. The heap is shown in Figure 24.9, after adding numbers 
3,5, 1, 19, 11, and 22 in this order. 

Now consider adding 88 into the heap. Place the new node 88 at the end of the tree, as 
shown in Figure 24.10(a). Swap 88 with 19, as shown in Figure 25.17(b). Swap 88 with 22, as 
shown in Figure 24.10(c). 



24.5.3 Removing the Root 

Often you need to remove the max element, which is the root in a heap. After the root is 
removed, the tree must be rebuilt to maintain the heap property. The algorithm for rebuilding 
the tree can be described as follows: 



Move the last node to replace the root; 
Let the root be the current node; 



while (the current node has children and the current node is 
smaller than one of its children) { 
Swap the current node with the larger of its children; 
Now the current node is one level down; 

} 
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Figure 24.9 Elements 3, 5, 1, 19, 11, and 22 are inserted into the heap. 
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Figure 24.10 Rebuild the heap after adding a new node. 




29 14 33 30 17 
(a) After moving 9 to the root 
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(b) After swapping 9 with 59 
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(c) After swapping 9 with 44 



29 14 33 9 17 
(d) After swapping 9 with 30 



Figure 24.1 1 Rebuild the heap after the root 62 is removed. 
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Figure 24.1 1 shows the process of rebuilding a heap after the root 62 is removed from Figure 
24.8(a). Move the last node 9 to the root as shown in Figure 24.11(a). Swap 9 with 59 as 
shown in Figure 24.11(b). Swap 9 with 44 as shown in Figure 24.11(c). Swap 9 with 30 as 
shown in Figure 24.1 1(d). 

Figure 24.12 shows the process of rebuilding a heap after the root 59 is removed from 
Figure 24.11(d). Move the last node 17 to the root, as shown in Figure 24.12(a). Swap 17 with 
44 as shown in Figure 24.12(b). Swap 17 with 30 as shown in Figure 24.12(c). 
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(a) After moving 17 to the root (b) After swapping 17 with 44 
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42 30 
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(c) After swapping 17 with 30 
Figure 24.12 Rebuild the heap after the root 59 is removed. 

24.5.4 The Heap Class 

Now you are ready to design and implement the Heap class. The class diagram is shown in 
Figure 24.13. Its implementation is given in Listing 24.8. 



Heap<E> 

-list: java. uti 1 . ArrayLi st<E> 



+Heap() 

+Heap(objects: E[]) 
+add(new0bject : E) : void 
+remove() : E 
+getSize() : int 



Creates a default empty heap. 

Creates a heap with the specified objects. 

Adds a new object to the heap. 

Removes the root from the heap and returns it. 

Returns the size of the heap. 



Figure 24. 1 3 Heap provides operations for manipulating a heap. 



Listing 24-8 Heap . j ava 

1 public class Heap<E extends Comparable> { 
internal heap representation 2 private java . uti 1 .ArrayLi st<E> list = new java. uti 1 .ArrayLi st<E>() ; 

3 
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4 /** Create a default heap */ 

5 public HeapO { no-arg constructor 

6 } 
7 

8 /** Create a heap from an array of objects */ 

9 public Heap(E[] objects) { constructor 

10 for (int i =0; i < objects . 1 ength ; i++) 

11 add(objects[i]) ; 

12 } 
13 

14 /** Add a new object into the heap */ 

15 public void add(E newObject) { add a new object 

16 1 i st . add(newObject) ; // Append to the heap 

17 int currentlndex = list.sizeO - 1; // The index of the last node append the object 
18 

19 while (currentlndex > 0) { 

20 int parentlndex = (currentlndex - 1) / 2; 

21 // Swap if the current object is greater than its parent 

22 if (1 i st . get(currentlndex) . compareTo( 

23 list.get(parentlndex)) > 0) { 

24 E temp = list.get(currentlndex) ; swap with parent 

25 list.set(currentlndex, 1 i st . get(parentlndex)) ; 

26 1 i st . set(parentlndex , temp); 

27 } 

28 else 

29 break; // The tree is a heap now heap now 
30 

31 currentlndex = parentlndex; 

32 } 

33 } 
34 

35 /** Remove the root from the heap */ 

36 public E remove () { remove the root 

37 if (list.sizeO == 0) return null; emptyheap 
38 

39 E removedObject = list.get(O); root 

40 list.set(0, list, get (list.sizeO - 1)); new root 

41 1 i st . remove (1 i st . si ze() - 1); remove the last 
42 

43 int currentlndex = 0; 

44 while (currentlndex < list.sizeO) { adjust the tree 

45 int leftChi 1 dlndex = 2 * currentlndex + 1; 

46 int rightChildlndex = 2 * currentlndex + 2; 
47 

48 // Find the maximum between two children 

49 if (leftChildlndex >= list.sizeO) break; // The tree is a heap 

50 int maxlndex = leftChildlndex; 

51 if (rightChildlndex < list.sizeO) { 

52 if (1 i st . get(maxlndex) . compareTo( compare two children 

53 list.get(rightChildlndex)) < 0) { 

54 maxlndex = rightChildlndex; 

55 } 

56 } 
57 

58 // Swap if the current node is less than the maximum 

59 if (1 i st . get(currentlndex) . compareTo( 

60 list.get(maxlndex)) < 0) { 

61 E temp = 1 ist. get (maxlndex) ; swap with the larger child 

62 list.set(maxlndex, list.get(currentlndex)) ; 

63 list.set(currentlndex, temp); 
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64 currentlndex = maxlndex; 

65 } 

66 else 

67 break; // The tree is a heap 

68 } 
69 

70 return removedObject; 

71 } 
72 

73 /** Get the number of nodes in the tree */ 

74 public int getSizeO { 

75 return "list.sizeO; 

76 } 



77 } 

A heap is represented using an array list internally (line 2). You may change it to other data 
structures, but the Heap class contract will remain unchanged. 

The add(E new/Object) method (lines 15-33) appends the object to the tree and then 
swaps it with its parent if it is greater than its parent. This process continues until the new 
object becomes the root or is not greater than its parent. 

The remove () method (lines 36-71) removes and returns the root. To maintain the heap 
property, the method moves the last object to the root position and swaps it with its larger 
child if it is less than the larger child. This process continues until the last object becomes a 
leaf or is not less than its children. 

24.5.5 Sorting Using the Heap Class 

To sort an array using a heap, first create an object using the Heap class, add all the elements 
to the heap using the add method, and remove all the elements from the heap using the 
remove method. The elements are removed in descending order. Listing 24.9 gives an algo- 
rithm for sorting an array using a heap. 

Listing 24.9 HeapSort . java 

1 public class HeapSort { 

2 /** Heap sort method */ 

3 public static <E extends Comparable> void heapSort(E[] list) { 

4 // Create a Heap of integers 

5 Heap<E> heap = new Heap<E>(); 
6 

7 // Add elements to the heap 

8 for (int i = 0; i < list. length; i++) 

9 heap.add(list[i]) ; 
10 

11 // Remove elements from the heap 

12 for (int i = list. length - 1; i >= 0; i— ) 

13 list[i] = heap . remove() ; 

14 } 
15 

16 /** A test method */ 

17 public static void main(String[] args) { 

18 Integer[] list = {2, 3, 2, 5, 6, 1, -2, 3, 14, 12}; 

19 heapSort(list) ; 

20 for (int i = 0; i < list. length; i++) 

21 System. out. pri nt(l ist [i] + " ") ; 

22 } 

23 } 
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24.5.6 Heap Sort Time Complexity 

Let us turn our attention to analyzing the time complexity for the heap sort. Let h denote the height of a heap 
height for a heap of n elements. Since a heap is a complete binary tree, the first level has 1 
node, the second level has 2 nodes, the Mi level has 2 k ~ l nodes, the (h — l)th level has 2 h ~ 2 
nodes, and the foh level has at least 1 and at most 2 /,_1 nodes. Therefore, 

1 + 2 + • • • + 2 h ~ 2 < n < 1 + 2 + • • • + 2 h ~ 2 + 2 h ~ l 

i.e., 

2 ,,_1 - 1 < n < 2 h - 1 

2 ,,_1 < n + 1 < 2 h 

h - I < log(« + 1) < h 



Thus, h < log(« + 1) + 1 and log(n + 1) < h. Therefore, log(« + 1) < h < log 
(n + 1) + 1. Hence, the height of the heap is O(logw). 

Since the add method traces a path from a leaf to a root, it takes at most h steps to add a new 
element to the heap. So, the total time for constructing an initial heap is 0(n log ri) for an array 0(n log n) worst-case time 
of n elements. Since the remove method traces a path from a root to a leaf, it takes at most h 
steps to rebuild a heap after removing the root from the heap. Since the remove method is 
invoked n times, the total time for producing a sorted array from a heap is 0(n log ri). 

Both merge sort and heap sort requires 0(n log ri) time. Merge sort requires a temporary heap sort vs. merge sort 
array for merging two subarrays. Heap sort does not need additional array space. So, heap sort 
is more space efficient than merge sort. 



24.6 Bucket Sort and Radix Sort 

All sort algorithms discussed so far are general sorting algorithms that work for any types of 
keys (e.g., integers, strings, and any comparable objects). These algorithms sort the elements 
by comparing their keys. The lower bound for general sorting algorithms is 0(n log ri). So, no 
sorting algorithms based on comparisons can perform better than 0(n log ri). However, if the 
keys are small integers, you can use bucket sort without having to compare the keys. 

The bucket sort algorithm works as follows. Assume the keys are in the range from to N- 1. 
We need N buckets labeled 0, 1, . . . , and N-l. If an element's key is i, the element is put into 
the bucket i. Each bucket holds the elements with the same key value. You can use an 
Ar rayLi st to implement a bucket. 

The bucket sort algorithm for sorting a list of elements can be described as follows: 

void bucketSort(E[] list) { 

E[] buckets = (E[])new java.util . ArrayLi st [N] ; 

// Distribute the elements from list to buckets 
for (int i =0; i < list. length; i++) { 
int key = 1 i st [i ] . getKeyO ; 

if (buckets [key] == null) 

buckets [key] = new java. uti 1 .ArrayLi st() ; 

buckets[key] .add(list[i]) ; 

} 
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// Now move the elements from the buckets back to list 
int k = 0; // k is an index for list 
for (int i =0; i < buckets . 1 ength ; i++) { 
if (buckets[i] != null) { 

for (int j = 0; j < buckets[i] .size() ; 
list[k++] = buckets[i] .get(j) ; 

} 

} 

} 

Clearly, it takes 0(n + N) time to sort the list and uses 0{n + N) space, where n is the list 
size. 

Note that if N is too large, bucket sort is not desirable. You can use radix sort. Radix sort is 
based on bucket sort, but it uses only ten buckets, 
stable It is worthwhile to note that bucket sort is stable, meaning that if two elements in the orig- 

inal list have the same key value, their order is not changed in the sorted list. That is, if ele- 
ment e\ and element e2 have the same key and e\ precedes e2 in the original list, e\ still 
precedes in the sorted list. 

Again assume that the keys are positive integers. The idea for the radix sort is to divide the 
keys into subgroups based on their radix positions. It applies bucket sort repeatedly for the 
key values on radix positions, starting from the least-significant position. 

Consider sorting the elements with the keys: 

331, 454, 230, 34, 343, 45, 59, 453, 345, 231, 9 

queue Apply the bucket sort on the last radix position. The elements are put into the buckets as 

follows: 



230 




331 
231 








343 
453 




454 
34 




45 
345 
















59 
9 



buckets[0] bucketsfl] buckets[2] buckets[3] buckets[4] buckets[5] buckets[6] buckets[7] buckets[8] buckets[9] 



queue 



After being removed from the buckets, the elements are in the following order: 

230, 331, 231, 343, 453, 454, 34, 45, 345, 59, 9 

Apply the bucket sort on the second-to-last radix position. The elements are put into the buck- 
ets as follows: 



buckets[0] buckets[l] buckets[2] 



230 
331 
231 
34 



343 




453 


45 




454 


345 




59 



buckets[3] 



buckets[4] buckets[5] buckets[6] buckets[7] buckets[8] buckets[9] 



After being removed from the buckets, the elements are in the following order: 

9, 230, 331, 231, 34, 343, 45, 345, 453, 454, 59 
(Note that 9 is 009.) 

queue Apply the bucket sort on the third-to-last radix position. The elements are put into the 

buckets as follows: 
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buckets[l] buckets[2] buckets[3] buckets[4] buckets [5] buckets[6] buckets[7] buckets[8] buckets[9] 



After being removed from the buckets, the elements are in the following order: 

9, 34, 45, 59, 230, 231, 331, 343, 345, 453 

The elements are now sorted. 

In general, radix sort takes 0{dri) time to sort n elements with integer keys, where d is the 
maximum number of the radix positions among all keys. 

24.7 External Sort 

All the sort algorithms discussed in the preceding sections assume that all data to be sorted are 
available at one time in internal memory such as an array. To sort data stored in an external 
file, you may first bring data to the memory, then sort them internally. However, if the file is 
too large, all data in the file cannot be brought to memory at one time. This section discusses 
how to sort data in a large external file. 

For simplicity, assume that two million int values are stored in a binary file named 
largedata.dat. This file was created using the program in Listing 24.10: 

Listing 24-10 CreateLargeFile. java 

1 import java.io.*; 

2 

3 public class CreateLargeFile { 



4 public static void main(String[] args) throws Exception { 

5 DataOutputStream output = new Data0utputStream( a binary output stream 

6 new BufferedOutputStream( 

7 new FileOutputStreamClargedata.dat"))); 
8 

9 for (int i = 0; i < 800004; i++) 

10 output. writelnt((int) (Math. randomO * 1000000)); output an int value 

11 

12 output . closeO ; close output file 

13 

14 // Display first 100 numbers 

15 DatalnputStream input = 

16 new DataInputStream(new FileInputStreamClargedata.dat")); 

17 for (int i =0; i < 100; i++) 

18 System. out. print(input. readlnt() + " ") ; read an i nt value 
19 

20 i nput. close () ; close input file 

21 } 



22 } 



569193 131317 608695 776266 767910 624915 458599 5010 ... (omitted) 




A variation of merge sort can be used to sort this file in two phases: 

Phase I: Repeatedly bring data from the file to an array, sort the array using an internal sorting 
algorithm, and output the data from the array to a temporary file. This process is shown in 
Figure 24.14. Ideally, you want to create a large array, but its maximum size depends on how 
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Figure 24.14 The original file is sorted in segments. 



much memory is allocated to the JVM by the operating system. Assume that the maximum 
array size is 100000 int values. In the temporary file, every 100000 int values are sorted. 
They are denoted as Si, S2, • ■ ■ , and S^, where the last segment, Sj, may contain less than 
100000 values. 

Phase II: Merge a pair of sorted segments (e.g., Si with S2, S3 with S4, . . . , and so on) 
into a larger sorted segment and save the new segment into a new temporary file. Continue 
the same process until one sorted segment results. Figure 24.15 shows how to merge eight 
segments. 
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Si, S 2 , S3, S 4 merged 


S 5 , S 6 , S 7 , S s merged 









Merge step 



Si, S 2 , S 3 , S 4 , S 5 , S 6 , S 7 , S 8 merged 



Merge step 



Merge step 

Final sorted 
segment 



Figure 24. 1 5 Sorted segments are merged iteratively. 




It is not necessary to merge two successive segments. For example, you may merge S, with S 5 , S 2 
with S 6 , S 3 with S 7 , and S 4 with S 8 , in the first merge step. This observation is useful in imple- 
menting Phase II efficiently. 

24.7.1 Implementing Phase I 

Listing 24.1 1 gives the method that reads each segment of data from a file, sorts the seg- 
ment, and stores the sorted segments into a new file. The method returns the number of 
segments. 
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Listing 24.1 1 Creating Initial Sorted Segments 



1 
2 

3 
4 
5 

6 
7 
8 
9 
10 
11 
12 
13 
14 
15 
16 
17 
18 
19 
20 
21 
22 
23 
24 
25 
26 
27 
28 
29 
30 
31 
32 



/** Sort original file into sorted segments */ 
private static int i ni ti al i zeSegments 

(int segmentSize, String ori gi nal Fi 1 e , String fl) 
throws Exception { 
int[] list = new int [segmentSi ze] ; 
DatalnputStream input = new DataInputStream( 

new Buff eredInputStream(new Fi 1 eInputStream(ori gi nal Fi 1 e))) ; 
DataOutputStream output = new DataOutputStream( 

new Buf feredOutputStream(new FileOutputStream(fl))) ; 



int numberOf Segments = 0; 
while (i nput . avai 1 abl e() > 0) { 

numberOf Segments++ ; 

int i = 0; 

for ( ; i nput . avai 1 abl e() > && 
list[i] = input. readlnt() ; 

} 



original file 

file with sorted segments 



i < segmentSize; i++) { 



// Sort an array list[0..i-l] 
java.util .Arrays. sort(list, 0, i); 

// Write the array to fl.dat 
for (int j = 0; j < i ; j++) { 
output. writelnt(list[j]) ; 

} 



} 



input. close() ; 
output. close() ; 

return numberOfSegments ; 



sort a segment 



output to file 



close file 



return # of segments 



The method creates an array with the max size in line 5, a data input stream for the original 
file in line 6, and a data output stream for a temporary file in line 8. Buffered streams are used 
to improve performance. 

Lines 14—17 read a segment of data from the file into the array. Line 20 sorts the array. 
Lines 23-25 write the data in the array to the temporary file. 

The number of segments is returned in line 31. Note that every segment has 
MAX_ARRAY_SIZE number of elements except the last segment, which may have fewer 
elements. 



24.7.2 Implementing Phase II 

In each merge step, two sorted segments are merged to form a new segment. The size of the 
new segment is doubled. The number of segments is reduced by half after each merge step. A 
segment is too large to be brought to an array in memory. To implement a merge step, copy 
half the number of segments from file fl.dat to a temporary file f2.dat. Then merge the first 
remaining segment in fl.dat with the first segment in f2.dat into a temporary file named 
f3.dat, as shown in Figure 24.16. 
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Si 



S 7 S s fl.dat 



Copy to f2.dat 



Si 



S 4 f2.dat 



Si, Ss merged 


S 2 , S 6 merged 


S3, S7 merged 


S 4 , S 8 merged 



Figure 24. 1 6 Sorted segments are merged iteratively. 



input stream f 1 
output stream f 2 

segments copied 



Note 

fl.dat may have one segment more than f2.dat If so, move the last segment into f3.dat after 
the merge. 

Listing 24.12 gives a method that copies the first half of the segments in fl.dat to f2.dat. 
Listing 24.13 gives a method that merges a pair of segments in fl.dat and f2.dat. Listing 
24.14 gives a method that merges two segments. 

Listing 24-12 Copying First Half Segments 

1 private static void copyHal fToF2 (i nt numberOf Segments , 



int segmentSi ze , DatalnputStream fl, DataOutputStream f2) 
throws Exception { 
for (int i = 0; i < (numberOfSegments / 2) * segmentSize; i++) { 
f2 .writelnt(fl. readlntO) ; 

} 



input stream f 1 and f 2 
output stream f 3 

merge two segments 



extra segment in f 1 



Listing 24-13 Merging All Segments 

1 private static void mergeSegments(int numberOfSegments, 



2 

3 

4 

5 

6 

7 

8 

9 
10 
11 

12 } 



int segmentSize, DatalnputStream fl, DatalnputStream f 2 , 
DataOutputStream f3) throws Exception { 
for (int i = 0; i < numberOfSegments; { 
mergeTwoSegments(segmentSize, fl, f 2 , f 3) ; 

} 

// fl may have one extra segment, copy it to f3 
while (fl. avail able () > 0) { 
f3 .writelnt(fl. readlntO) ; 

} 



input stream f 1 and f 2 
output stream f 3 
read from f 1 

read from f 2 



Listing 24.14 Merging Two Segments 

1 private static void mergeTwoSegments(int segmentSize, 

2 DatalnputStream fl, DatalnputStream f 2 , 

3 DataOutputStream f3) throws Exception { 

4 int intFromFl = fl. readlntO ; 

5 int intFromF2 = f2 . readlntO ; 

6 int flCount = 1; 

7 int f2Count = 1: 
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8 

9 while (true) { 

10 if (intFromFl < intFromF2) { 

11 f 3 .writelnt(i ntFromFl) ; write to f3 

12 if (fl. avail able () == | | flCount++ >= segmentSize) { 

13 f 3 .wri telnt(i ntFromF2) ; 

14 break ; segment in f 1 finished 

15 } 

16 else { 

17 intFromFl = f 1 . readlnt() ; 

18 } 

19 } 

20 else { 

21 f 3 .writelnt(i ntFromF2) ; write to f3 

22 if (f2.available() == | | f2Count++ >= segmentSize) { 

23 f 3 .wri telnt(i ntFromFl) ; 

24 break; segment in f 2 finished 

25 } 

26 else { 

27 intFromF2 = f 2 . readlnt() ; 

28 } 

29 } 

30 } 
31 

32 while (fl. avail able () > && flCount++ < segmentSize) { remaining fl segment 

33 f3 .writelnt(fl. readlntO) ; 

34 } 
35 

36 while (f 2 . avai 1 abl e() > && f2Count++ < segmentSize) { remaining f 2 segment 

37 f3 .writelnt(f2 . readlntO) ; 

38 } 



39 } 

24.7.3 Combining Two Phases 

Listing 24.15 gives the complete program for sorting int values in largedata.dat and storing 
the sorted data in sortedlargedata.dat. 

Listing 24-15 SortLargeFile. java 

1 import java.io.*; 
2 

3 public class SortLargeFile { 



4 public static final int MAX ARRAY SIZE = 100000; max array size 

5 public static final int BUFFER SIZE = 100000; IO stream buffer size 
6 

7 public static void main(String[] args) throws Exception { 

8 // Sort largedata.dat to sortedfile.dat 

9 sort("largedata.dat", "sortedfile.dat"); 
10 

11 // Display the first 100 numbers in the sorted file 

12 displayFile("sortedfile.dat") ; 

13 } 
14 

15 /** Sort data in source file and into target file */ 

16 public static void sort(String sourcefile, String targetfile) 

17 throws Exception { 
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Sorting 



create initial segments 



merge recursively 



merge one step 
merge recursively 



final sorted file 



input stream f llnput 
output stream f20utput 



copy half segments to f 2 
close f 20utput 



input stream f 2Input 
output stream f 30utput 

merge two segments 

close streams 



18 
19 
20 
21 
22 
23 
24 
25 
26 
27 
28 
29 
30 
31 
32 
35 
36 
37 
38 
39 
40 
41 
42 
43 
44 
45 
46 
47 
48 
49 
50 
51 
52 
53 
54 
55 
56 
57 
58 
59 
60 
61 
62 
63 
64 
65 
66 
67 
68 
69 
70 
71 
72 
73 
74 
75 
76 
77 
78 
79 



// Implement Phase 1: Create 
int numberOfSegments = 

i ni ti al i zeSegments (MAX_ARRAY_SIZE , 



"initial segments 

sourcefile, "fl.dat"); 



segmentSize, fl, 
2, segmentSize * 



sorted file 



f2, 
2, 



f3); 



// Implement Phase 2: Merge segments recursively 
merge (numberOfSegments , MAX_ARRAY_SIZE , 
"fl.dat", "f2.dat", "f3.dat", targetfile); 

} 

/** Sort original file into sorted segments */ 
private static int initializeSegments 

(int segmentSize, String ori gi nal Fi 1 e , String fl) 

throws Exception { 

// Same as Listing 24.11, so omitted 

} 

private static void merge(int numberOfSegments, int segmentSize, 
String fl, String f 2 , String f 3 , String targetfile) 
throws Exception { 
if (numberOfSegments > 1) { 
merge0neStep(number0f Segments , 
merge((numberOfSegments + 1) / 
f3, fl, f2, targetfile); 

} 

else { // Rename fl as the final 

File sortedFile = new Fi 1 e(targetf i 1 e) ; 

if (sortedFile. existsO) sortedFile. delete() ; 

new Fi 1 e(f 1) . renameTo(sortedFi 1 e) ; 

} 

} 

private static void mergeOneStep(int numberOfSegments, 

int segmentSize, String fl, String f2, String f3) 

throws Exception { 
DatalnputStream fllnput = new DataInputStream( 

new BufferedInputStream(new Fi 1 eInputStream(f 1) , BUFFER_SIZE)) ; 
DataOutputStream f20utput = new Data0utputStream( 

new BufferedOutputStream(new File0utputStream(f2) , BUFFER_SIZE)) ; 

// Copy half number of segments from fl.dat to f2.dat 

copyHal fToF2 (numberOfSegments , segmentSize, fllnput, f 20utput) ; 

f20utput.close() ; 

// Merge remaining segments in fl with segments in f2 into f3 
DatalnputStream f2Input = new DataInputStream( 

new BufferedInputStream(new Fi 1 eInputStream(f 2) , 
DataOutputStream f30utput = new Data0utputStream( 

new BufferedOutputSt ream (new File0utputStream(f3) , 

mergeSegments(numberOfSegments / 2, 

segmentSize, fllnput, f2Input, f 30utput) ; 

fllnput. close() ; 
f2Input.close() ; 
f30utput.close() ; 

} 

/** Copy first half number of segments from fl.dat to f2.dat */ 
private static void copyHal fToF2 (int numberOfSegments, 

int segmentSize, DatalnputStream fl, DataOutputStream f2) 



BUFFER_SIZE)) ; 
BUFFER_SIZE)) ; 
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80 throws Exception { 

81 // Same as Listing 24.12, so omitted 

82 } 
83 

84 /** Merge all segments */ 

85 private static void mergeSegments(int numberOf Segments , 

86 int segmentSize, DatalnputStream fl, DatalnputStream f 2 , 

87 DataOutputStream f3) throws Exception { 

88 // Same as Listing 24.13, so omitted 

89 } 
90 

91 /** Merges two segments */ 

92 private static void mergeTwoSegments(int segmentSize, 

93 DatalnputStream fl, DatalnputStream f 2 , 

94 DataOutputStream f3) throws Exception { 

95 // Same as Listing 24.14, so omitted 

96 } 
97 

98 /** Display the first 100 numbers in the specified file */ 

99 public static void displayFile(String filename) { displayfile 

100 try { 

101 DatalnputStream input = 

102 new DataInputStream(new Fi 1 eInputStream(fi 1 ename)) ; 

103 for (int i = 0; i < 100; i++) 

104 System. out. print(input. readlntO + " ") ; 

105 input. close() ; 

106 } 

107 catch (IOException ex) { 

108 ex. pri ntStackTrace() ; 

109 } 

110 } 



111 } 
112 



01112223345688999 10 10 11... (omitted) 




Before you run this program, first run Listing 24.10, CreateLargeFile.java, to create large- 
data, dat. Invoking sortClargedata.dat", "sortedfile.dat") (line 9) reads data 
from largedata.dat and writes sorted data sortedfile.dat. Invoking 
displayFileCsortedfile.dat") (line 12) displays the first 100 numbers in the 
specified file. Note that the files are created using binary I/O. You cannot view them using 
a text editor such as Notepad. 

The sort method first creates initial segments from the original array and stores the 
sorted segments in a new file fl.dat (lines 19-20), then produces a sorted file in 
targetfile (lines 23-24). 

The merge method 

merge(int numberOf Segments , int segmentSize, 

String fl, String f 2 , String f3, String targetfile) 

merges the segments in f 1 into f 3 using f 2 to assist the merge. The merge method is invoked 
recursively with many merge steps. Each merge step reduces the numberOfSegments by 
half and doubles the sorted segment size. After completion of one merge step, the next merge 
step merges the new segments in f 3 to f 2 using f 1 to assist the merge. So the statement to 
invoke the new merge method is 
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me rge((numberOf Segments + 1) / 2 , segmentSize * 2, 
f3, fl, f2, targetfile); 

The numberOf Segments for the next merge step is (numberOf Segments + 1) / 2. For 
example, if numberOfSegments is 5, numberOfSegments is 3 for the next merge step, 
because every two segments are merged but one is left unmerged. 

The recursive merge method ends when numberOfSegments is 1. In this case, f 1 con- 
tains sorted data. File f 1 is renamed to targetf "il e (line 47). 

24.7.4 External Sort Analysis 

In the external sort, the dominating cost is that of I/O. Assume n is the number of elements to 
be sorted in the file. In Phase I, n number of elements are read from the original file and out- 
put to a temporary file. So, the I/O for Phase I is 0(ri). 

In Phase II, before the first merge step, the number of sorted segments is — , where c is 

c 

MAX_ARRAY_SIZE. Each merge step reduces the number of segments by half. So, after the 

n 

first merge step, the number of segments is — . After the second merge step,the number of 

2c 

n n ( n 

segments is After the third merge step, the number of segments is — j-. After log — 
2 z c 2 i c V c 

merge steps, the number of segments has been reduced to 1. Therefore, the total number of 
(n 

merge steps is log — 

\c, 

In each merge step, half the number of segments are read from file f 1 and then written into 
a temporary file f 2. The remaining segments in f 1 are merged with the segments in f 2. The 

n 

number of I/Os in each merge step is 0(n). Since the total number of merge steps is log[ 
the total number of I/Os is 

O(n) X logf — ] = O(nlogn) 



Therefore, the complexity of the external sort is 0(n log n). 

Key Terms 



bubble sort 792 
bucket sort 792 
external sort 809 
heap 801 



heap sort 806 
merge sort 794 
quick sort 797 
radix sort 807 



Chapter Summary 

1 . The worst-case complexity for selection sort, insertion sort, bubble sort, and quick sort 
is 0(n 2 ). 

2. The average-case and worst-case complexity for merge sort is 0(n log n). The average 
time for quick sort is also 0(n log n). 

3. Heaps are a useful data structure for designing efficient algorithms such as sorting. 
You learned how to define and implement a heap class, and how to insert and delete 
elements to/from a heap. 

4. The time complexity for heap sort is 0(n log n). 
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5. Bucket sort and radix sort are specialized sorting algorithms for integer keys. These 
algorithms sort keys using buckets rather than comparing keys. They are more effi- 
cient than general sorting algorithms. 

6. A variation of merge sort can be applied to sort large amounts of data from external files. 

Review Questions 

Sections 24-2-24-4 

24-1 Use Figure 24.1 as an example to show how to apply bubble sort on {45, 11, 50, 
59, 60, 2, 4,7, 10}. 

24-2 Use Figure 24.2 as an example to show how to apply merge sort on {45, 11, 50, 

59, 60, 2, 4,7, 10}. 

24-3 Use Figure 24.4 as an example to show how to apply quick sort on {45, 11, 50, 59, 

60, 2, 4, 7, 10}. 

Section 24-5 

24-4 What is a complete binary tree? What is a heap? Describe how to remove the root 
from a heap and how to add a new object to a heap. 

24-5 What is the return value from invoking the remove method if the heap is empty? 

24-6 Add the elements 4, 5, 1, 2, 9, 3 into a heap in this order. Draw the diagrams to 
show the heap after each element is added. 

24-7 Show the heap after the root in the heap in Figure 24.12(c) is removed. 

24-8 What is the time complexity of inserting a new element into a heap and what is the 
time complexity of deleting an element from a heap? 

24-9 Show the steps of creating a heap using {45, 1 1, 50, 59, 60, 2, 4, 7, 10}. 

24-1 Given the following heap, show the steps of removing all nodes from the heap. 



62 




42 59 




32 39 44 13 




22 29 14 33 17 30 9 

Section 24-7 

24- 1 I Ten numbers {2, 3, 4, 0, 5, 6, 7, 9, 8, 1 } are stored in the external file largedata.dat. 
Trace the SortLargeFile program by hand with MAX_ARRAY_SIZE 2. 

Programming Exercises 



Sections 24-2-24-4 

24-1 (Generic bubble sort) Write the following two generic methods using bubble sort. 
The first method sorts the elements using the Comparabl e interface and the sec- 
ond uses the Comparator interface. 

public static <E extends Comparabl e<E» void bubbl eSort(E[] list) 
public static <E> void bubbl eSort(E [] list, 
Comparators? super E> comparator) 
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24.2 (Generic merge sort) Write the following two generic methods using merge sort. 
The first method sorts the elements using the Comparabl e interface and the sec- 
ond uses the Comparator interface. 

public static <E extends Comparabl e<E» void mergeSort(E[] list) 
public static <E> void mergeSort(E[] list, 
Comparator? super E> comparator) 

24.3 (Generic quick sort) Write the following two generic methods using quick sort. 
The first method sorts the elements using the Comparabl e interface and the sec- 
ond uses the Comparator interface. 

public static <E extends Comparabl e<E» void qui ckSort(E[] list) 
public static <E> void quickSort(E[] list, 
Comparator? super E> comparator) 

24-4 (Improving quick sort) The quick sort algorithm presented in the book selects the 
first element in the list as the pivot. Revise it by selecting the median among the 
first, middle, and last elements in the list. 

24-5* (Generic heap sort) Write the following two generic methods using heap sort. The 
first method sorts the elements using the Comparable interface and the second 
uses the Comparator interface. 

public static <E extends Comparabl e<E» void heapSort(E[] list) 
public static <E> void heapSort(E[] list, 
Comparator? super E> comparator) 

24.6 (Checking order) Write the following overloaded methods that check whether an 
array is ordered in ascending order or descending order. By default, the method 
checks ascending order. To check descending order, pass f al se to the ascending 
argument in the method. 

public static boolean ordered(int[] list) 

public static boolean ordered(int[] list, boolean ascending) 
public static boolean ordered(double[] list) 

public static boolean ordered(double[] list, boolean descending) 
public static <E extends Comparabl e<E» boolean ordered(E[] list) 
public static <E extends Comparabl e<E» boolean ordered 

(E[] list, boolean ascending) 
public static <E> boolean ordered(E[] list, 

Comparator? super E> comparator) 
public static <E> boolean ordered(E[] list, 

Comparator? super E> comparator, boolean ascending) 

Section 24.5 

24.7 (Min-heap) The heap presented in the text is also known as a max-heap, in which 
each node is greater than or equal to any of its children. A min-heap is a heap in 
which each node is less than or equal to any of its children. Revise the Heap class 
in Listing 24.8 to implement a min-heap. 

24.8* (Sorting using a heap) Implement the following sort method using a heap, 
public static <E extends Comparabl e<E» void sort(E[] list) 
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24.9* (Generic Heap using Comparator) Revise Heap in Listing 24.8, using a 
generic parameter and a Comparator for comparing objects. Define a new con- 
structor with a Comparator as its argument as follows: 

Heap(Comparator<? super E> comparator) 

24 .10** (Heap visualization) Write a Java applet that displays a heap graphically, as 
shown in Figure 24.7. The applet lets you insert and delete an element from the 
heap. 

24.1 I (Heap clone and equals) Implement the clone and equals method in the 
Heap class. 

Section 24.6 

24.12* (Radix sort) Write a program that randomly generates 1000000 integers and 
sorts them using radix sort. 

24- 1 3* (Execution time for sorting) Write a program that obtains the execution time of 
selection sort, radix sort, bubble sort, merge sort, quick sort, and heap sort for 
input size 50000, 100,000, 150,000, 200,000, 250,000, and 300,000. Your pro- 
gram should create data randomly and print a table like this: 



Array size 


Selection Sort Radix Sort 


Bubble Sort 


Merge Sort 


Quick Sort 


Heap Sort 


50000 
100000 
150000 
200000 
250000 
300000 





(Hint: You can use the code template below to obtain the execution time.) 

long startTime = System . currentTi meMi 1 1 i s() ; 
perform the task; 

long endTime = System. currentTi meMi 11 i s () ; 
long executionTime = endTime - startTime; 

The text gives a recursive quick sort. Write a nonrecursive version in this exercise. 
Section 24.7 

24. 1 4* (Execution time for external sorting) Write a program that obtains the execution time 
of external sort for integers of size 5,000,000, 10,000,000, 15,000,000, 20,000,000, 
25,000,000, and 30,000,000. Your program should print a table like this: 



File size 


5000000 


10000000 15000000 20000000 25000000 30000000 


Time 
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Lists, Stacks, Queues, 
and Priority Queues 

Objectives 

■ To design common features of lists in an interface and provide skeleton implementation in 
an abstract class (§25.2). 

■ To design and implement a dynamic list using an array (§25.3). 

■ To design and implement a dynamic list using a linked structure (§25.4). 

■ To explore variations of linked lists (§25.5). 

■ To design and implement a queue using a linked list (§25.6). 

■ To design and implement a priority queue using a heap (§25.7). 

■ To evaluate expressions using stacks (§25.8). 
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25.1 Introduction 

Lists, stacks, queues, and priority queues are classic data structures typically covered in a data 
structures course. They are supported in the Java API, and their uses were presented in 
Chapter 22, "Java Collections Framework." This chapter will examine how these data struc- 
tures are implemented under the hood and give an interesting application on evaluating 
expressions using stacks. Implementation of sets and maps is covered in Chapters 45-48. 

25.2 Common Features for Lists 

A list is a popular data structure for storing data in sequential order — for example, a list of 
students, a list of available rooms, a list of cities, a list of books. The operations listed below 
are typical of most lists: 

■ Retrieve an element from a list. 

■ Insert a new element to a list. 

■ Delete an element from a list. 

■ Find how many elements are in a list. 

■ Find whether an element is in a list. 

■ Find whether a list is empty. 

There are two ways to implement a list. One is to use an array to store the elements. Arrays 
are dynamically created. If the capacity of the array is exceeded, create a new, larger array and 
copy all the elements from the current array to the new array. The other approach is to use a 
linked structure. A linked structure consists of nodes. Each node is dynamically created to 
hold an element. All the nodes are linked together to form a list. Thus you can define two 
classes for lists. For convenience, let's name these two classes MyArrayList and 
MyLinkedList. These two classes have common operations but different implementations. 

Design Guide 

The common operations can be generalized in an interface or an abstract class. A good strategy 
is to combine the virtues of interfaces and abstract classes by providing both an interface and an 
abstract class in the design so that the user can use either of them, whichever is convenient. The 
abstract class provides a skeletal implementation of the interface, which minimizes the effort 
required to implement the interface. 

Pedagogical Note 

Follow the link www.cs.armstrong.edu/liang/animation/ArrayListAnimation.html and www.cs.armstrong.edu/ 
list animation liang/animation/LinkedListAnimation.html to see how array lists and linked lists work, as shown in 

Figure 25.1 . 
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(b) Linked list animation 



Figure 25.1 The animation tool enables you to see how array lists and linked lists work visually. 
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Let us name the interface MyLi st and the convenience class MyAbstractLi st. Figure 25.2 
shows the relationship of MyList, MyAbstractLi st, MyArrayList, and MyLinkedList. 
The methods in MyList and the methods implemented in MyAbstractLi st are shown in 
Figure 25.3. Listing 25.1 gives the source code for MyLi st. 



— MyArrayLi st | 



MyList | ^ — MyAbstractLi st 



— MyLi nkedLi st [ 



Figure 25.2 MyList defines a common interface for MyAbstractLi st, MyArrayList, 
and MyLinkedList. 



«interface» 




MyList<E> 




+add(e: E) : void 




+add (index: int, e: 


E) : void 


+clear(): void 




+contains(e: E) : boolean 


+get(index: int): E 




+ indexOf(e: E) : int 




+ i sEmptyO : boolean 




+ lastlndex0f(e: E) : 


int 


+remove(e: E) : boolean 


+size(): int 




+ remove (index: int) 


E 


+set(index: int, e: 


E): E 





My A bstractList<E> 



#size: int 



#MyAbstractList() 
#MyAbstractList(objects: E[]) 
+add(e: E) : void 
+isEmpty(): boolean 
+size(): int 
+remove(e: E):boolean 



Appends a new element at the end of this list. 

Adds a new element at the specified index in this list. 

Removes all the elements from this list. 

Returns true if this list contains the element. 

Returns the element from this list at the specified index. 

Returns the index of the first matching element in this list. 

Returns true if this list contains no elements. 

Returns the index of the last matching element in this list. 

Removes the element from this list. 

Returns the number of elements in this list. 

Removes the element at the specified index and returns the removed element. 
Sets the element at the specified index and returns the element you are replacing 



The size of the list. 

Creates a default list. 
Creates a list from an array of objects. 
Implements the add method. 
Implements the i s Empty method. 
Implements the si ze method. 
Implements the remove method. 



Figure 25.3 Li st supports many methods for manipulating a list. MyAbstractLi st provides a partial implementation 
of the List interface. 



Listing 25.1 MyList.java 



public interface MyList<E> { 

/** Add a new element at the 
public void add(E e) ; 

/** Add a new element at the 
public void add(int index, E 



end of this list */ 



specified index 
e); 



in this list */ 



add(e) 



add(index, e) 
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clearO 
contains (e) 
get (index) 

indexOf (e) 
isEmpty(e) 

lastlndexOf(e) 
remove (e) 

remove (index) 

set (index, e) 
size(e) 



no-arg constructor 



constructor 



8 

9 
10 
11 
12 
13 
14 
15 
16 
17 
18 
19 
20 
21 
22 
23 
24 
25 
26 
27 
28 
29 
30 
31 
32 
33 
34 
35 
36 
37 
38 
39 
40 
41 
42 
43 

44 } 



/** Clear the list */ 
public void clear(); 

/** Return true if this list contains the element */ 
public boolean contains (E e) ; 

/** Return the element from this list at the specified index */ 
public E get(int index); 

/** Return the index of the first matching element in this list. 

* Return -1 if no match. */ 
public int index0f(E e) ; 

/** Return true if this list contains no elements */ 
public boolean isEmptyO; 

/** Return the index of the last matching element in this list 

* Return -1 if no match. */ 
public int 1 astlndexOf (E e) ; 

/** Remove the first occurrence of the element o from this list. 

* Shift any subsequent elements to the left. 

* Return true if the element is removed. */ 
public boolean remove (E e) ; 

/** Remove the element at the specified position in this list 

* Shift any subsequent elements to the left. 

* Return the element that was removed from the list. */ 
public E remove(int index); 

/** Replace the element at the specified position in this list 

* with the specified element and return the new set. */ 
public Object set (int index, E e) ; 

/** Return the number of elements in this list */ 
public int sizeQ ; 



MyAbstractList declares variable size to indicate the number of elements in the list. The 
methods isEmptyO, and size(), add(E), and remove(E) can be implemented in the 
class in Listing 25.2. 

Listing 25.2 MyAbstractList. java 

1 public abstract class MyAbstractLi st<E> implements MyList<E> { 

2 protected int size = 0; // The size of the list 



implement add 



3 
4 
5 
6 
7 
8 
9 
10 
11 
12 
13 
14 
15 



/** Create a default list */ 
protected MyAbstractLi st() { 
} 

/** Create a list from an array of objects */ 
protected MyAbstractLi st(E[] objects) { 
for (int i =0; i < objects . 1 ength ; i++) 
add(objects[i]) ; 

} 

/** Add a new element at the end of this list */ 
public void add(E e) { 
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16 add(size, e) ; 

17 } 
18 

19 /** Return true if this list contains no elements */ 

20 public boolean isEmptyO { 

21 return size == 0; 

22 } 
23 

24 /** Return the number of elements in this list */ 

25 public int sizeO { 

26 return size; 

27 } 
28 

29 /** Remove the first occurrence of the element o from this list 

30 * Shift any subsequent elements to the left. 

31 * Return true if the element is removed. */ 

32 public boolean remove(E e) { 

33 if (indexOf(e) >= 0) { 

34 remove(i ndexOf (e)) ; 

35 return true; 

36 } 

37 else 

38 return false; 

39 } 

40 } 

The following sections give the implementation for MyArrayList and MyLinkedList, 

respectively. 

Design Guide 

Protected data fields are rarely used. However, making size a protected data field in the protected data field 

MyAbstractList class is a good choice. The subclass of MyAbstractList can access 
size, but nonsubclasses of MyAbstractList in different packages cannot access it. As a gen- 
eral rule, you may declare protected data fields in abstract classes. 

25.3 Array Lists 

Array is a fixed-size data structure. Once an array is created, its size cannot be changed. Nev- 
ertheless, you can still use arrays to implement dynamic data structures. The trick is to create 
a larger new array to replace the current array, if the current array cannot hold new elements 
in the list. 

Initially, an array, say data of E[] type, is created with a default size. When inserting a 
new element into the array, first make sure that there is enough room in the array. If not, cre- 
ate a new array twice as large as the current one. Copy the elements from the current array to 
the new array. The new array now becomes the current array. Before inserting a new element 
at a specified index, shift all the elements after the index to the right and increase the list size 
by 1, as shown in Figure 25.4. 

j§ Note 

The data array is of type E[] . Each cell in the array actually stores the reference of an object. 

To remove an element at a specified index, shift all the elements after the index to the left 
by one position and decrease the list size by 1, as shown in Figure 25.5. 

MyArrayLi st uses an array to implement MyAbstractLi st, as shown in Figure 25.6. Its 
implementation is given in Listing 25.3. 



implement isEmptyO 



implement size() 



implement remove(E e) 
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Before inserting 1 
e at insertion point i 



i i + 1 



k-1 k k+1 



After inserting 
e at insertion point i, 
list size is 
incremented by 1 









e t -i 




e i+ i 


■■■ e k _ x 




/ 


/ 


/ 


/ 


/ 




e 



Insertion point 
1 '•• i 


\ 

\ 

+ 1 


\ ... shift... 

i + 2 ■■■ 




t 

data. length - 1 

c+1 


e 








e 




■ ■ ■ i 

















e inserted here 



data. length 



Figure 25.4 Inserting a new element into the array requires that all the elements after the 
insertion point be shifted one position to the right, so that the new element can be inserted at 
the insertion point. 



Before deleting the 1 
element at index i | e 



i i + l 



k-l k 



Delete this element 



After deleting the 1 
element, list size is 
decremented by 1 





...shift.. 



k-2k-\ k 



e M 



data. 1 ength 



data. length 



Figure 25.5 Deleting an element from the array requires that all the elements after the deletion point be shifted one 
position to the left. 



MyAbstra ctLis t<E> 



T 



MyArrayList<E> 



-data: E[] 



+MyArrayl_i st() 
+MyArrayl_i st(objects : E[]) 
-ensureCapacityO : void 
+trimToSizeO : void 



Creates a default array list. 
Creates an array list from an array of objects. 
Doubles the current array size if needed. 
Trims the capacity of this array list to the list's 



current size. 



Figure 25.6 MyAr rayLi st implements a list using an array. 



Listing 25.3 MyArrayList. java 

1 public class MyArrayLi st<E> extends MyAbstractLi st<E> { 
initial capacity 2 public static final int INITIAL_CAPACITY = 16; 

array 3 private E[] data = (E[])new Object [INITIAL_CAPACITY] ; 

4 

5 /** Create a default list */ 
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6 public MyArrayLi st() { no-arg constructor 

7 } 
8 

9 /** Create a list from an array of objects */ 

10 public MyArrayLi st(E[] objects) { constructor 

11 for (int i = 0; i < objects . 1 ength ; i++) 

12 add(objects[i]) ; // Warning: don't use super(objects) ! 

13 } 
14 

15 /** Add a new element at the specified index in this list */ 

16 public void add(int index, E e) { add 

17 ensureCapaci ty () ; 
18 

19 // Move the elements to the right after the specified index 

20 for (int i = size - 1; i >= index; i--) 

21 data[i + 1] = data[i]; 
22 

23 // Insert new element to data[index] 

24 data[index] = e; 
25 

26 // Increase size by 1 

27 size++; 

28 } 
29 

30 /** Create a new larger array, double the current size + 1 */ 

31 private void ensureCapacityO { ensureCapaci ty 

32 if (size >= data. length) { 

33 E[] newData = (E[])(new Object[size * 2 + 1]); double capacity + 1 

34 System. arraycopy(data, 0, newData, 0, size); 

35 data = newData; 

36 } 

37 } 
38 

39 /** Clear the list */ 

40 public void clear() { clear 

41 data = (E[])new Object [INITIAL_CAPACITY] ; 

42 size = 0; 

43 } 
44 

45 /** Return true if this list contains the element */ 

46 public boolean contains(E e) { contains 

47 for (int i = 0; i < size; i++) 

48 if (e.equals(data[i])) return true; 

49 

50 return false; 

51 } 
52 

53 /** Return the element from this list at the specified index */ 

54 public E get(int index) { get 

55 return data[index]; 

56 } 
57 

58 /** Return the index of the first matching element in this list. 

59 * Return -1 if no match. */ 

60 public int index0f(E e) { indexOf 

61 for (int i = 0; i < size; i++) 

62 if (e.equals(data[i])) return i; 
63 



828 Chapter 25 



Lists, Stacks, Queues, and Priority Queues 



lastlndexOf 



set 



toString 



64 

65 

66 

67 

68 

69 

70 

71 

72 

73 

74 

75 

76 

77 

78 

79 

80 

81 

82 

83 

84 

85 

86 

87 

88 

89 

90 

91 

92 

93 

94 

95 

96 

97 

98 

99 
100 
101 
102 
103 
104 
105 
106 
107 
108 
109 
110 
111 
112 
113 
114 
115 
116 
117 
118 
119 
120 
121 
122 
123 } 



return -1; 

} 

/** Return the index of the last matching element in this list 

* Return -1 if no match. */ 
public int 1 astlndexOf (E e) { 

for (int i = size - 1; i >= 0; i--) 
if (e. equal s(data[i])) return i; 

return -1; 

} 

/** Remove the element at the specified position in this list 

* Shift any subsequent elements to the left. 

* Return the element that was removed from the list. */ 
public E remove(int index) { 

E e = data[i ndex] ; 

// Shift data to the left 
for (int j = index; j < size - 1; 
data[j] = data[j + 1]; 

data [size - 1] = null; // This element is now null 

// Decrement size 
size--; 

return e; 

} 

/** Replace the element at the specified position in this list 

* with the specified element. */ 
public E set(int index, E e) { 

E old = data[index]; 
data[index] = e; 
return old; 

} 

/** Override toStringO to return elements in the list */ 
public String toStringO { 

Stri ngBui 1 der result = new StringBuilder("[") I 



for (int i = 0; i < size; i++) { 
result. append(data[i]) ; 
if (i < size - 1) result. appendC 

} 

return result. toStringO + "]"; 



); 



} 



/** Trims the capacity to current size */ 
public void trimToSizeO { 
if (size != data. length) { 

// If size == capacity, no need to trim 

E[] newData = (E[])(new Object[size]) ; 

System. arraycopy(data, 0, newData, 0, size); 

data = newData; 

} 

} 
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The constant INITIAL_CAPACITY (line 2) is used to create an initial array data (line 3). 
Owing to generics type erasure, you cannot create a generic array using the syntax new 
e [INITIAL_CAPACITY] . To circumvent this limitation, an array of the Object type is cre- 
ated in line 3 and cast into E [] . 

Note that the implementation of the second constructor in MyArrayLi st is the same as for 
MyAbstractList. Can you replace lines 11-12 with super (objects)? See Review Ques- 
tion 25.6 for answers. 

The add(int index, E e) method (lines 16-28) adds element e at the specified index 
in the array. This method first invokes ensureCapacityO (line 17), which ensures that 
there is a space in the array for the new element. It then shifts all the elements after the index 
one position to the right before inserting the element (lines 20-21). After the element is 
added, size is incremented by 1 (line 27). Note that variable size is defined as protected 
in MyAbstractList, so it can be accessed in MyArrayLi st. 

The ensureCapacityO method (lines 31-37) checks whether the array is full. If so, cre- 
ate a new array that doubles the current array size + 1 , copy the current array to the new array 
using the System . ar raycopy method, and set the new array as the current array. 

The cl ear () method (lines 40-43) creates a brand-new array with initial capacity. 

The contains (E e) method (lines 46-51) checks whether element e is contained in the 
array by comparing e with each element in the array using the equal s method. 

The get(int index) method (lines 54-56) simply returns data [index]. The imple- 
mentation of this method is simple and efficient. 

The indexOf (E e) method (lines 60-65) compares element e with the elements in the 
array, starting from the first one. If a match is found, the index of the element is returned; oth- 
erwise, -lis returned. 

The 1 astlndexOf (E e) method (lines 69-74) compares element e with the elements in 
the array, starting from the last one. If a match is found, the index of the element is returned; 
otherwise, -lis returned. 

The remove(int index) method (lines 79-92) shifts all the elements before the index 
one position to the left and decrements size by 1. 

The set(int index, E e) method (lines 96-100) simply assigns e to data [index] to 
replace the element at the specified index with element e. 

The toStringO method (lines 103-112) overrides the toString method in the Object 
class to return a string representing all the elements in the list. 

The trimToSizeO method creates a new array whose size matches the current array-list 
size (line 117), copies the current array to the new array using the System . arraycopy 
method (line 118), and sets the new array as the current array (line 1 19). Note that if size = = 
capacity, there is no need to trim. 

Listing 25.4 gives an example that creates a list using MyArrayLi st. It uses the add 
method to add strings to the list and the remove method to remove strings. 

Listing 25.4 TestList. java 

1 public class TestList { 

2 public static void main(String[] args) { 

3 // Create a list 

4 MyLi st<Stri ng> list = new MyArrayLi st<Stri ng>() ; createalist 



5 
6 
7 
8 
9 
10 
11 
12 



// Add elements to the list 
list.add("America") ; // Add it to the list 
System. out. println("(l) " + list); 



list.add(0, "Canada"); // Add it to the beginning of the list 
System. out. print! n(" (2) " + list); 



add to list 
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remove from list 



13 


1 i st . add("Russia") ; // Add it to the end of the 


1 1 st 


14 


System. out. println("(3) " + list); 




15 






16 


1 i st . add("France") ; // Add it to the end of the 


1 1 st 


17 


System. out. println("(4) " + list); 




18 






iy 


list. add (2, Germany ); // Add it to the list at 


i ndex 2 


20 


System. out. pri ntl n("(5) " + list); 




21 






22 


1ist.add(5, "Norway"); // Add it to the list at 


index 5 


23 


System. out. pri ntl n("(6) " + list); 




24 






25 


// Remove elements from the list 




26 


1 i st . remove ("Canada") ; // Same as list. remove (0) 


in this case 


27 
28 


System . out . pri ntl n (" (7) " + list); 




29 


1 i st . remove (2) ; // Remove the element at index 2 




30 


System. out. println("(8) " + list); 




3l 






32 


1 i st . removeO i st . si ze() - 1); // Remove the last 


el ement 


33 


System. out. println("(9) " + list); 




34 


} 




35 } 







(1) 


[Ameri ca] 






(2) 


[Canada, 


Ameri ca] 






(3) 


[Canada, 


America, Russia] 






(4) 


[Canada, 


America, Russia, 


France] 




(5) 


[Canada, 


America, Germany, 


Russia, 


France] 


(6) 


[Canada, 


America, Germany, 


Russia, 


France, Norway] 


(7) 


[Ameri ca 


Germany, Russia, 


France , 


Norway] 


(8) 


[Ameri ca 


Germany, France, 


Norway] 




(9) 


[Ameri ca 


Germany, France] 







25.4 Linked Lists 

Since MyArrayList is implemented using an array, the methods get(int index) and 
set("int index, Object o) for accessing and modifying an element through an index and 
the add (Object o) for adding an element at the end of the list are efficient. However, the 
methods add(int index, Object o) and remove(int index) are inefficient, because 
they require shifting a potentially large number of elements. You can use a linked structure to 
implement a list to improve efficiency for adding and removing an element anywhere in a list. 

25.4-1 Nodes 

In a linked list, each element is contained in a structure, called the node. When a new element 
is added to the list, a node is created to contain it. Each node is linked to its next neighbor, as 
shown in Figure 25.7. 



head 



Node 1 
element 1 
next 



Node 2 
element 2 
next 



tail 

\^ Node n 
element n I 



null 



Figure 25.7 A linked list consists of any number of nodes chained together. 
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A node can be defined as a class, as follows: 

class Node<E> { 
E element; 
Node<E> next; 

public Node(E e) { 
element = e; 

} 

} 

The variable head refers to the first node in the list, and the variable tai 1 to the last node. If 
the list is empty, both head and tail are nul 1 . Here is an example that creates a linked list 
to hold three nodes. Each node stores a string element. 

Step 1: Declare head and tail : 

Node<E> head = null; The list is empty now 

Node<E> tail = null; 

head and tai 1 are both nul 1 . The list is empty. 

Step 2: Create the first node and append it to the list: 

After the first node is inserted in the list, head and tail point to this node, as shown 
in Figure 25.8. 



head = new Node<E>("Chicago") ; After the first node is inserted 

last = head; , 

head — >■ "Chicago" 

tail 



next: null 



Figure 25.8 Append the first node to the list. 



Step 3: Create the second node and append it into the list: 

To append the second node to the list, link the first node with the new node, as shown 
in Figure 25.9(a). The new node is now the tail node. So you should move tail to point 
to this new node, as shown in Figure 25.9(b). 

Step 4: Create the third node and append it to the list: 



tail 

tail. next = new Node<E> ("Denver") ; head — 

(a) 



tai 1 = tai 1 . next ; 



head 



"Chicago" 




"Denver" 


next _ 




next: null 


tail 


"Chicago" 




"Denver" 


next _ 




next : nul 1 



(b) 



Figure 25.9 Append the second node to the list. 



To append the new node to the list, link the last node in the list with the new node, as shown 
in Figure 25. 10(a). The new node is now the tail node. So you should move tail to point to this 
new node, as shown in Figure 25.10(b). 
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tail 



tail. next = new Node<E>("Dallas") ; 


head — >- 


"Chicago" 


^^"Denver" 




"Dallas" 






next 


_J next 




next: null 




(a) 






tail 




tail = tail .next; 


head — >■ 


"Chicago" 


^->~"Denver" 


I? 


"Dallas" 






next ^ 


J next _ 




next: null 



(b) 



Figure 25.10 Append the third node to the list. 



Each node contains the element and a data field named next that points to the next element. 
If the node is the last in the list, its pointer data field next contains the value nul 1 . You can 
use this property to detect the last node. For example, you may write the following loop to tra- 
verse all the nodes in the list. 



current pointer 
check last node 



next node 



1 Node current = head; 

2 while (current != null) { 

3 System. out. println(current. element) ; 

4 current = current . next ; 

5 } 



The variable current points initially to the first node in the list (line 1). In the loop, the ele- 
ment of the current node is retrieved (line 3), and then current points to the next node (line 
4). The loop continues until the current node is null. 



25.4 2 The Li nkedLi st Class 

MyLi nkedLi st uses a linked structure to implement a dynamic list. It extends 
MyAbstractLi st. In addition, it provides the methods addFi rst, addLast, removeFi rst, 
removeLast, getFirst, and get Last, as shown in Figure 25.11. 

Assuming that the class has been implemented, Listing 25.5 gives a test program that uses 
the class. 



MyAbstractLi st<E> 





Node<E> 


m 1 




element: E 






next: Node<E> 








1 





Link 




-head: Node<E> 
-tai 1 : Node<E> 



+MyLi nkedLi st() 

+MyLi nkedLi st(objects : E[]) 

+addFi rst(e : E) : void 

+addl_ast(e : E) : void 

+getFi rst() : E 

+getl_ast() : E 

+ removeFi rst() : E 

+ removel_ast() : E 



Creates a default linked list. 
Creates a linked list from an array of objects. 
Adds the object to the head of the list. 
Adds the object to the tail of the list. 
Returns the first object in the list. 
Returns the last object in the list. 
Removes the first object from the list. 
Removes the last object from the list. 



Figure 25.1 1 MyLi nkedLi st implements a list using a linked list of nodes. 
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Listing 25.5 TestLinkedList. java 

1 public class TestLinkedList { 



2 

D 
A 

4 


/** Main method */ 

public static void main(String[] args) { 

// Create a list for strings 




5 




MyLi nkedLi st<Stri ng> list = new MyLi nkedLi st<Stri ng>() ; 


create list 


D 

7 




■ 

// Add elements to the M st 




8 




list.add("America") ; // Add it to the list 


append element 


Q 

y 

1U 




System. out. println("(l) " + list); 


print list 


11 




list.add(0, "Canada"); // Add it to the beginning of the list 


insert element 


12 




system . out . pn nt i n v. \£j + iistj, 




14 




list.add("Russia") ; // Add it to the end of the list 


append element 


lb 




jybLfcilll.UUL.Ul 1 1 1 L 1 1 1 v. \J J T 1 1 j L J j 




17 




list.addLast("France") ; // Add it to the end of the list 


append element 


±o 
1 Q 

±y 

20 




System. out. println("(4) " + list); 

i \ si . auu \ L , uermany ) , / / auu 11 ro tne msti at 1 naex l 


insert element 


21 

LL 




System. out. println("(5) " + list); 




1 3 
L 5 




n si. auu ^ j , Norway j , / / auu ii to trie list at 1 naex j 


insert element 


24 

1 c; 
Z j 




System. out. println("(6) " + list); 




ZD 




iisi.aaa^u, ro i ana j, // bame as n st . auuM rstt^ roianu j 


insert element 


27 
? s 




System. out. println("(7) " + list); 




Z o 

zy 




// r\emove eiemenxs rrom tne iist_ 




30 




1 i st . remove (0) ; // Same as 1 i st . remove("Austral i a") in this case 


remove element 


31 

3 ~> 
j*. 




System. out. print! n(" (8) " + list); 




33 




list. remove (2) ; // Remove the element at index 


remove element 


34 
35 




System. out. print! n(" (9) " + list); 




36 




list. remove(list.size() -1); // Remove the last element 


remove element 


37 
38 

39 } 


} 


System. out. println("(10) " + list); 





(1) 


[Ameri ca^ 












(2) 


[Canada, 


Ameri ca] 










(3) 


[Canada, 


America, 


Russi a] 








(4) 


[Canada, 


America, 


Russia, 


France] 






(5) 


[Canada, 


America, 


Germany, 


Russia, 


France] 




(6) 


[Canada, 


America, 


Germany, 


Russia, 


France , 


Norway] 


(7) 


[Poland, 


Canada, 


Ameri ca, 


Germany, 


Russia, 


France, Norway] 


(8) 


[Canada, 


America, 


Germany, 


Russia, 


France , 


Norway] 


(9) 


[Canada, 


America, 


Russia, 


France , 


Norway] 




(10) 


[Canada 


Ameri ca 


, Russia, 


France] 







25.4-3 Implementing MyLi nkedLi st 

Now let us turn our attention to implementing the MyLi nkedLi st class. We will discuss how 
to implement methods addFirst, addLast, add (index, e), removeFi rst, removeLast, 
and remove(index) and leave other methods in the MyLinkedList class as exercises. 
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25.4-3.1 Implementing addFirst(e) 

The addFi r st (e) method creates a new node for holding element e. The new node becomes 
the first node in the list. It can be implemented as follows: 



public void addFi rst(E e) { 

Node<E> newNode = new Node<E>(e); // Create a new node 
newNode.next = head; // link the new node with the head 
head = newNode; // head points to the new node 
size++; // Increase list size 



} 



if (tail == null) // the new node is the only node in list 
tail = head; 



The addFi r st (e) method creates a new node to store the element (line 2) and insert the 
node to the beginning of the list (line 3), as shown in Figure 25.12(a). After the insertion, 
head should point to this new element node (line 4), as shown in Figure 25.12(b). 

If the list is empty (line 7), both head and tail will point to this new node (line 8). After 
the node is created, size should be increased by 1 (line 5). 
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(a) Before a new node is inserted. 



tail 
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null 



tail 

\ 



This is 
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node next 



(b) After a new node is inserted. 
Figure 25.12 A new element is added to the beginning of the list. 



25.4-3.2 Implementing addLast(e) 

The addLast(e) method creates a node to hold the element and appends the node at the end 
of the list. It can be implemented as follows: 

1 public void addLast(E e) { 
createanode 2 Node<E> newNode = new Node<E>(e); // Create a new node for e 

3 

4 if (tail == null) { 

5 head = tail = newNode; // The only node in list 

6 } 
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7 else { 

8 tail. next = newNode; // Link the new with the last node 

9 tail = tail. next; // tail now points to the last node 
10 } 

11 

12 size++; // Increase size increase size 

13 } 

The addLast(e) method creates a new node to store the element (line 2) and appends it to 
the end of the list (line 8). Consider two cases: 

1. If the list is empty (line 4), both head and tai 1 will point to this new node (line 5); 

2. Otherwise, link the node with the last node in the list (line 8). tail should now point to 
this new node (line 9), as shown in Figure 25.13(b). 
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J next 
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null 



(a) Before a new node is inserted. 



head 



(b) After a new node is inserted. 
Figure 25.1 3 A new element is added at the end of the list. 
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In any case, after the node is created, the size should be increased by 1 (line 12). 
25.4-3.3 Implementing add (index, e) 

The add(index, e) method inserts an element into the list at the specified index. It can be 
implemented as follows: 

1 public void add(int index, E e) { 

2 if (index == 0) addFi rst(e) ; // Insert first insert first 

3 else if (index >= size) addLast(e); // Insert last insertlast 

4 else { // Insert in the middle 

5 Node<E> current = head; 

6 for (int i =1; i < index; i++) 

7 current = current. next; 

8 Node<E> temp = current . next ; 

9 current. next = new Node<E>(e); createanode 

10 (current . next) . next = temp; 

11 size++; increase size 

12 } 

13 } 
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There are three cases when inserting an element into the list: 

1. If index is 0, invoke addFi rst(e) (line 2) to insert the element at the beginning of 
the list; 

2. If i ndex is greater than or equal to si ze, invoke addLast (e) (line 3) to insert the ele- 
ment at the end of the list; 

3. Otherwise, create a new node to store the new element and locate where to insert it. As 
shown in Figure 25.14(b), the new node is to be inserted between the nodes current 
and temp, as shown in Figure 25.14(a). The method assigns the new node to cur- 
rent, next and assigns temp to the new node's next, as shown in Figure 25.14(b). 
The size is now increased by 1 (line 1 1). 
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(b) After a new node is inserted. 
Figure 25.14 A new element is inserted in the middle of the list. 

25.4-3.4 Implementing removeFirstO 

The removeFirstO method is to remove the first element from the list. It can be imple- 
mented as follows: 

1 public E removeFirstO { 

2 if (size == 0) return null; // Nothing to delete 

3 else { 

4 Node<E> temp = head; // Keep the first node temporarily 

5 head = head. next; // Move head to point to the next node 

6 size--; // Reduce size by 1 

7 if (head == null) tail = null; // List becomes empty 

8 return temp . el ement ; // Return the deleted element 

9 } 
10 } 



Consider two cases: 

1. If the list is empty, there is nothing to delete, so return nul 1 (line 2); 

2. Otherwise, remove the first node from the list by pointing head to the second node, as 
shown in Figure 25. 15. The size is reduced by 1 after the deletion (line 6). If there is one 
element, after removing the element, tail should be set to nul 1 (line 7). 
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This node is deleted 

(b) After the node is deleted. 
Figure 25.1 5 The first node is deleted from the list. 
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25.4-3.5 Implementing removeLastO 

The removeLastO method removes the last element from the list. It can be implemented as 
follows: 



1 public E removeLastO { 

2 if (size == 0) return null; // Nothing to remove 

3 else if (size == 1) // Only one element in the list 

4 { 

5 Node<E> temp = head; 

6 head = tail = null; // list becomes empty 

7 size = 0; 

8 return temp . el ement ; 
} 

el se 

{ 

Node<E> current = head; 



9 
10 
11 
12 
13 
14 
15 
16 
17 
18 
19 
20 
21 
22 

23 } 



for (int i = 0; i < size - 2; 
current = current . next ; 

Node<E> temp = tail; 
tail = current; 
tai 1 . next = null ; 
si ze-- ; 

return temp . el ement ; 
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Consider three cases: 

1. If the list is empty, return nul 1 (line 2); 

2. If the list contains only one node, this node is destroyed; head and tail both become 
nul 1 (line 6); 

3. Otherwise, the last node is destroyed (line 18) and the tail is repositioned to point to 
the second-to-last node, as shown in Figure 25.16(a). For the last two cases, the size is 
reduced by 1 after the deletion (lines 7, 20) and the element value of the deleted node is 
returned (lines 8, 21). 
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(b) After the node is deleted. 
Figure 25.1 6 The last node is deleted from the list. 
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25.4-3.6 Implementing remove(index) 

The remove (i ndex) method finds the node at the specified index and then removes it. It can 
be implemented as follows: 



1 public E remove(int index) { 

2 if (index < | | index >= size) return null; // Out of range 
else if (index == 0) return removeFi rst() ; // Remove first 
else if (index == size - 1) return removeLastO ; // Remove last 
else { 

Node<E> previous = head; 



3 

4 

5 

6 

7 

8 

9 
10 
11 
12 
13 
14 
15 
16 

17 } 



for (int i 
previous 

} 



1; i < index; i++) { 
previous. next; 



Node<E> current = previ ous . next ; 
previous . next = current. next; 
si ze-- ; 

return current. element; 



Consider four cases: 

1. If index is beyond the range of the list (i.e., index < | | index >= size), return 
nul 1 (line 2); 

2. If i ndex is 0, invoke removeFi rst () to remove the first node (line 3); 

3. If index is size - 1, invoke removeLastO to remove the last node (line 4); 

4. Otherwise, locate the node at the specified i ndex. Let current denote this node and 
previous denote the node before this node, as shown in Figure 25.17(a). Assign 
current. next to previous . next to eliminate the current node, as shown in 
Figure 25.17(b). 

Listing 25.6 gives the implementation of MyLinkedList. The implementation of 
get(index), indexOf(e), lastlndexOf (e), contains(e), and set(index, e) is 

omitted and left as an exercise. 
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(b) After the node is deleted. 
Figure 25.1 7 A node is deleted from the list. 
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Listing 25.6 MyLinkedList. java 

1 public class MyLi nkedLi st<E> extends MyAbstractLi st<E> { 

2 private Node<E> head, tail; head, tail 
3 

4 /** Create a default list */ 

5 public MyLi nkedLi St () { no-arg constructor 

6 } 
7 

8 /** Create a list from an array of objects */ 

9 public MyLi nkedLi st(E[] objects) { constructor 

10 super (objects) ; 

11 } 
12 

13 /** Return the head element in the list */ 

14 public E getFirstO { getFirst 

15 if (size == 0) { 

16 return nul 1 ; 

17 } 

18 else { 

19 return head . el ement ; 

20 } 

21 } 
22 

23 /** Return the last element in the list */ 

24 public E getLast() { getLast 

25 if (size == 0) { 

26 return null ; 

27 } 

28 else { 

29 return tai 1 . el ement ; 

30 } 

31 } 
32 

33 /** Add an element to the beginning of the list */ 

34 public void addFirst(E e) { addFirst 

35 // Implemented in §25.4.3.1, so omitted here 

36 } 
37 

38 /** Add an element to the end of the list */ 

39 public void addLast(E e) { addLast 
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// Implemented in §25.4.3.2, so omitted here 

} 

/** Add a new element at the specified index in this list 

* The index of the head element is */ 
public void add(int index, E e) { 

// Implemented in §25.4.3.3, so omitted here 

} 

/** Remove the head node and 

* return the object that is contained in the removed node. */ 
public E removeFi rst() { 

// Implemented in §25.4.3.4, so omitted here 

} 

/** Remove the last node and 

* return the object that is contained in the removed node. */ 
public E removeLastO { 

// Implemented in §25.4.3.5, so omitted here 

} 

/** Remove the element at the specified position in this list. 

* Return the element that was removed from the list. */ 
public E remove ( int index) { 

// Implemented in §25.4.3.6, so omitted here 

} 

/** Override toStringO to return elements in the list */ 
public String toStringO { 

StringBuilder result = new StringBuilder("[") ; 

Node<E> current = head; 

for (int i = 0; i < size; i++) { 

result. append(current. element) ; 

current = current. next; 

if (current != null) { 

resul t . append(" , ") ; // Separate two elements with a comma 

} 

else { 

resul t . append("] ") ; // Insert the closing ] in the string 

} 



return result. toStringO ; 

} 

/** Clear the list */ 
public void clear() { 
head = tail = null ; 

} 

/** Return true if this list contains the element o */ 
public boolean contains (E e) { 

System. out. println ("Implementation left as an exercise"); 

return true; 

} 

/** Return the element from this list at the specified index */ 
public E get(int index) { 

System. out. pri ntl n("Implementation left as an exercise"); 
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return null ; 

} 

/** Return the index of the head matching element in this list. 

* Return -1 if no match. */ 
public int index0f(E e) { 

System. out. println ("Implementation left as an exercise"); 
return 0; 

} 

/** Return the index of the last matching element in this list 

* Return -1 if no match. */ 
public int 1 astlndexOf (E e) { 

System. out. println ("Implementation left as an exercise"); 
return 0; 

} 

/** Replace the element at the specified position in this list 

* with the specified element. */ 
public E set(int index, E e) { 

System. out. pri ntl n("Implementation left as an exercise"); 
return null ; 

} 

private static class Node<E> { 
E element; 
Node<E> next; 

public Node(E element) { 
this. element = element; 

} 



indexOf 



1 astlndexOf 



set 



Node inner class 



25.4-4 MyArrayList vs. MyLinkedList 

Both MyAr rayLi st and MyLi nkedLi st can be used to store a list. MyAr rayLi st is imple- 
mented using an array and MyLinkedList is implemented using a linked list. The overhead 
of MyArrayList is smaller than that of MyLinkedList. However, MyLinkedList is more 
efficient if you need to insert and delete the elements from anywhere in the list. Table 25.1 
summarizes the complexity of the methods in MyArrayList, and MyLinkedList. Note that 
MyArrayList is the same as java.util .ArrayList and MyLinkedList is the same as 
java.util . LinkedList. 



Table 25.1 Time Complexities for Methods in MyArrayList and MyLinkedList 

Methods MyArrayList/ArrayList MyLinkedList/LinkedList 



add(e: E) 


0(1) 


0(1) 


addfindex: int, e: E) 


0(n) 


0(B) 


clear() 


0(1) 


0(1) 


contains(e: E) 


O(n) 


cm 


get(index: int) 


0(1) 


0{n) 


indexOf(e: E) 


0(n) 


0(n) 
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isEmptyO 


0(1) 


0(1) 


lastlndex0f(e: E) 


0(n) 


0(n) 


remove(e: E) 


0(n) 


0(n) 


sizeQ 


0(1) 


0(1) 


remove(index; int) 


U[n) 


U(n) 


set(index: int, e: E) 


0(n) 


0(n) 


addFirst(e: E) 


0(n) 


0(1) 


removeFirst() 


0(n) 


0(1) 



25.5 Variations of Linked Lists 

The linked list introduced in the preceding section is known as a singly linked list. It contains 
a pointer to the list's first node, and each node contains a pointer to the next node sequentially. 
Several variations of the linked list are useful in certain applications. 

A circular, singly linked list is like a singly linked list, except that the pointer of the last 
node points back to the first node, as shown in Figure 25.18(a). Note that tail is not needed 
for circular linked lists. A good application of a circular linked list is in the operating system 
that serves multiple users in a timesharing fashion. The system picks a user from a circular list 
and grants a small amount of CPU time, then moves on to the next user in the list. 
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Figure 25.1 8 Linked lists may appear in various forms. 
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A doubly linked list contains the nodes with two pointers. One points to the next node and 
the other to the previous node, as shown in Figure 25.18(b). These two pointers are conve- 
niently called a forward pointer and a backward pointer. So, a doubly linked list can be tra- 
versed forward and backward. 
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A circular, doubly linked list is a doubly linked list, except that the forward pointer of the 
last node points to the first node and the backward pointer of the first pointer points to the last 
node, as shown in Figure 25.18(c). 

The implementations of these linked lists are left as exercises. 



25.6 Stacks and Queues 

A stack can be viewed as a special type of list whose elements are accessed, inserted, and 
deleted only from the end (top), as shown in Figure 10.10. A queue represents a waiting list. 
It can be viewed as a special type of list whose elements are inserted into the end (tail) of the 
queue, and are accessed and deleted from the beginning (head), as shown in Figure 25.19. 
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Figure 25.19 A queue holds objects in a first-in, first-out fashion. 
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Pedagogical Note 

Follow the links www.cs.armstrong.edu/liang/animation/Stackflnimation.html and www.cs.armstrong.edu/ 
liang/animation/Queueflnimation.html to see how stacks and queues work, as shown in Figure 25.20. 
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(b) Queue animation 



Figure 25.20 The animation tool enables you to see how stacks and queues work visually. 

Since the insertion and deletion operations on a stack are made only at the end of the stack, 
it is more efficient to implement a stack with an array list than with a linked list. Since dele- 
tions are made at the beginning of the list, it is more efficient to implement a queue using a 
linked list than an array list. This section implements a stack class using an array list and a 
queue using a linked list. 

There are two ways to design the stack and queue classes: 

■ Using inheritance: You can define a stack class by extending Array List, and a inheritance 
queue class by extending LinkedList, as shown in Figure 25.21(a). 

■ Using composition: You can define an array list as a data field in the stack class, and composition 
a linked list as a data field in the queue class, as shown in Figure 25.21(b). 
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(a) Using inheritance 

Generi cStack ArrayLi st | GenericQueue | ^ Li nkedLi st [ 

(b) Using composition 

Figure 25.21 Generi cStack and GenericQueue may be implemented using inheritance 
or composition. 

Both designs are fine, but using composition is better because it enables you to define a com- 
pletely new stack class and queue class without inheriting the unnecessary and inappropriate 
methods from the array list and linked list. The implementation of the stack class using the 
composition approach was given in Listing 21.1, GenericStack.java. Listing 25.7 implements 
the queue class using the composition approach. Figure 25.22 shows the UML of the class. 
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Figure 25.22 GenericQueue uses a linked list to provide a first-in, first-out data structure. 

Listing 25.7 GenericQueue. java 
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public class Generi cQueue<E> { 

private java.util . Li nkedLi st<E> list 
= new java. uti 1 . Li nkedLi st<E>() ; 

public void enqueue(E e) { 
1 i st . addLast(e) ; 

} 

public E dequeueO { 

return 1 i st . removeFi rst() ; 

} 

public int getSizeO { 
return list.sizeO ; 

} 

public String toStringO { 

return "Queue: " + list.toStringO ; 

} 

} 



A linked list is created to store the elements in a queue (lines 2-3). The enqueue (e) method 
(lines 5-7) adds element e into the tail of the queue. The dequeue () method (lines 9-11) 
removes an element from the head of the queue and returns the removed element. The 
getSizeO method (lines 13-15) returns the number of elements in the queue. 

Listing 25.8 gives an example that creates a stack using Generi cStack and a queue using 
GenericQueue. It uses the push (enqueue) method to add strings to the stack (queue) and 
the pop (dequeue) method to remove strings from the stack (queue). 
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Listing 25.8 TestStackQueue. java 

1 public class TestStackQueue { 

2 public static void main(String[] args) { 

3 // Create a stack 

4 Generi cStack<Stri ng> stack = 

5 new Generi cStack<Stri ng>() ; 
6 

7 // Add elements to the stack 

8 stack. push ("Tom") ; // Push it to the stack 

9 System. out. pri ntl n("(l) " + stack); 
10 

11 stack. push("John") ; // Push it to the the stack 

12 System. out. pri ntl n("(2) " + stack); 
13 

14 stack. push ("George") ; // Push it to the stack 

15 stack. push("Michael ") ; // Push it to the stack 

16 System. out. println("(3) " + stack); 
17 

18 // Remove elements from the stack 

19 System. out. println("(4) " + stack. popO) ; 

20 System. out. println("(5) " + stack. popO) ; 

21 System. out. pri ntl n("(6) " + stack); 
22 

23 // Create a queue 

24 Generi cQueue<Stri ng> queue = new Generi cQueue<Stri ng>() ; 
25 

26 // Add elements to the queue 

27 queue . enqueue ("Tom") ; // Add it to the queue 

28 System. out. println("(7) " + queue); 
29 

30 queue. enqueue("John") ; // Add it to the queue 

31 System. out. println("(8) " + queue); 
32 

33 queue . enqueue("George") ; // Add it to the queue 

34 queue. enqueue("Michael") ; // Add it to the queue 

35 System. out. println("(9) " + queue); 
36 

37 // Remove elements from the queue 

38 System. out. println("(10) " + queue . dequeue() ) ; 

39 System, out. pri ntl n("(ll) " + queue . dequeueO) ; 

40 System. out. pri ntl n("(12) " + queue); 

41 } 

42 } 
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For a stack, the push(e) method adds an element to the top of the stack, and the pop() 
method removes the top element from the stack and returns the removed element. It is easy to 
Stack time complexity see that the time complexity for the push and pop methods is 0(1). 

Queue time complexity For a queue, the enqueue (o) method adds an element to the tail of the queue, and the 

dequeue () method removes the element from the head of the queue. It is easy to see that the 
time complexity for the enqueue and dequeue methods is 0(1). 

25.7 Priority Queues 

An ordinary queue is a first-in, first-out data structure. Elements are appended to the end 
of the queue and removed from the beginning. In a priority queue, elements are assigned 
with priorities. When accessing elements, the element with the highest priority is removed 
first. A priority queue has a largest-in, first-out behavior. For example, the emergency 
room in a hospital assigns priority numbers to patients; the patient with the highest prior- 
ity is treated first. 

A priority queue can be implemented using a heap, where the root is the object with 
the highest priority in the queue. Heap was introduced in §24.5, "Heap Sort." The class 
diagram for the priority queue is shown in Figure 25.23. Its implementation is given in 
Listing 25.9. 



MyPriorityQueue<E> 



-heap: Heap<E> 



+enqueue(element: E) : void 
+dequeue(): E 
+getSize(): int 



Adds an element to this queue. 

Removes an element from this queue. 

Returns the number of elements from this queue. 



Figure 25.23 MyPriori tyQueue uses a heap to provide a largest-in, first-out data structure. 



Listing 25.9 MyPri ori tyQueue. java 



heap for priority queue 
enqueue 

dequeue 

getsize 



1 
2 
3 
4 
5 
6 
7 
8 
9 
10 
11 
12 
13 
14 
15 



public class MyPri ori tyQueue<E extends ComparabI e> { 
private Heap<E> heap = new Heap<E>(); 

public void enqueue(E newObject) { 
heap.add(newObject) ; 

} 

public E dequeueO { 
return heap . remove () ; 

} 

public int getSizeO { 
return heap.getSizeO ; 

} 

} 



Listing 25.10 gives an example of using a priority queue for patients. The Patient class is 
defined in lines 18-34. Four patients are created with associated priority values in lines 3-6. 
Line 8 creates a priority queue. The patients are enqueued in lines 9-12. Line 15 dequeues a 
patient from the queue. 
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Listing 25.10 TestPriori tyQueue. java 



i 

2 
3 
4 
5 
6 
7 
8 
9 
10 
11 
12 
13 
14 
15 
16 
17 
18 
19 
20 
21 
22 
23 
24 
25 
26 
27 
28 
29 
30 
31 
32 
33 
34 
35 



public class TestPri ori tyQueue { 

public static void main(String[] args) { 
Patient patientl = new Pati ent("John" , 2); 
Patient patient2 = new Pati ent("Jim" , 1); 
Patient patient3 = new Pati ent("Tim" , 5); 
Patient patient4 = new Pati ent("Cindy" , 7); 

MyPriorityQueue pri ori tyQueue = new MyPriorityQueueO ; 
priori tyQueue . enqueue (pati entl) ; 
pri ori tyQueue . enqueue (pati ent2) ; 
pri ori tyQueue . enqueue (pati ent3) ; 
pri ori tyQueue . enqueue (pati ent4) ; 



create a patient 



create a priority queue 
add to queue 



while (priorityQueue.getSizeO > 0) 

System . out . pri nt (pri ori tyQueue . dequeue () 



} 



static class Patient implements Comparable { 
private String name; 
private int priority; 



); 



remove from queue 



inner class Patient 



public Pati ent(Stri ng name, 
this. name = name; 
this. priority = priority; 

} 

public String toStringO { 
return name + "(priority: 

} 



int priority) { 



+ priority + ")"; 



public int compareTo (Object o) { 

return this . pri ori ty - ((Patient)o) .priority; 

} 



compareTo 



Cindy(priority: 7) Tim(priority: 5) John(pri ori ty : 2) Jim(priority:l) 




25.8 Case Study: Evaluating Expressions 

Stacks and queues have many applications. This section gives an application of using stacks. 
You can enter an arithmetic expression from Google to evaluate the expression as shown in 
Figure 25.24. 

How does Google evaluate an expression? This section presents a program that evaluates 
a compound expression with multiple operators and parentheses (e.g., (15 + 2) * 34 - 2). compound expression 
For simplicity, assume that the operands are integers and the operators are of four types: +, 
-, *, and /. 

The problem can be solved using two stacks, named operandStack and operatorStack, 
for storing operands and operators, respectively. Operands and operators are pushed into the 
stacks before they are processed. When an operator is processed, it is popped from process an operator 
operatorStack and applied on the first two operands from operandStack (the two operands 
are popped from operandStack). The resultant value is pushed back to operandStack. 
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' v 51 + 54 * ( 3 + 2) - Google search - MozBa Flrefox 



hie bdff yew HEtory Bookmarks loos He£ 



(Ml " C X _u | S | http:/Avwtv.goo3le.com( , seardi?hl=en8 t q=5l4 £j - Google 7* 



Web Images Maps News Shopping Gmail more t 



Google 



Sign in — 



Search 



Web 



51 + (54 * (3 + 2)) = 321 

More about calculator. 



Figure 25.24 You can evaluate an arithmetic expression from Google. 



The algorithm proceeds in two phases: 
Phase 1 : Scanning expression 

The program scans the expression from left to right to extract operands, operators, and the 
parentheses. 

1.1 If the extracted item is an operand, push it to operandStack. 

1.2 If the extracted item is a + or - operator, process all the operators at the top of 
operatorStack, push the extracted operator to operatorStack. 

1.3 If the extracted item is a * or / operator, process all the operators * and / at the top 
of operatorStack, push the extracted operator to operatorStack. 

1.4 If the extracted item is a ( symbol, push it to operatorStack. 

1.5 If the extracted item is a ) symbol, repeatedly process the operators from the top of 
operatorStack until seeing the ( symbol on the stack. 

Phase 2: Clearing stack 

Repeatedly process the operators from the top of operatorStack until operatorStack 

is empty. 

Table 25.2 shows how the algorithm is applied to evaluate the expression (1 + 2) * 4-3. 
Listing 25.1 1 gives the program. Figure 25.25 gives some sample output. 



c> command Prompt 


^JnJ 




C : \book>j aua EualuateExpression 1 * 2 
Wrong expression 




d 

_J 


C:\book>jaua EualuateExpression 1 2 
2 






C:\book>jaua EualuateExpression (1+2 4 
3S 


- 3) "sf' (7/ 5 "*" S) 


-I 


<l 


I 





Figure 25.25 The program takes an expression as command-line arguments. 



25.8 Case Study: Evaluating Expressions 849 



Table 25.2 Evaluating an expression 



Expression 



Scan 



Action 



OperandStack OperatorStack 



1 + 2) * 4 - 3 



1 + 2 
t 

1 + 2 

t 

1 + 2 

t 



1 + 2 



1 + 2 



1 + 2 



1 + 2 



1 + 2 



1 + 2 



4-3 



4-3 



4-3 



4-3 



4-3 



t 



4-3 
t 

4-3 

T 

4-3 
t 

4-3 



Phase 1.4 



Phase 1.1 



Phase 1.2 



Phase 1.1 



Phase 1.5 



Phase 1.3 



Phase 1.1 



Phase 1.2 



Phase 1.1 



Phase 2 



2 1 



4 3 



12 



3 12 



( 

+ ( 
+ ( 



Listing 25.1 1 Eval uateExpressi on . java 



1 public class Eval uateExpressi on { 

2 public static void main(String[] args) { 

// Check number of arguments passed 
if (args. length < 1) { 
System. out . pri ntl n( 

"Usage: java EvaluateExpression expression"); 
System. exit(O) ; 

} 



3 
4 
5 
6 
7 
8 
9 
10 
11 
12 
13 
14 
15 
16 
17 
18 
19 
20 } 
21 

22 /** Evaluate an expression */ 

23 public static int evaluateExpression(String expression) { 

24 // Create operandStack to store operands 



String expression = ""; 
for (int i = 0; i < args. length; i++) 
expression += args[i]; 

try { 

System. out .pri ntl n (eval uateExpressi on (expression)) ; 

} 

catch (Exception ex) { 

System. out .pri ntl n("Wrong expression") ; 

} 



check usage 



concatenate arguments 



evaluate expression 



exception 
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operandStack 
operatorStack 

extract tokens 
more tokens? 
+ or - scanned 
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: or / scanned 



( scanned 



) scanned 



an operand scanned 



25 
26 
27 
28 
29 
30 
31 
32 
33 
34 
35 
36 
37 
38 
39 
40 
41 
42 
43 
44 
45 
46 
47 
48 
49 
50 
51 
52 
53 
54 
55 
56 
57 
58 
59 
60 
61 
62 
63 
64 
65 
66 
67 
68 
69 
70 
71 
72 
73 
74 
75 
76 
77 
78 
79 
80 
81 



Ceneri cStack<Integer> operandStack 
= new Generi cStack<Integer>() ; 

// Create operatorStack to store operators 
Ceneri cStack<Character> operatorStack 
= new Generi cStack<Character>() ; 

// Extract operands and operators 
java.util . Stri ngTokeni zer tokens = 

new java.util .StringTokenizer(expression, "()+-/"'•", true); 

// Phase 1: Scan tokens 

while (tokens . hasMoreTokensO) { 

String token = tokens. nextTokenO .trim() ; // Extract a token 
if (token. length () == 0) // Blank space 

continue; // Back to the while loop to extract the next token 
else if (token. charAt(O) == '+' || token . charAt(O) == '-'") { 
// Process all +, -, *, / in the top of the operator stack 
while (! operatorStack . i sEmptyO && 
(operatorStack. peek() == '+' || 
operatorStack. peek() == '-' || 
operatorStack. peek() == '*' 
operatorStack. peek() == '/')) { 
processAnOperator(operandStack, operatorStack) ; 

} 

// Push the + or - operator into the operator stack 
operatorStack. push(token . charAt(O)) ; 

} 

else if (token. charAt(O) == '*' || token . charAt(O) == '/') { 

// Process all *, / in the top of the operator stack 

while (! operatorStack . i sEmptyO && 
(operatorStack. peek() == '*' || 
operatorStack . peek() == '/')) { 
processAnOperator(operandStack, operatorStack) ; 

} 

// Push the * or / operator into the operator stack 
operatorStack. push(token . charAt(O)) ; 

} 

else if (token. trim() .charAt(C) == ' (') { 

operatorStack. push(' (') ; // Push '(' to stack 

} 

else if (token. trim() .charAt(O) == ')') { 

// Process all the operators in the stack until seeing '(' 
while (operatorStack. peek() != '(') { 

processAnOperator(operandStack, operatorStack) ; 

} 

operatorStack. pop() ; // Pop the '(' symbol from the stack 

} 

else { // An operand scanned 
// Push an operand to the stack 
operandStack. push(new Integer(token)) ; 

} 
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82 // Phase 2: process all the remaining operators in the stack 

83 while (!operatorStack.isEmpty()) { 

84 processAnOperator(operandStack, operatorStack) ; 

85 } 
86 

87 // Return the result 

88 return operandStack . pop() ; 

89 } 
90 

91 /** Process one operator: Take an operator from operatorStack and 

92 * apply it on the operands in the operandStack */ 

93 public static void processAnOperator( 

94 Generi cStack<Integer> operandStack, 

95 Generi cStack<Character> operatorStack) { 

96 char op = operatorStack. pop() ; 

97 int opl = operandStack . pop() ; 

98 int op2 = operandStack . pop() ; 

99 if (op == '+') 

100 operandStack. push(op2 + opl); 

101 else if (op == '-') 

102 operandStack. push(op2 - opl); 

103 else if (op == '*') 

104 operandStack. push(op2 * opl); 

105 else if (op == '/') 

106 operandStack. push(op2 / opl); 

107 } 

108 } 

The program takes an expression as command-line arguments and concatenates all argu- 
ments into a string (lines 11-12). The eval uateExpression method creates two stacks 
operandStack and operatorStack (lines 25, 29) and uses StringTokenizer to 
extract tokens with operators and parentheses as delimiters (lines 33-34). The 
StringTokenizer class is introduced in Supplement III.Z, "The StringTokenizer 
Class." Normally, you use the spl it method in the String class to separate and extract 
tokens, ignoring delimiters from a string, but StringTokenizer is useful to extract tokens 
including delimiters. 

The program scans each token in the whi 1 e loop (lines 37-80). If a token is empty, skip it 
(line 39). If a token is an operand, push it to operandStack (line 78). If a token is a + or - 
operator (line 41), process all the operators from the top of operatorStack if any (lines 
43^-9) and push the newly scanned operator to the stack (line 52). If a token is a * or / oper- 
ator (line 54), process all the * and / operators from the top of operatorStack if any (lines 
56-60) and push the newly scanned operator to the stack (line 63). If a token is a ( symbol 
(line 65), push it to operatorStack. If a token is a ) symbol (line 68), process all the oper- 
ators from the top of operatorStack until seeing the ) symbol (lines 70-72) and pop the ) 
symbol from the stack. 

After all tokens are considered, the program processes the remaining operators in 
operatorStack (lines 83-85). 

The processAnOperator method (lines 93-107) processes an operator. The method pops 
the operator from operatorStack (line 96) and pops two operands from operandStack 
(lines 97-98). Depending on the operator, the method performs an operation and pushes the 
result of the operation back to operandStack (lines 100, 102, 104, 106). 

Recall that the * character has special meaning when passed as a command-line argument special * character 
(see the Note after Listing 9.5 Calculator.java). You have to use "*" to replace *, as shown in 
Figure 25.25. 



clear operatorStack 



return result 



process + 
process - 
process * 
process / 
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Chapter Summary 



1 . You learned how to implement lists, stacks, and queues. 

2. To define a data structure is essentially to define a class. The class for a data structure 
should use data fields to store data and provide methods to support such operations as 
insertion and deletion. 

3. To create a data structure is to create an instance from the class. You can then apply 
the methods on the instance to manipulate the data structure, such as inserting an ele- 
ment into the data structure or deleting an element from the data structure. 

4. You learned how to implement a priority queue using a heap. 

5. Stacks can be applied to evaluate expressions. 

Review Questions 

Sections 25.1-25.2 

25. 1 What is a data structure? What is an object-oriented data structure? 

25 .2 What are the limitations of the array data type? 

25.3 MyArrayList is implemented using an array, and an array is a fixed-size data 
structure. Why is MyArrayList considered a dynamic data structure? 

25.4 What are the benefits of defining both the MyList interface and the 
MyAbstractList class? What is a convenience class? 

25.5 What is wrong in the following code? 

MyArrayLi st<Stri ng> list = new MyArrayLi st<Stri ng>() ; 
list.add(lOO) ; 

25.6 What is wrong if lines 1 1 - 1 2 in My Array List.j ava 

for (int i = 0; i < objects. length; i++) 
add(objects [i ]) ; 

are replaced by 

super(objects) ; 

or 

data = objects; 

size = objects . 1 ength ; 

25.7 If you change the code in line 33 in Listing 25.3 My Array List.j ava from 
E[] newData = (E[])(new Object [size * 2] +1); 

to 

E[] newData = (E[])(new Object [size * 2]); 

The program is incorrect. Can you find the reason? 

25.8 If the number of elements in the program is fixed, what data structure should you use? 
If the number of elements in the program changes, what data structure should you use? 

25.9 If you have to add or delete the elements anywhere in a list, should you use 
ArrayList or LinkedList? 
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Section 25.3 

25. 1 You can use inheritance or composition to design the data structures for stacks and 
queues. Discuss the pros and cons of these two approaches. 

25.1 I Which lines of the following code are wrong? 

MyList list = new MyArrayLi st() ; 

list.add("Tom"); 

list = new MyLi nkedLi st() ; 

list. add ("Tom"); 

list = new Generi cStackO ; 

list.addC'Tom") ; 

Section 25.7 

25.12 What is a priority queue? 
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Section 25.2 

25.1 (Adding set operations in MyList) Add and implement the following methods in 
MyList and implement them in MyAbstractList: 

/** Adds the elements in otherList to this list. 

* Returns true if this list changed as a result of the call */ 
public boolean addAl 1 (MyLi st<E> otherList) 

/** Removes all the elements in otherList from this list 

* Returns true if this list changed as a result of the call */ 
public boolean removeAll (MyLi st<E> otherList) 

/** Retains the elements in this list that are also in otherList 

* Returns true if this list changed as a result of the call */ 
public boolean retai nAl 1 (MyLi st<E> otherList) 

Write a test program that creates two MyArrayLi sts, 1 istl and 1 ist2, with 
the initial values {"Tom", "George", "Peter", "Jean", "Jane"} and 
{"Tom", "George", "Michael", "Michelle", "Daniel"}, then invokes 
1 i st 1 . addAl 1 (1 i st2) , 1 i st 1 . removeAl l(list2),andlistl. retai nAl 1 - 
(1 ist2) and displays the resulting new 1 istl. 

25.2* (Completing the implementation of MyLi nkedLi st) The implementations of meth- 
ods clear(), contains(Object o), get(int index), indexOf (Object o), 
lastlndexOf (Object o), and set(int index, Object o) are omitted in the 
text. Implement these methods. 

25.3* (Creating a two-way linked list) The MyLi nkedLi st class used in Listing 25.6 is 
a one-way directional linked list that enables one-way traversal of the list. Mod- 
ify the Node class to add the new field name previous to refer to the previous 
node in the list, as follows: 

public class Node { 
Object element; 
Node next; 
Node previous; 
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public Node (Object o) { 
element = o; 

} 

} 

Simplify the implementation of the add (Object element, int index) and 
remove(int index) methods to take advantage of the bidirectional linked list. 

Section 25.6 

25.4 (Using the Stack class) Write a program that displays the first 50 prime num- 
bers in descending order. Use a stack to store prime numbers. 

25.5 (Implementing CenericQueue using inheritance) In §25.6, "Stacks and 
Queues," CenericQueue is implemented using composition. Define a new 
queue class that extends MyLinkedList. 

25.6* (Matching grouping symbols) A Java program contains various pairs of grouping 
symbols, such as: 

■ Parentheses: ( and ). 

■ Braces: { and }. 

■ Brackets: [ and ] . 

Note that the grouping symbols cannot overlap. For example, (a{b)} is ille- 
gal. Write a program to check whether a Java source-code file has correct 
pairs of grouping symbols. Pass the source-code file name as a command-line 
argument. 

25.7** (Game: the 24-point card game) The 24-point game is to pick any four cards 
from 52 cards, as shown in Figure 25.26. Note that two Jokers are excluded. 
Each card represents a number. An Ace, King, Queen, and Jack represent 1, 13, 
12, and 11, respectively. Enter an expression that uses the four numbers from the 
four selected cards. Each number must be used once and only once. You can use 
the operators (addition, subtraction, multiplication, and division) and parenthe- 
ses in the expression. The expression must evaluate to 24. After entering the 
expression, click the Verify button to check whether the numbers in the expres- 
sion are currently selected and whether the result of the expression is correct. 
Display the verification in a dialog box. Note that such an expression might not 
exist. In this case, click the Refresh button to get another set of four cards. 
Assume that images are stored in files named l.png, 2.png, . . . , 52.png, in the 
order of spades, hearts, diamonds, and clubs. So, the first 13 images are for 
spades 1, 2, 3, . . . , and 13. 
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Enter an expression; 1 1 2*(4-3+1 ) 



Verify 



l.lfflBWJAEHJMWff 
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Enlei an exjierssiun: (5+6)* 12/6 



Veiify 



(b) 



Figure 25.26 (a) The user enters an expression consisting of the numbers in the cards, 
(b) The program can automatically find a solution if one exists. 
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25.8** (Postfix notation) Postfix notation is a way of writing expressions without 
using parentheses. For example, the expression (1 + 2) * 3 would be written 
as 1 2 + 3 *. A postfix expression is evaluated using a stack. Scan a postfix 
expression from left to right. A variable or constant is pushed to the stack. 
When an operator is encountered, apply the operator with the top two 
operands in the stack and replace the two operands with the result. The fol- 
lowing diagram shows how to evaluate 12 + 3*. 

Write a program to evaluate postfix expressions. Pass the expression as com- 
mand-line arguments. 







2 








3 






1 




1 




3 




3 




9 



12 + 3* 



scanned 



12 + 3 



scanned 



1 2 + 3 

t 

scanned 



12 + 3 



scanned 



12 + 3 



scanned 



(Game: the 24-point card game) Improve Exercise 25.7 to enable the com- 
puter to display the expression if one exists, as shown in Figure 25.26(b). Oth- 
erwise, report that the expression does not exist. 

(Converting infix to postfix) Write a method that converts an infix expression 
into a postfix expression using the following header: 

public static String i nfi xToPostfi x(Stri ng expression) 

For example, the method should convert the infix expression (1 + 2) * 3 to 1 
2 + 3* and 2* (1 + 3) to 213 + *. 

25.1 I *** (Game: the 24-point card game) This exercise is a variation of the 24-point 
card game described in Exercise 25.7. Write an applet to check whether there 
is a 24-point solution for the four specified numbers. The applet lets the user 
enter four values, each between 1 and 13, as shown in Figure 25.27. The user 
can then click the Solve button to display the solution or display no solutions 
if none exist. 



25 9*** 
25.10** 



(1-4)*(5-13) 


Find a Solution | 


1 


4 


5 


13 



B Exercise 25_1 1 


_|n|x| 


4+(5-3)*10 


Rnd n Solution | 


3 


5 


4 


10 



No solution 


| Rnd a Solution | 


5 


4 


5 


11 



Figure 25.27 The user enters four numbers and the program finds a solution. 



25.12** (Implementing MyArrayList) Implement MyArrayList by extending 
java.util .AbstractList. Please study the Java API to learn the details 
of java.util .AbstractList. 

25.13** (Implementing MyLinkedList) Implement MyLinkedList by extending 
java.util . AbstractSequential List. Please study the Java API to 
learn the details of java. util .AbstractSequential List. 
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25.14* (Generic PriorityQueue using Comparator) Revise MyPriorityQueue 

in Listing 25.9, using a generic parameter for comparing objects. Define a 
new constructor with a Comparator as its argument as follows: 

Pri ori tyQueue(Comparator<? super E> comparator) 

25.15*** (Game: solution ratio for 24-point game) When you pick four cards from a 
deck of 52 cards for the 24-point game introduced in Exercise 25.7, the four 
cards may not have a 24-point solution. What is the number of all possible 
picks of four cards from 52 cards? Among all possible picks, how many of 
them have 24-point solutions? What is the success ratio [i.e., (number of picks 
with solutions)/(number of all possible picks of four cards)]? Write a program 
to find these answers. 

25. 1 6* (Animation: array list) Write an applet to animate search, insertion, and dele- 
tion in an array list, as shown in Figure 25.1(a). The Search button searches 
whether the specified value is in the list. The Delete button deletes the speci- 
fied value from the list. The Insert button inserts the value into the specified 
index in the list. 

25.17** (Animation: linked list) Write an applet to animate search, insertion, and dele- 
tion in a linked list, as shown in Figure 25.1(b). The Search button searches 
whether the specified value is in the list. The Delete button deletes the speci- 
fied value from the list. The Insert button inserts the value into the specified 
index in the list. 

25.18* (Animation: stack) Write an applet to animate push and pop of a stack, as 
shown in Figure 25.20(a). 

25.19* (Animation: queue) Write an applet to animate the enqueue and dequeue 
operations on a queue, as shown in Figure 25.20(b). 
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Binary Search Trees 

Objectives 

■ To design and implement a binary search tree (§26.2). 

■ To represent binary trees using linked data structures (§26.2.1). 

■ To search an element in a binary search tree (§26.2.2). 

■ To insert an element into a binary search tree (§26.2.3). 

■ To traverse elements in a binary tree (§26.2.4). 

■ To delete elements from a binary search tree (§26.3). 

■ To display a binary tree graphically (§26.4). 

■ To create iterators for traversing a binary tree (§26.5). 

■ To implement Huffman coding for compressing data 
using a binary tree (§26.6). 
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26.1 Introduction 

A tree is a classic data structure with many important applications. A tree provides a hierar- 
chical organization in which data are stored in the nodes. This chapter introduces binary 
search trees. You have used iterators in the Java collections framework. This chapter will also 
demonstrate how to implement iterators for traversing elements in a binary tree. 

26.2 Binary Search Trees 

Recall that a list, stack, or queue is a linear structure that consists of a sequence of elements. 

A binary tree is a hierarchical structure. It either is empty or consists of an element, called the 
root root, and two distinct binary trees, called the left subtree and right subtree, either or both of 

left subtree which may be empty. Examples of binary trees are shown in Figure 26.1. 

right subtree 




(a) (b) 
Figure 26.1 Each node in a binary tree has zero, one, or two subtrees. 
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binary search tree 



The length of a path is the number of the edges in the path. The depth of a node is the 
length of the path from the root to the node. The set of all nodes at a given depth is sometimes 
called a level of the tree. Siblings are nodes that share the same parent node. The root of a left 
(right) subtree of a node is called a left (right) child of the node. A node without children is 
called a leaf. The height of an empty tree is 0. The height of a nonempty tree is the length of 
the path from the root node to its furthest leaf + 1. Consider the tree in Figure 26.1(a). The 
length of the path from node 60 to 45 is 2. The depth of node 60 is 0, the depth of node 55 is 
1, and the depth of node 45 is 2. The height of the tree is 3. Nodes 45 and 57 are siblings. 
Nodes 45, 57, 67, and 107 are in the same level. 

A special type of binary tree called a binary search tree (BST) is often useful. A BST (with 
no duplicate elements) has the property that for every node in the tree, the value of any node 
in its left subtree is less than the value of the node, and the value of any node in its right sub- 
tree is greater than the value of the node. The binary trees in Figure 26.1 are all BSTs. This 
section is concerned with BSTs. 



BST animation 



Pedagogical Note 

Follow the link www.cs.armstrong.edu/liang/animation/BSTAnimation.html to see how a BST works, as 
shown in Figure 26.2. 



26.2.1 Representing Binary Search Trees 

A binary tree can be represented using a set of linked nodes. Each node contains a value and 
two links named left and right that reference the left child and right child, respectively, as 
shown in Figure 26.3. 
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Binary Tree Animation by Y. Daniel Liang (Note: the keys are integers) 
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Figure 26.2 The animation tool enables you to insert, delete, and search elements visually. 
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Figure 26.3 A binary tree can be represented using a set of linked nodes. 



A node can be defined as a class, as follows: 

class TreeNode<E> { 
E element; 
TreeNode<E> left; 
TreeNode<E> right; 

public TreeNode(E e) { 
element = e; 

} 

} 

The variable root refers to the root node of the tree. If the tree is empty, root is nul 1 . The 
following code creates the first three nodes of the tree in Figure 26.3. 

// Create the root node 

TreeNode<Integer> root = new TreeNode<Integer>(new Integer(60)) ; 

// Create the left child node 

root. left = new TreeNode<Integer>(new Integer(55)) ; 

// Create the right child node 

root. right = new TreeNode<Integer>(new Integer(lOO)) ; 
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26.2.2 Searching for an Element 

To search for an element in the BST, you start from the root and scan down from it until a 
match is found or you arrive at an empty subtree. The algorithm is described in Listing 26.1. 
Let current point to the root (line 2). Repeat the following steps until current is null 
(line 4) or the element matches current . el ement (line 12). 

■ If element is less than current, el ement, assign cur rent, left to current 

(line 6). 

■ If element is greater than current. element, assign current. right to 
current (line 9). 

■ If element is equal to cur rent, el ement, return true (line 12). 

If the current is nul 1 , the subtree is empty and the element is not in the tree (line 14). 

Listing 26.1 Searching for an Element in a BST 



1 public boolean search(E element) { 

2 TreeNode<E> current = root; // Start from the root 
3 
4 
5 
6 
7 
8 
9 

10 
11 
12 
13 

14 return false; // Element is not in the tree 

15 } 



while (current != null) 

if (element < current . el ement) { 
current = current . 1 eft ; // Go left 

} 

else if (element > current. element) { 
current = current. right; // Go right 

} 

else // Element matches current . el ement 
return true; // Element is found 



26.2.3 Inserting an Element into a BST 

To insert an element into a BST, you need to locate where to insert it in the tree. The key idea 
is to locate the parent for the new node. Listing 26.2 gives the algorithm. 



create a new node 



locate parent 



left child 



right child 



Listing 26.2 Inserting an Element into a BST 

1 boolean insert(E e) { 

2 if (tree is empty) 

3 // Create the node for e as the root; 

4 else { 

5 // Locate the parent node 

6 parent = current = root; 

7 while (current != null) 

8 if (e < the value in current. element) { 

9 parent = current; // Keep the parent 

10 current = current . 1 eft ; // Go left 

11 } 

12 else if (e > the value in current. element) { 

13 parent = current; // Keep the parent 

14 current = current. right; // Go right 

15 } 

16 el se 

17 return false; // Duplicate node not inserted 
18 
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19 // Create a new node for e and attach it to parent 
20 

21 return true; // Element inserted 

22 } 

23 } 

If the tree is empty, create a root node with the new element (lines 2-3). Otherwise, locate the 
parent node for the new element node (lines 6-17). Create a new node for the element and link 
this node to its parent node. If the new element is less than the parent element, the node for the 
new element will be the left child of the parent. If the new element is greater than the parent 
element, the node for the new element will be the right child of the parent. 

For example, to insert 101 into the tree in Figure 26.3, after the whil e loop finishes in the 
algorithm, parent points to the node for 107, as shown in Figure 26.4(a). The new node for 
101 becomes the left child of the parent. To insert 59 into the tree, after the whi 1 e finishes in 
the algorithm, the parent points to the node for 57, as shown in Figure 26.4(b). The new node 
for 59 becomes the right child of the parent. 
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(a) Inserting 101 (b) Inserting 59 

Figure 26.4 Two new elements are inserted into the tree. 



26.2.4 Tree Traversal 

Tree traversal is the process of visiting each node in the tree exactly once. There are several 
ways to traverse a tree. This section presents inorder, preorder, postorder, depth-first, and 
breadth-first traversals. 

With inorder traversal, the left subtree of the current node is visited recursively first, then 
the current node, and finally the right subtree of the current node recursively. The inorder 
traversal displays all the nodes in a BST in increasing order. 

With postorder traversal, the left subtree of the current node is visited recursively first, then 
the recursively right subtree of the current node, and finally the current node itself. An applica- 
tion of postorder is to find the size of the directory in a file system. As shown in Figure 26.5, 
each directory is an internal node and a file is a leaf node. You can apply postorder to get the 
size of each file and subdirectory before finding the size of the root directory. 

With preorder traversal, the current node is visited first, then recursively the left subtree of 
the current node, and finally recursively the right subtree of the current node. Depth-first tra- 
versal is the same as preorder traversal. An application of preorder is to print a structure docu- 
ment. As shown in Figure 26.6, you can print the table of contents in a book using the preorder. 

With breadth-first traversal, the nodes are visited level by level. First the root is visited, 
then all the children of the root from left to right, then the grandchildren of the root from left 
to right, and so on. 



inorder 



postorder 



preorder 
depth-first 



breadth-first 
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Figure 26.5 A directory contains files and subdirectories. 
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Figure 26.6 A tree can be used to represent a structured document such as a book, chap- 
ters, and sections. 



For example, in the tree in Figure 26.4(b), the inorder is 
45 55 57 59 60 67 100 101 107 
The postorder is 

45 59 57 55 67 101 107 100 60 




«interface» 
Tree<E> 



+search(e: E) : boolean 

+insert(e: E) : boolean 

+delete(e: E) : boolean 

+ inorder(): void 

+preorder(): void 

+postorder() : void 

+getSize() : int 

+ isEmpty(): boolean 

+ iterator() : java.util .Iterator 

+clear(): void 



AbstractTree<E> 



Returns true if the specified element is in the tree. 

Returns true if the element is added successfully. 

Returns true if the element is removed from the tree successfully. 

Prints the nodes in inorder traversal. 

Prints the nodes in preorder traversal. 

Prints the nodes in postorder traversal. 

Returns the number of elements in the tree. 

Returns true if the tree is empty. 

Returns an iterator for traversing the elements. 

Removes all elements from the tree. 



Figure 26.7 The Tree interface defines common operations for trees, and the AbstractTree class partially 
implements Tree. 
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The preorder is 

60 55 45 57 59 100 67 107 101 
The breadth-first traversal is 

60 55 100 45 57 67 107 59 101 

26.2.5 The BinaryTree Class 

Following the design pattern for the Java collections framework API, we use an interface 
named Tree to define all common operations for trees and provide an abstract class named 
AbstractTree that partially implements Tree, as shown in Figure 26.7. A concrete 
BinaryTree class can be defined to extend AbstractTree, as shown in Figure 26.8. 

Listings 26.3, 26.4, and 26.5 give the implementation for Tree, AbstractTree, and 
BinaryTree. 



TreeNode<E> 



element: E 

left: TreeNode<E> 

right: TreeNode<E> 

=TT 



Link 



«i nterface» 
Tree<E> 



AbstractTree<E> 



BinaryTree<E> 



-root: TreeNode<E> 
-size: int 



+Bi naryTreeO 

+Bi naryTree(objects : E[]) 

+path(e: E) : 
java.util . Li st<TreeNode<E» 



The root of the tree. 

The number of nodes in the tree. 

Creates a default binary tree. 

Creates a binary tree from an array of elements. 

Returns the path of nodes from the root leading to 
the node for the specified element. The element 
may not be in the tree. 



Figure 26.8 The Bi naryTree class defines a concrete BST 



Listing 26.3 Tree.java 



i 

2 
3 
4 
5 
6 
7 
8 
9 
10 
11 
12 
13 
14 
15 
16 
17 



public interface Tree<E extends Comparabl e<E» { 

/** Return true if the element is in the tree */ 
public boolean search(E e) ; 

/** Insert element e into the binary search tree 

* Return true if the element is inserted successfully */ 
public boolean insert(E e) ; 

/** Delete the specified element from the tree 

* Return true if the element is deleted successfully */ 
public boolean delete(E e) ; 

/** Inorder traversal from the root-/ 
public void inorderO; 

/** Postorder traversal from the root */ 
public void postorderQ; 



interface 
search 

insert 

delete 

inorder 

postorder 
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preorder 
getSize 
isEmpty 
iterator 



18 
19 
20 
21 
22 
23 
24 
25 
26 
27 
28 
29 
30 



/** Preorder traversal from the root */ 
public void preorderO; 

/** Get the number of nodes in the tree */ 
public int getSizeO; 

/** Return true if the tree is empty */ 
public boolean isEmptyO; 

/** Return an iterator to traverse elements in the tree */ 
public java. uti 1 . Iterator iteratorQ; 



Listing 26.4 AbstractTree. java 



abstract class 



default inorder 
implementation 



default postorder 
implementation 



default preorder 
implementation 



i sEmpty implementation 



default iterator 
implementation 



1 
2 
3 
4 
5 
6 
7 
8 
9 
10 
11 
12 
13 
14 
15 
16 
17 
18 
19 
20 
21 
22 
23 
24 



public abstract class AbstractTree<E extends Comparabl e<E» 
implements Tree<E> { 

/** Inorder traversal from the root-/ 

public void inorder () { 

} 



/** Postorder traversal from the root 

public void postorderO { 

} 



V 



/** Preorder traversal from the root */ 

public void preorderO { 

} 

/** Return true if the tree is empty */ 
public boolean isEmptyO { 
return getSizeO == 0; 

} 

/** Return an iterator to traverse elements in the tree */ 
public java. uti 1 . Iterator iteratorO { 
return nul 1 ; 

} 



BinaryTree class 



root 
size 



no-arg constructor 



constructor 



Listing 26.5 Bi naryTree. java 

1 public class BinaryTree<E extends Comparabl e<E» 



search 



2 
3 
4 
5 
6 
7 
8 
9 
10 
11 
12 
13 
14 
15 
16 
17 



extends AbstractTree<E> { 
protected TreeNode<E> root; 
protected int size = 0; 

/** Create a default binary search tree */ 

public BinaryTreeO { 

} 

/ ** Create a binary search tree from an array of objects */ 
public BinaryTree(E[] objects) { 

for (int i =0; i < objects . 1 ength ; i++) 
i nsert (objects [i ]) ; 

} 

/** Return true if the element is in the tree */ 
public boolean search (E e) { 



26.2 Binary Search Trees 865 



18 TreeNode<E> current = root; // Start from the root 
19 

20 while (current != null) { 

21 if (e.compareTo(current. element) < 0) { compare objects 

22 current = current . 1 eft ; 

23 } 

24 else if (e . compareTo(current . el ement) > 0) { 

25 current = current . ri ght ; 

26 } 

27 else // element matches current . el ement 

28 return true; // Element is found 

29 } 
30 

31 return false; 

32 } 
33 

34 /** Insert element e into the binary search tree 

35 * Return true if the element is inserted successfully */ 

36 public boolean insert(E e) { insert 

37 if (root == null) 

38 root = createNewNode(e) ; // Create a new root newroot 

39 else { 

40 // Locate the parent node 

41 TreeNode<E> parent = null ; 

42 TreeNode<E> current = root; 

43 while (current != null) 

44 if (e . compareTo (cur rent . el ement) < 0) { compare objects 

45 parent = current; 

46 current = current . 1 eft ; 

47 } 

48 else if (e.compareTo(current. element) > 0) { 

49 parent = current; 

50 current = current. right; 

51 } 

52 else 

53 return false; // Duplicate node not inserted 
54 

55 // Create the new node and attach it to the parent node 

56 if (e . compareTo(parent . el ement) < 0) link to parent 

57 parent. left = createNewNode(e) ; 

58 else 

59 parent. right = createNewNode(e) ; 

60 } 
61 

62 size++; increase size 

63 return true; // Element inserted 

64 } 
65 

66 protected TreeNode<E> createNewNode(E e) { create new node 

67 return new TreeNode<E>(e) ; 

68 } 
69 

70 /** Inorder traversal from the root*/ 

71 public void inorder() { inorder 

72 i norder(root) ; 

73 } 
74 

75 /** Inorder traversal from a subtree */ 

76 protected void i norder(TreeNode<E> root) { recursive helper method 

77 if (root == null) return; 
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i norder(root . 1 eft) ; 

System. out. pri nt(root . element + " ") ; 
i norder(root . ri ght) ; 

} 

/** Postorder traversal from the root */ 
public void postorderO { 
postorder(root) ; 

} 

/** Postorder traversal from a subtree */ 
protected void postorder(TreeNode<E> root) { 

if (root == null) return; 

postorder(root . 1 eft) ; 

postorder(root . ri ght) ; 

System. out. print(root. element + " ") ; 

} 

/** Preorder traversal from the root */ 
public void preorderO { 
preorder(root) ; 

} 

/** Preorder traversal from a subtree */ 
protected void preorder(TreeNode<E> root) { 

if (root == null) return; 

System. out. print(root. element + " ") ; 

p reo rde r ( root . 1 eft) ; 

preorder(root. right) ; 

} 

/** Inner class tree node */ 

public static class TreeNode<E extends Comparabl e<E» { 
E element; 
TreeNode<E> left; 
TreeNode<E> right; 

public TreeNode(E e) { 
element = e; 

} 

} 

/** Get the number of nodes in the tree */ 
public int getSize() { 
return size; 

} 

/** Returns the root of the tree */ 
public TreeNode getRoot() { 
return root; 

} 

/** Returns a path from the root leading to the specified element */ 
public java. uti 1 .ArrayLi st<TreeNode<E» path(E e) { 

java.util . ArrayLi st<TreeNode<E» list = 
new java.util .ArrayLi st<TreeNode<E»() ; 

TreeNode<E> current = root; // Start from the root 

while (current != null) { 

list.add(current) ; // Add the node to the list 
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138 if (e.compareTo(current. element) < 0) { 

139 current = current . 1 eft ; 

140 } 

141 else if (e . compareTo(current . el ement) > 0) { 

142 current = current . ri ght ; 

143 } 

144 el se 

145 break; 

146 } 
147 

148 return list; // Return an array of nodes 

149 } 
150 

151 /** Delete an element from the binary search tree. 

152 * Return true if the element is deleted successfully 

153 * Return false if the element is not in the tree */ 

154 public boolean delete(E e) { delete 

155 // Locate the node to be deleted and also locate its parent node 

156 TreeNode<E> parent = null; locate parent 

157 TreeNode<E> current = root; locate current 

158 while (current != null) { 

159 if (e.compareTo(current. element) < 0) { 

160 parent = current; 

161 current = current . 1 eft ; 

162 } 

163 else if (e . compareTo(current . el ement) > 0) { 

164 parent = current; 

165 current = current . ri ght ; 

166 } 

167 else 

168 break; // Element is in the tree pointed by current current found 

169 } 
170 

171 if (current == null) not found 

172 return false; // Element is not in the tree 
173 

174 // Case 1: current has no left children Case 1 

175 if (current. left == null) { 

176 // Connect the parent with the right child of the current node 

177 if (parent == null) { 

178 root = current . ri ght ; 

179 } 

180 else { 

181 if (e . compareTo(parent . el ement) < 0) 

182 parent, left = current . ri ght ; reconnect parent 

183 else 

184 parent, right = current, right; reconnect parent 

185 } 

186 } 

187 else { 

188 // Case 2: The current node has a left child Case2 

189 // Locate the rightmost node in the left subtree of 

190 // the current node and also its parent 

191 TreeNode<E> parentOf Ri ghtMost = current; locate parentOfRightMost 

192 TreeNode<E> ri ghtMost = current . 1 eft ; locate ri ghtMost 
193 

194 while (ri ghtMost . ri ght != null) { 

195 parentOfRightMost = rightMost; 

196 rightMost = ri ghtMost . ri ght ; // Keep going to the right 

197 } 
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// Replace the element in current by the element in rightMost 
current. element = ri ghtMost . el ement ; 

// Eliminate rightmost node 

if (parentOfRightMost. right == rightMost) 

parentOfRightMost. right = ri ghtMost . 1 eft ; 
else 

// Special case: parentOfRightMost == current 
parentOfRightMost. left = ri ghtMost . 1 eft ; 



si ze-- ; 

return true; // Element inserted 

} 

/** Obtain an iterator. Use inorder. */ 
public java. uti 1 . Iterator iteratorO { 
return i norderlteratorO ; 

} 

/** Obtain an inorder iterator */ 
public java. util .Iterator i norderlteratorO { 
return new InorderlteratorO ; 

} 

// Inner class Inorderlterator 

class Inorderlterator implements java. util .Iterator { 

// Store the elements in a list 
private java. uti 1 .ArrayLi st<E> list = 

new java. util .ArrayLi st<E>() ; 
private int current = 0; // Point to the current element in list 

public InorderlteratorO { 

inorderO; // Traverse binary tree and store elements in list 

} 

/** Inorder traversal from the root-'/ 
private void inorderO { 
inorder(root) ; 

} 

/** Inorder traversal from a subtree */ 
private void i norder(TreeNode<E> root) { 

if (root == null) return; 

i norder(root . 1 eft) ; 

list. add(root . el ement) ; 

i norder(root . ri ght) ; 

} 

/** Next element for traversing? */ 
public boolean hasNext() { 
if (current < list.sizeO) 
return true; 



return false; 

} 

/** Get the current element and move cursor to the next */ 
public Object next() { 
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258 return list.get(current++) ; 

259 } 
260 

261 /** Remove the current element and refresh the list */ 

262 public void remove () { remove the current 

263 delete(list.get(current)) ; // Delete the current element 

264 list.clearO ; // Clear the list 

265 inorderO; // Rebuild the list refreshlist 

266 } 

267 } 
268 

269 /** Remove all elements from the tree */ 

270 public void clearO { 

271 root = null ; 

272 size = 0; 

273 } 

274 } 

The insert (E e) method (lines 36-64) creates a node for element e and inserts it into the 
tree. If the tree is empty, the node becomes the root. Otherwise, the method finds an appropri- 
ate parent for the node to maintain the order of the tree. If the element is already in the tree, 
the method returns fal se; otherwise it returns true. 

The inorderO method (lines 71-81) invokes inorder(root) to traverse the entire 
tree. The method i norder (TreeNode root) traverses the tree with the specified root. This 
is a recursive method. It recursively traverses the left subtree, then the root, and finally the 
right subtree. The traversal ends when the tree is empty. 

The postorderO method (lines 84-94) and the preorderO method (lines 97-107) are 
implemented similarly using recursion. 

The path(E e) method (lines 131-149) returns a path of the nodes as an array list. The 
path starts from the root leading to the element. The element may not be in the tree. For exam- 
ple, in Figure 26.4(a), path (45) contains the nodes for elements 60, 55, and 45, and 
path(58) contains the nodes for elements 60, 55, and 57. 

The implementation of deleteO and iteratorO (lines 151-267) will be discussed in 
§§26.3 and 26.4. 

Listing 26.6 gives an example that creates a binary search tree using Bi naryTree (line 4). 
The program adds strings into the tree (lines 5-11), traverses the tree in inorder, postorder, 
and preorder (lines 14-20), searches an element (line 24), and obtains a path from the node 
containing Peter to the root (lines 28-31). 



Listing 26.6 TestBi naryTree. java 

1 public class TestBi naryTree { 



2 


public static void main(String[] args) { 




3 


// Create a Bi naryTree 




4 


Bi naryTree<Stri ng> tree = new Bi naryTree<Stri ng>() ; 


create tree 


5 


tree . i nsert ("George") ; 


insert 


6 


tree . i nsert ("Michael ") ; 




7 


tree . i nsert ("Tom") ; 




8 


tree . i nsert ("Adam") ; 




9 


tree . i nsert ("Jones") ; 




10 


tree . i nsert ("Peter") ; 




11 


tree.insert("Daniel") ; 




12 






13 


// Traverse tree 




14 


System . out . pri nt("Inorder (sorted): ") ; 




15 


tree . i norder() ; 


inorder 


16 


System . out . pri nt("\nPostorder : ") ; 
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37 

38 } 



tree . postorderO ; 

System. out. print("\nPfeorder: ") ; 

tree . preorderO ; 

System . out . pri nt("\nThe number of nodes is 



+ tree.getSizeQ) ; 



// Search for an element 

System . out . pri nt("\nls Peter in the tree? " + 
tree.search("Peter") ) ; 

// Get a path from the root to Peter 

System . out . pri nt("\nA path from the root to Peter is: ") ; 
java.util . ArrayLi st<Bi naryTree .TreeNode<Stri ng» path 

= tree.path("Peter") ; 
for (int i = 0; path != null && i < path.sizeO; i++) 

System. out. pri nt(path . get(i ) .element + " ") ; 

Integer[] numbers = {2, 4, 3, 1, 8, 5, 6, 7}; 

Bi naryTree<Integer> intTree = new Bi naryTree<Integer>(numbers) ; 
System . out . pri nt("\n!norder (sorted): ") ; 
intTree. inorder() ; 



Inorder (sorted): Adam Daniel George Jones Michael Peter Tom 
Postorder: Daniel Adam Jones Peter Tom Michael George 
Preorder: George Adam Daniel Michael Jones Tom Peter 
The number of nodes is 7 
Is Peter in the tree? true 

A path from the root to Peter is: George Michael Tom Peter 
Inorder (sorted): 12345678 



The program checks path != null in line 30 to ensure that the path is not null before 
invoking path. get (i). This is an example of defensive programming to avoid potential 
runtime errors. 

The program creates another tree for storing int values (line 34). After all the elements 
are inserted into the trees, the trees should appear as shown in Figure 26.9. 

If the elements are inserted in a different order (e.g., Daniel, Adam, Jones, Peter, Tom, 
Michael, George), the tree will look different. However, the inorder traversal prints elements 
in the same order as long as the set of elements is the same. The inorder traversal displays a 
sorted list. 

26.3 Deleting Elements in a BST 

The insert (element) method was presented in §26.2.3. Often you need to delete an ele- 
ment from a binary search tree. Doing so is far more complex than adding an element into a 
binary search tree. 

locating element To delete an element from a binary search tree, you need to first locate the node that contains 

the element and also its parent node. Let current point to the node that contains the element in 
the binary search tree and parent point to the parent of the current node. The current node 
may be a left child or a right child of the parent node. There are two cases to consider: 

Case 1: The current node does not have a left child, as shown in Figure 26.10(a). Simply 
connect the parent with the right child of the current node, as shown in Figure 26.10(b). 

For example, to delete node 10 in Figure 26.1 1(a). Connect the parent of node 10 with the 
right child of node 10, as shown in Figure 26.1 1(b). 
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(a) (b) 
Figure 26.9 The BSTs are pictured here after they are created. 
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Figure 26.10 Case 1: the current node has no left child. 




(a) (b) 
Figure 26.1 1 Case 1: deleting node 10 from (a) results in (b). 
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delete a leaf 



Note 

[f the current node is a leaf, it falls into Case I. For example, to delete element 16 in Figure 26.1 1(a), 
connect its right child to the parent of node 16. In this case, the right child of node 16 is null. 

Case 2: The current node has a left child. Let rightMost point to the node that contains 
the largest element in the left subtree of the current node and parentOf RightMost point to 
the parent node of the rightMost node, as shown in Figure 26.12(a). Note that the 
rightMost node cannot have a right child but may have a left child. Replace the element 
value in the current node with the one in the rightMost node, connect the 
parentOf RightMost node with the left child of the rightMost node, and delete the 
rightMost node, as shown in Figure 26.12(b). 
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right child of parent 



parent 



current — 


— >- 




current points to the node 


current 




/ 


\ 


to be deleted 













/ 


\ 



The content of the current 
node is replaced by the content of 
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(a) 

Figure 26.12 Case 2: the current node has a left child. 



1 ef tChi 1 dOf Ri ghtMost 



(b) 



For example, consider deleting node 20 in Figure 26.13(a). The rightMost node has the 
element value 16. Replace the element value 20 with 16 in the current node and make node 
10 the parent for node 14, as shown in Figure 26.13(b). 



special case 



Note 

If the left child of current does not have a right child, current . 1 eft points to the large ele- 
ment in the left subtree of current. In this case, rightMost is current. left and 
parentOf RightMost is current. You have to take care of this special case to reconnect the 
right child of rightMost with parentOfRightMost. 
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(a) (b) 
Figure 26.13 Case 2: deleting node 20 from (a) results in (b). 



The algorithm for deleting an element from a binary search tree can be described in del ete method 
Listing 26.7. 

Listing 26.7 Deleting an Element from a BST 

1 boolean del ete (E e) { 

2 Locate element e in the tree; 

3 if element e is not found not in the tree 

4 return true; 
5 

6 Let current be the node that contains e and parent be 

7 the parent of current; locate parent 
8 

9 if (current has no left child) // Case 1 easel 

10 Connect the right child of 

11 current with parent; now current is not referenced, so 

12 it is eliminated; 

13 else // Case 2 case 2 

14 Locate the rightmost node in the left subtree of current. 

15 Copy the element value in the rightmost node to current. 

16 Connect the parent of the rightmost to the left child 

17 of rightmost; 
18 

19 return true; // Element deleted 

20 } 

The complete implementation of the delete method is given in lines 154-212 in Listing 
26.5. The method locates the node (named current) to be deleted and also locates its parent 
(named parent) in lines 158-169. If current is null, the element is not in tree. So, the 
method returns false (line 172). Please note that if current is root, parent is null. If 
the tree is empty, both current and parent are nul 1 . 

Case 1 of the algorithm is covered in lines 175-186. In this case, the current node has no 
left child (i.e., current. left == null). If parent is null, assign current . right to 
root (lines 177-179). Otherwise, assign current . right to parent, left or 
parent . right, depending on whether current is a left or right child of parent (181-184). 

Case 2 of the algorithm is covered in lines 187-208. In this case, the current has a left 
child. The algorithm locates the rightmost node (named r i ghtMost) in the left subtree of the 
current node and also its parent (named parentOfRi ghtMost) (lines 194-197). Replace the 
element in current by the element in rightMost (line 200); assign rightMost . 1 ef t to 
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delete an element 



delete an element 



delete an element 



parentOfRightMost. right or parentOfRightMost. right (lines 203-207), depend- 
ing on whether rightMost is a right or left child of parentOfRightMost. 

Listing 26.8 gives a test program that deletes the elements from the binary search tree. 

Listing 26.8 TestBinaryTreeDelete. java 



1 

2 

3 

4 

5 

6 

7 

8 

9 
10 
11 
12 
13 
14 
15 
16 
17 
18 
19 
20 
21 
22 
23 
24 
25 
26 
27 
28 
29 
30 
31 
32 
33 
34 
35 
36 
37 } 



public class TestBinaryTreeDelete { 

public static void main(String[] args) { 

Bi naryTree<Stri ng> tree = new Bi naryTree<Stri ng>() ; 
tree . i nsert ("George") ; 
tree . i nsert ("Michael ") ; 
tree . i nsert ("Tom") ; 
tree . i nsert ("Adam") ; 
tree . i nsert ("Dones") ; 
tree.insert("Peter") ; 
tree.insert("Daniel") ; 
pri ntTree(tree) ; 

System. out. print"! n("\nAfter delete George:"); 
tree . del ete("George") ; 
pri ntTree(tree) ; 

System. out. pri ntln("\nAfter delete Adam:"); 
tree. del ete("Adam") ; 
pri ntTree(tree) ; 

System. out. pri ntl n("\nAfter delete Michael:"); 
tree.delete("Michael ") ; 
pri ntTree(tree) ; 

} 

public static void pri ntTree(Bi naryTree tree) { 

// Traverse tree 

System . out . pri nt("Inorder (sorted): ") ; 
tree . i norder() ; 

System. out. pri nt("\nPostorder : ") ; 
tree . postorder() ; 
System. out. print("\nPreorder: ") ; 
tree . preorder() ; 

System . out . pri nt("\nThe number of nodes is " + tree.getSizeO) ; 
System . out . pri ntl n () ; 

} 



Inorder (sorted): Adam Daniel George Jones Michael Peter Tom 
Postorder: Daniel Adam Jones Peter Tom Michael George 
Preorder: George Adam Daniel Michael Jones Tom Peter 
The number of nodes is 7 



After delete George: 

Inorder (sorted): Adam Daniel Jones Michael Peter Tom 
Postorder: Adam Jones Peter Tom Michael Daniel 
Preorder: Daniel Adam Michael Jones Tom Peter 
The number of nodes is 6 



After delete Adam: 

Inorder (sorted): Daniel Jones Michael Peter Tom 
Postorder: Jones Peter Tom Michael Daniel 
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Preorder: Daniel Michael Jones Tom Peter 
The number of nodes is 5 

After delete Michael: 

Inorder (sorted): Daniel Jones Peter Tom 
Postorder: Peter Tom Jones Daniel 
Preorder: Daniel Jones Tom Peter 
The number of nodes is 4 



Figures 26.14-26.16 show how the tree evolves as the elements are deleted from it. 
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(a) Deleting George 
Figure 26.14 Deleting George falls in Case 2. 



(b) After George is deleted 
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(a) Deleting Adam 
Figure 26. 1 5 Deleting Adam falls in Case 1 . 



Peter 







(b) After Adam is deleted 



Note 

It is obvious that the time complexity for the inorder, preorder, and postorder is 0(n), since each 
node is traversed only once. The time complexity for search, insertion, and deletion is the height 
of the tree. In the worst case, the height of the tree is 0(n). 



BST time complexity 
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(a) Deleting Michael (b) After Michael is deleted 

Figure 26.1 6 Deleting Michael falls in Case 2. 



26.4 Tree Visualization 



Pedagogical Note 

One challenge facing the data-structure course is to motivate students. To display a binary tree 
graphically will not only help students understand the working of a binary tree but also stimulate 
their interest in programming. Students can apply visualization techniques in other projects. 

How do you display a binary tree? It is a recursive structure. You can simply display the root, 
then display the two subtrees recursively. The techniques for displaying the Sierpinski trian- 
gle (Listing 20.9 SierpinskiTriangle.java) can be applied to display a binary tree. You can dis- 
play a binary tree using recursion. For simplicity, we assume the keys are positive integers 
less than 100. Listings 26.9 and 26.10 give the program, and Figure 26.17 shows some sam- 
ple runs of the program. 



H uis ptayttina ry I rcc 


-IqM 














© 




Enter a Key: |6Q j | kreert 


1 Delete | 



I Uts pto y LJina ry I rcc 
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Enter a Key: | 5Q insert 



(a) Inserting 50, 25, 35, 30, and 60 
Figure 26.1 7 A binary tree is displayed graphically. 



(b) After 50 is deleted 



Listing 26.9 DisplayBinaryTree. java 

1 import javax. swing.*; 
2 

3 public class DisplayBinaryTree extends DApplet { 

4 public Di spl ayBi naryTree() { 

create a view 5 add(new TreeControl (new Bi naryTree<Integer>())) ; 

6 } 

main method omitted 7 } 
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Listing26.I0 TreeControl . java 

1 import java.awt.*; 

2 import java.awt. event.*; 

3 import javax. swing.*; 
4 

5 public class TreeControl extends IPanel { 



6 private Bi naryTree<Integer> tree; // A binary tree to be displayed binary tree 

7 private JTextField jtfKey = new DTextField(5) ; 

8 private TreeView TreeView = new TreeViewO; painttree 

9 private JButton jbtlnsert = new JButton("Insert") ; 
10 private JButton jbtDelete = new DButton("Delete") ; 
11 

12 /** Construct a view for a binary tree */ 

13 public TreeControl (Bi naryTree<Integer> tree) { 

14 this. tree = tree; // Set a binary tree to be displayed 

15 setUIO; create UI 

16 } 
17 

18 /** Initialize UI for binary tree */ 

19 private void setUIO { 

20 this.setLayout(new BorderLayoutO) ; 

21 add(view, BorderLayout . CENTER) ; 

22 JPanel panel = new JPanelO; 

23 panel .add(new J Label ("Enter a key: ")); 

24 panel .add (jtfKey) ; 

25 panel .add(jbtlnsert) ; 

26 panel . add ( j btDel ete) ; 

27 add(panel, BorderLayout . SOUTH) ; 
28 

29 // Listener for the Insert button 

30 jbtlnsert. addActionLi stener(new ActionLi stener() { insert button listener 

31 public void actionPerformed(ActionEvent e) { 

32 int key = Integer. parseInt(jtfKey . getTextO) ; 

33 if (tree.search(key)) { // key is in the tree already 

34 10ptionPane.showMessageDialog(null , 

35 key + " is already in the tree"); 

36 } 

37 else { 

38 tree.insert(key) ; // Insert a new key insertkey 

39 vi ew. repai nt() ; // Redisplay the tree repaint the tree 

40 } 

41 } 

42 }); 
43 

44 // Listener for the Delete button 

45 jbtDelete. addActionLi stener(new ActionLi stener() { delete button listener 

46 public void actionPerformed(ActionEvent e) { 

47 int key = Integer. parseInt(jtfKey. getTextO) ; 

48 if (Itree.search(key)) { // key is not in the tree 

49 10ptionPane.showMessageDialog(null , 

50 key + " is not in the tree"); 

51 } 

52 else { 

53 tree . del ete(key) ; // Delete a key delete key 

54 view, repai nt() ; // Redisplay the tree repaint the tree 

55 } 

56 } 

57 }); 

58 } 
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// Inner class TreeView for displaying a tree on a panel 

class TreeView extends J Panel { 

private int radius = 20; // Tree node radius 

private int vGap = 50; // Gap between two levels in a tree 

protected void pai ntComponent(Graphi cs g) { 
super . pai ntComponent(g) ; 



if (tree.getRootO != null) { 

// Display tree recursively 

displayTree(g, tree.getRootO, getWidthO / 2, 
getWidthO / 4); 

} 



30, 



} 

/** Display a subtree rooted at position (x, y) */ 
private void displayTree (Graphics g, BinaryTree.TreeNode root, 
int x, int y, int hGap) { 

// Display the root 

g.draw0val(x - radius, y - radius, 2 * radius, 2 * radius); 
g.drawSt ring (root. element + "", x - 6, y + 4) ; 

if (root. left != null) { 

// Draw a line to the left node 
connectLeftChild(g, x - hGap, y + vGap, x, y) ; 

// Draw the left subtree recursively 

displayTree(g, root. left, x - hGap, y + vGap, hGap / 2); 

} 

if (root. right != null) { 

// Draw a line to the right node 
connectRightChild(g, x + hGap, y + vGap, x, y) ; 

// Draw the right subtree recursively 

displayTree(g, root. right, x + hGap, y + vGap, hGap / 2); 

} 



- xl) ' 
/ d); 

7 d); 



} 



/** Connect a parent at (x2 , y2) with 
* its left child at (xl, yl) */ 

private void connectLeftChi 1 d(Graphi cs g, 
int xl, int yl, int x2, int y2) { 
double d = Math . sqrt(vGap * vGap + (x2 
int xll = (int)(xl + radius * (x2 - xl) 
int yll = (int)(yl - radius * vGap / d) 
int x21 = (int)(x2 - radius * (x2 - xl) 
int y21 = (int)(y2 + radius * vGap / d) 
g.drawLine(xll, yll, x21, y21) ; 

} " 



/** Connect a parent at (x2 , y2) with 

* its right child at (xl, yl) */ 
private void connectRightChild(Graphics g, 
int xl, int yl, int x2, int y2) { 

double d = Math . sqrt(vGap * vGap + (x2 - xl) ' 

int xll = (int)(xl - radius * (xl - x2) / d) ; 

int yll = (int)(yl - radius * vGap / d) ; 

int x21 = (int)(x2 + radius * (xl - x2) / d) ; 

int y21 = (int)(y2 + radius * vGap / d) ; 

g.drawLine(xll, yll, x21, y21) ; 



(x2 - xl)); 



(x2 - xl)); 
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119 } 

120 } 

121 } 

After a new key is inserted into the tree (line 38), the tree is repainted (line 39) to reflect the 
change. After a key is deleted (line 53), the tree is repainted (line 54) to reflect the change. 

The node is displayed as a circle with radius 20 (line 62). The distance between two levels 
in the tree is defined in vGap 50 (line 63). hGap (line 77) defines the distance between two nodes 
horizontally. This value is reduced by half (hGap / 2) in the next level when the di spl ayTree 
method is called recursively (lines 86, 93). Note that vGap is not changed in the tree. 

Invoking connectLef tChil d connects a parent with its left child. You need to find the 
two endpoints (xll, yll) and (x21, y21) in order to connect the two nodes, as shown in 
Figure 26.18. The mathematical calculation for finding the two ends is illustrated in Figure 
26.18. Note that 



d = VvGap 2 + (x 2 - xj) 2 



X\\ X\ X2 X[ X2 X\ 

= , so xu = x l + radius X . 

radius d d 

yu - y\ y%- y\ ,. ^ yi - y\ 

= , so yu = y\ + radius X 

radius d d 



Invoking connectRightChil d connects a parent with its right child. The mathematical 
calculation for the two ends of the line is similar to the case for connecting a parent with its 
left child. 




(xl, yl) 

Figure 26.1 8 You need to find the position of the endpoints to connect two nodes. 

The program assumes that the keys are integers. You can easily modify the program with a 
generic type to display keys of characters or short strings. 

26.5 Iterators 

The methods inorderO, preorderO, and postorderO display the elements in 
inorder, preorder, and postorder in a binary tree. These methods are limited to dis- 
playing the elements in a tree. If you wish to process the elements in a binary tree rather than 
displaying them, these methods cannot be used. A more useful approach is to provide an iter- 
ator. An iterator is an object that provides a uniform way of traversing the elements in a con- iterator 
tainer, such as a set, list, or binary tree. 
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■ 



«interface» 
java. util.Iterator 



+hasNext(): boolean 
+next(): Object 
+remove(): void 



Returns true if the iterator has more elements. 

Returns the next element in the iterator. 

Removes from the underlying container the last element 
returned by the iterator (optional operation). 



Figure 26.19 The Iterator interface defines a uniform way of traversing the elements in 
a container. 



Java provides the java.util .Iterator interface (see Figure 26.19), which defines the 
common features of iterators. All the containers (set, list, and map) in the collections frame- 
work support iterators. 

how to create an iterator To enable the iterator to be used in a wide range of applications, you should define your 

iterator class as a subtype of java.util .Iterator. You can traverse a binary tree in 
inorder, preorder, or postorder. So, you may define three iterator classes, named 
Inorderlterator, Preorderlterator, and Postorderlterator. Since these classes 
are dependent on the BinaryTree class, it is appropriate to define them as inner classes in 
BinaryTree. Also it is convenient to add three methods named inorderlterator (), 
preorderlteratorO, and postorderlteratorO to return the iterator objects. 

The implementation of i norderlterator () is shown in lines in Listing 26.5. The imple- 
mentation of preorderlteratorO and postorderlteratorO is left as an exercise. 

The Inorderlterator constructor invokes the inorder method. The inorder (root) 
method (lines 241-246) stores all the elements from the tree in 1 ist. The elements are tra- 
versed in inorder. 

Once an Iterator object is created, its current value is initialized to (line 229), 
which points to the first element in the list. Invoking the next() method returns the current 
element and moves current to point to the next element in the list (line 258). 

The hasNextO method checks whether current is still in the range of 1 ist (line 250). 

The remove O method removes the current element from the tree (line 263). Afterward, a 
new list is created (lines 264-265). Note that current does not need to be changed. 

Listing 26.1 1 gives a test program that stores the strings in a BST and displays all strings 
in uppercase. 

Listing 26.1 1 TestBinaryTreeWithlterator. java 

1 public class TestBinaryTreeWithlterator { 

2 public static void main(String[] args) { 

3 Bi naryTree<Stri ng> tree = new Bi naryTree<Stri ng>() ; 

4 tree . i nsert("George") ; 

5 tree.insert("Michael") ; 

6 tree . i nsert("Tom") ; 

7 tree . i nsert("Adam") I 

8 tree . i nsert(" Jones") I 

9 tree . i nsert("Peter") ; 
10 tree.insert("Daniel") ; 
11 

12 java.util .Iterator iterator = tree . i norderlteratorO ; 

13 while (iterator. hasNextO) { 

14 System. out. print! n(( (St ring) (i terator . next() )) .toUpperCaseO) ; 

15 } 

16 } 

17 } 



get an iterator 
hasNext? 

get current element 
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The program constructs an iterator (line 12), which enables you to process all elements in the 
tree (lines 13-14). 

Design Guide 

Iterator is an important software design pattern. It provides a uniform way of traversing the ele- 
ments in a container, while hiding the container's structural details. By implementing the same 
interface java.util .Iterator, you can write a program that traverses the elements of all 
containers in the same way. 

§ Note 

java.util .Iterator defines a forward iterator, which traverses the element in the iterator in variations of iterators 

a forward direction, and each element can be traversed only once. Java API also provides the 
java.util . Listlterator, which supports traversing in both forward and backward direc- 
tions. If your data structure warrants flexible traversing, you may define iterator classes as a sub- 
type of java.util . Listlterator. 




iterator pattern 
advantages of iterators 



26.6 Case Study: Data Compression 

You have used the utilities such as WinZip to compress files. There are many algorithms 
for compressing data. This section introduces Huffman coding, invented by David 
Huffman in 1952. 

In ASCII, every character is encoded in 8 bits. Huffman coding compresses data by using 
fewer bits to encode characters that occur more frequently. The codes for characters are con- 
structed based on the occurrence of characters in the text using a binary tree, called the 
Huffman coding tree. Suppose the text is Mi ssi ssi ppi . Its Huffman tree can be shown as in 
Figure 26.20(a). The left and right edges of a node are assigned a value and 1, respectively. 
Each character is a leaf in the tree. The code for the character consists of the edge values in the 
path from the root to the leaf, as shown in Figure 26.20(b). Since i and s appear more than M 
and p in the text, they are assigned shorter codes. 




M P 



(a) Huffman coding tree (a) Character code table 

Figure 26.20 The codes for characters are constructed based on the occurrence of charac- 
ters in the text using a coding tree. 
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decoding The coding tree is also used for decoding a sequence of bits into a text. To do so, start with 

the first bit in the sequence and determine whether to go to the left or right branch of the root 
in the tree based on the bit value. Consider the next bit and continue go down to the left or 
right branch based on the bit value. When you reach a leaf, you have found a character. The 
next bit in the stream is the first bit of the next character. For example, the stream 011001 is 
decoded to sip with 01 matching s, 1 matching i, and 001 matching p. 

constructing coding tree To construct a Huffman coding tree, use a greedy algorithm as follows: 

1. Begin with a forest of trees. Each tree contains a node for a character. The weight of the 
node is the frequency of the character in the text. 

2. Repeat this step until there is only one tree: 

Choose two trees with the smallest weight and create a new node as their parent. The 
weight of the new tree is the sum of the weight of the subtrees. 

For each interior node, assign its left edge a value and right edge a value 1. All leaf nodes 
represent characters in the text. 

Here is an example of building a coding tree for the text Mississippi. The frequency 
table for the characters is shown in Figure 26.20(b). Initially the forest contains single-node 
trees, as shown in Figure 26.21(a). The trees are repeatedly combined to form large trees until 
only one tree is left, as shown in Figures 26.21(b), (c), and (d). 
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Figure 26.2 1 The coding tree is built using a greedy algorithm by repeatedly combining two 
smallest-weighted trees. 



prefix property It is worth noting that no code is a prefix of another code. This property ensures that the 

streams can be decoded unambiguously. 



Pedagogical Note 

Follow the link www.cs.armstrong.edu/liang/animation/HuffmanCodingflnimation.html to see how 
Huffman coding animation Huffman coding works, as shown in Figure 26.22. 
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Figure 26.22 The animation tool enables you to create and view a Huffman tree, and it performs encoding and decod- 
ing using the tree. 

Listing 26.12 gives a program that prompts the user to enter a string, displays the fre- 
quency table of the characters in the string, and displays the Huffman code for each character. 

Listing 26.12 HuffmanCode. java 

1 import java. util .Scanner; 
2 

3 public class HuffmanCode { 

4 public static void main(String[] args) { 

5 Scanner input = new Scanner(System.in) ; 

6 System. out. print("Enter a text: ") ; 

7 String text = i nput . nextLi ne() ; 
8 

9 int[] counts = getCharacterFrequency (text) ; // Count frequency count frequency 
10 

11 System . out . pri ntf ("%-15s%-15s%-15s%-15s\n" , 

12 "ASCII Code", "Character", "Frequency", "Code"); 
13 

14 Tree tree = getHuffmanTree(counts) ; // Create a Huffman tree get Huffman tree 

15 String[] codes = getCode(tree. root) ; // Get codes code for each character 
16 

17 for (int i = 0; i < codes . 1 ength ; i++) 

18 if (counts [i] != 0) // (char)i is not in text if counts [i] is 

19 System.out.printf ("%-15d%-15s%-15d%-15s\n", 

20 i, (char)i + "", counts[i], codes[i]); 

21 } 
22 

23 /** Get Huffman codes for the characters 

24 * This method is called once after a Huffman tree is built 

25 */ 

26 public static String [] getCode(Tree . Node root) { getCode 

27 if (root == null) return null; 

28 String [] codes = new String [2 * 128]; 

29 assignCode(root, codes); 

30 return codes; 

31 } 
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/* Recursively get codes to the leaf node */ 

private static void assi gnCode(Tree . Node root, String [] codes) { 
if (root. left != null) { 

root . 1 eft . code = root. code + "0"; 
assignCode(root.left, codes); 

root . ri ght . code = root. code + "1"; 
assignCode (root. right, codes); 



} 

el se { 

codes [ (i nt) root . el ement] 

} 



root . code ; 



} 



{ 



/** Get a Huffman tree from the codes */ 
public static Tree getHuffmanTree(int [] counts) 

// Create a heap to hold trees 

Heap<Tree> heap = new Heap<Tree>() ; // Defined in Listing 24.10 
for (int i = 0; i < counts . 1 ength ; i++) { 
if (counts[i] > 0) 

heap.add(new Tree(counts[i] , (char)i)); // A leaf node tree 

} 



while (heap.getSizeO > 1) { 
Tree tl = heap . remove() ; // 
Tree t2 = heap . remove() ; // 
heap.add(new Tree(tl, t2)); 

} 



Remove the smallest-weight tree 
Remove the next smallest 
// Combine two trees 



return heap. remove () ; // The final tree 

} 

/** Get the frequency of the characters */ 
public static int[] getCharacterFrequency(Stri ng text) { 
int[] counts = new int[256]; // 256 ASCII characters 



for (int i = 0; i < text. 1 ength () ; i++) 
counts[(int)text.charAt(i)]++; // Count 

return counts; 



the characters in text 



} 



/** Define a Huffman coding tree */ 
public static class Tree implements Comparabl e<Tree> 
Node root; // The root of the tree 

/** Create a tree with two subtrees */ 
public Tree(Tree tl, Tree t2) { 

root = new Node() ; 

root. left = tl.root; 

root. right = t2.root; 

root. weight = tl. root. weight + t2 . root .wei ght ; 

} 

/** Create a tree containing a leaf node */ 
public Tree(int weight, char element) { 
root = new Node (wei ght, element); 

} 
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92 /** Compare trees based on their weights */ 

93 public int compareTo(Tree o) { 

94 if (root. weight < o. root. weight) // Purposely reverse the order 

95 return 1; 

96 else if (root. weight == o. root. weight) 

97 return 0; 

98 else 

99 return -1; 
100 } 

101 

102 public class Node { tree node 

103 char element; // Stores the character for a leaf node 

104 int weight; // weight of the subtree rooted at this node 

105 Node left; // Reference to the left subtree 

106 Node right; // Reference to the right subtree 

107 String code = ""; // The code of this node from the root 
108 

109 /** Create an empty node */ 

110 public Node() { 

111 } 
112 

113 /** Create a node with the specified weight and character */ 

114 public Node(int weight, char element) { 

115 this. weight = weight; 

116 this. element = element; 

117 } 

118 } 



119 } 

120 } 
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The program prompts the user to enter a text string (lines 5-7) and counts the frequency of the 

characters in the text (line 9). The getCharacterFrequency method (lines 66-73) creates getCharacterFrequency 

an array counts to count the occurrences of each of the 256 ASCII characters in the text. If a 
character appears in the text, its corresponding count is increased by 1 (line 70). 

The program obtains a Huffman coding tree based on counts (line 14). The tree consists of 
linked nodes. The Node class is defined in lines 102-1 18. Each node consists of the properties Node class 
element (storing character), weight (storing weight of the subtree under this node), left 
(linking to the left subtree), right (linking to the right subtree), and code (storing the Huff- 
man code for the character). The Tree class (lines 76-1 19) contains the root property. From Tree class 
the root, you can access all the nodes in the tree. The Tree class implements Comparable. 
The trees are comparable based on their weights. The compare order is purposely reversed 
(lines 93-100) so that the smallest-weight tree is removed first from the heap of trees. 

The getHuf fmanTree method returns a Huffman coding tree. Initially, the single-node getHuffmanTree 
trees are created and added to the heap (lines 50-54). In each iteration of the while loop 
(lines 56-60), two smallest- weight trees are removed from the heap and are combined to form 
a big tree, and then the new tree is added to the heap. This process continues until the heap 
contains just one tree, which is our final Huffman tree for the text. 
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assignCode The assignCode method assigns the code for each node in the tree (lines 34-45). The 

getCodes getCodes method gets the code for each character in the leaf node (lines 26-31). The ele- 

ment codes [i] contains the code for character (char)i, where i is from to 255. Note 
that codes [i] is null if (char)i is not in the text. 
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Chapter Summary 





1 . A BST is a hierarchical data structure. You learned how to define and implement a BST 
class. You learned how to insert and delete elements to/from a BST. You learned how to 
traverse a BST using inorder, postorder, preorder, depth-first, and breadth-first search. 

2. An iterator is an object that provides a uniform way of traversing the elements in a 
container, such as a set, a list, or a binary tree. You learned how to define and imple- 
ment iterator classes for traversing the elements in a binary tree. 

3. Huffman coding is a scheme for compressing data by using fewer bits to encode char- 
acters that occur more frequently. The codes for characters are constructed based on the 
occurrence of characters in the text using a binary tree, called the Huffman coding tree. 

Review Questions 



Section 26.2 

26.1 Show the result of inserting 44 into Figure 26.4(b). 

26.2 Show the inorder, preorder, and postorder of traversing the elements in the binary 
tree, as shown in Figure 26.1(b). 

26.3 If a set of the same elements is inserted into a BST in two different orders, will the 
two corresponding BSTs look the same? Will the inorder traversal be the same? 
Will the postorder traversal be the same? Will the preorder traversal be the same? 

26.4 What is the time complexity of inserting an element into a BST? 
Section 26.3 

26.5 Show the result of deleting 5 5 from the tree in Figure 26.4(b). 

26.6 Show the result of deleting 60 from the tree in Figure 26.4(b). 

26.7 What is the time complexity of deleting an element from a BST? 

26.8 Is the algorithm correct if lines 202-207 in Case 2 of the deleteO method are 
replaced by the following code? 

parentOfRightMost . right = ri ghtMost . 1 eft ; 

Section 26.4 

26.9 What is an iterator? 

26. 1 Why should you define an interator class to be a subtype of java . uti 1 . Iterator? 



Programming Exercises 
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Section 26.2 

26.1* (Adding new methods in BinaryTree) Add the following new methods in 
BinaryTree. 

/** Displays the nodes in breadth-first traversal */ 
public void breadthFi rstTraversal () 

/** Returns the height of this binary tree, i.e., the 

* number of the nodes in the longest path of the root to a 
leaf */ 
public int height() 

26.2* (Testing full binary tree) A full binary tree is a binary tree with the leaves on 
the same level. Add a method in the Bi naryTree class to return true if the tree 
is full. 

(Hint: The number of nodes in a full binary tree is 2 de P th - 1.) 

/** Returns true if the tree is a full binary tree */ 
boolean i sFul 1 Bi naryTreeO 

26.3** (Implementing inorder without using recursion) Implement the inorder 
method in BinaryTree using a stack instead of recursion. 

26.4** (Implementing preorder without using recursion) Implement the preorder 
method in Bi naryTree using a stack instead of recursion. 

26.5** (Implementing postorder without using recursion) Implement the postorder 
method in Bi naryTree using a stack instead of recursion. 

26.6** (Finding the leaves) Add a method in the BinaryTree class to return the 
number of the leaves as follows: 



/** Returns the number of leaf nodes */ 
public int getNumberOfLeavesO 

26.7** (Finding the nonleaves) Add a method in the BinaryTree class to return the 
number of the nonleaves as follows: 

/** Returns the number of nonleaf nodes */ 
public int getNumberofNonLeavesQ 



Section 26.5 

26.8** (Implementing iterator on MyArrayList) Define an inner class named 
MyArrayListlterator in MyArrayList for traversing the elements on 
MyArrayList. MyArrayListlterator should implement java.util .Iter- 
ator. Add a method iterator () that returns an instance of MyArrayList- 
lterator in the MyAr rayLi st class. 

26.9** (Implementing iterator on MyLinkedList) Define an inner class named 
MyLinkedListlterator in MyLinkedList for traversing the elements on 
MyLinkedList. MyLinkedListlterator should implement 
java. util .Iterator. Add a method iterator () that returns an instance 
of MyLi nkedLi stlterator in the MyLi nkedLi st class. 

26. 10*** (Implementing bidirectional iterator) The java.util .Iterator inter- 
face defines a forward iterator. The Java API also provides the 
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26. 



java.util . Listlterator interface that defines a bidirectional itera- 
tor. Study Listlterator and define a bidirectional iterator for the 
BinaryTree class. 

{Tree clone and equals) Implement the clone and equal s method in the 
BinaryTree class. 



Comprehensive 

26.12** (BST search visualization) Write a Java applet that displays a search path, as 
shown in Figure 26.23(a). The applet allows the user to enter a key. If the key 
is not in the tree, a message dialog box is displayed. Otherwise, the nodes in 
the path from the root leading to the key are displayed in green. 
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Figure 26.23 (a) The search path is highlighted in green, (b) The applet animates how an insertion is performed. 

26. 1 3** (BST animation) The preceding exercise simply highlights a search path. 

Write a Java applet that animates how a search is performed. First you see that 
the root is searched, and then a subtree is searched recursively. When a node is 
searched, the node is highlighted in green. The search stops when a key is 
found in the tree, or displays that a key is not in the tree. 

26. 1 4** (BST insert animation) Add an Insert button to the preceding exercise to ani- 
mate how insertion is performed, as shown in Figure 26.23(b). When the Insert 
button is clicked, the applet first animates a search. If the key is already in the 
tree, display a dialog box. Otherwise, insert the key and repaint the tree. 

26. 1 5** (BST animation) Write a Java applet that animates the binary search tree 
insert, delete, and search methods, as shown in Figure 26.2. 

26. 1 6* (Generic BinaryTree using Comparator) Revise BinaryTree in Listing 
26.5, using a generic parameter and a Comparator for comparing objects. 
Define a new constructor with a Comparator as its argument as follows: 

Bi naryTree(Comparator<? super E> comparator) 

26. 1 7* (Parent reference for BinaryTree) Redefine TreeNode by adding a refer- 
ence to a node's parent, as shown below: 



BinaryTree.TreeNode<E> 

#element: E 
#left: TreeNode<E> 
#right: TreeNode<E> 
#parent: TreeNode<E> 
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Add the following two new methods in BinaryTree: 

/** Returns the parent for the specified node. */ 
public TreeNode<E> getParent(TreeNode<E> node) 

/** Returns the path from the specified node to the root 

* in an array list. */ 
public ArrayLi st<TreeNode<E» getPath(TreeNode<E> node) 

Write a test program that adds numbers 1, 2, . . . , 100 to the tree and displays 
the paths for all leaf nodes. 

26.1 8** (Add new buttons in TreeControl) Modify Listing 26.10, TreeControl.java, 
to add three new buttons Show Inorder, Show Preorder, and Show Postorder to 
display the result in a message dialog box, as shown in Figure 26.24. You need 
also to modify Binary Tree.java to implement the inorderO, preorderO, 
and postorder () methods so that each of these methods returns a List of 
node elements in inorder, preorder, and postorder, as follows: 

public java. uti 1 . Li st<E> i norderLi st() ; 
public java. uti 1 . Li st<E> preorderLi st() ; 
public java.util .List<E> postorderLi st() ; 
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Message 




Figure 26.24 When you click the Show Inorder button in (a), the tree nodes are displayed in an inorder in a message 
dialog box in (b). 



26.19** (Animation: heap) Write an applet to display a heap visually as shown in 
Figure 24.7. 

26.20*** (Data compression: Huffman coding) Write a program that prompts the user to 
enter a file name, displays the frequency table of the characters in the file, and 
displays the Huffman code for each character. 

26.2 1 *** (Data compression: Huffman coding animation) Write an applet that enables the 
user to enter a text and displays the Huffman coding tree based on the text, as 
shown in Figure 26.25(a). Display the weight of the subtree inside a subtree's root 
circle. Display each leaf node's character. Display the encoded bits for the text in 
a dialog box, as shown in Figure 26.25(b). When the user clicks the Decode Text 
button, a bit string is decoded into a text, as shown in Figure 26.25(c). 

26.22*** (Compressing a file) Write a program that prompts the user to enter a file 
name, obtains the Huffman codes for the characters in the file, and encode the 
text into a new file. Assume the original file is named abc. The encoded file 
should be named as abc . new. Also store the array of the codes for 256 ASCII 
characters using ObjectOutputStream to a file name abc . huf. 
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Figure 26.25 The animation shows the coding tree for a given text in (a), encoded bits in (b), and the text for the given 
bit sequence in (c). 



26.23*** (Decompressing a file) The preceding exercise compresses a file to generate 
two files filename.huf and filename. new. Write a program that decom- 
presses the file. The program prompts the user to enter the file name and 
decompresses it into a file named f il ename. 



Chapter 



Graphs and Applications 



Objectives 



To model real-world problems using graphs and explain the Seven Bridges of Konigsberg 
problem (§27.1). 

To describe the graph terminologies: vertices, edges, simple graphs, weighted/unweighted 
graphs, and directed/undirected graphs (§27.2). 

To represent vertices and edges using lists, adjacent matrices, 
and adjacent lists (§27.3). 

To model graphs using the Graph interface, the 
AbstractCraph class, and the UnweightedGraph 

class (§27.4). 

To display graphs visually (§27.5). 

To represent the traversal of a graph using the 
AbstractGraph.Tree class (§27.6). 

To design and implement depth-first search (§27.7). 

To design and implement breadth-first search (§27.8). 

To solve the nine-tail problem using breadth-first search (§27.9). 

To solve the Knight's Tour problem by reducing it to a 
Hamiltonian path problem (§27.10). 
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27.1 Introduction 

Graphs play an important role in modeling real-world problems. For example, the problem to 
Shortest distance find the shortest distance between two cities can be modeled using a graph, where the vertices 

represent cities and the edges represent the roads and distances between two adjacent cities, as 
shown in Figure 27.1. The problem of finding the shortest distance between two cities is 
reduced to finding a shortest path between two vertices in a graph. 



Seattle 



San 




Miami 



Figure 27.1 A graph can be used to model the distance between the cities. 



graph theory 

Seven Bridges of Kbnigsberg 



The study of graph problems is known as graph theory. Graph theory was founded by 
Leonard Euler in 1736, when he introduced graph terminology to solve the famous Seven 
Bridges of Konigsberg problem. The city of Konigsberg, Prussia (now Kaliningrad, Russia) 
was divided by the Pregel River. There were two islands on the river. The city and islands 
were connected by seven bridges, as shown in Figure 27.2(a). The question is, can one take a 
walk, cross each bridge exactly once, and return to the starting point? Euler proved that it is 
not possible. 




(a) Seven bridges sketch 
Figure 27.2 Seven bridges connected islands and land. 



(b) Graph model 



To establish a proof, Euler first abstracted the Konigsberg city map by eliminating all 
streets, producing the sketch shown in Figure 27.2(a). Second, he replaced each land mass 
with a dot, called a vertex or a node, and each bridge with a line, called an edge, as shown in 
Figure 27.2(b). This structure with vertices and edges is called a graph. 
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Looking at the graph, we ask whether there is a path starting from any vertex, traversing all 
edges exactly once, and returning to the starting vertex. Euler proved that for such path to 
exist, each vertex must have an even number of edges. Therefore, the Seven Bridges of 
Konigsberg problem has no solution. 

Graph problems are often solved using algorithms. Graph algorithms have many applica- 
tions in various areas, such as in computer science, mathematics, biology, engineering, eco- 
nomics, genetics, and social sciences. This chapter presents the algorithms for depth-first 
search and breadth-first search, and their applications. The next chapter presents the algo- 
rithms for finding a minimum spanning tree and shortest paths in weighted graphs, and their 
applications. 



27.2 Basic Graph Terminologies 

This chapter does not assume that the reader has prior knowledge of graph theory or discrete 
mathematics. We use plain and simple terms to define graphs. 

What is a graph? A graph is a mathematical structure that represents relationships among what is a graph? 
entities in the real world. For example, the graph in Figure 27.1 represents the roads and their 
distances among cities, and the graph in Figure 27.2(b) represents the bridges among land 
masses. 

A graph consists of a nonempty set of vertices, nodes, or points, and a set of edges that define a graph 
connect the vertices. For convenience, we define a graph as G = ( V, E), where V represents 
a set of vertices and E represents a set of edges. For example, V and E for the graph in Figure 
27.1 are as follows: 

V = {"Seattle", "San Francisco", "Los Angeles", 

"Denver", "Kansas City", "Chicago", "Boston", "New York", 
"Atlanta", "Miami", "Dallas", "Houston"}; 

E = {{"Seattle", "San Francisco"} , {"Seattl e" , "Chicago"}, 
{"Seattle", "Denver"}, {"San Francisco", "Denver"}, 

}; 

A graph may be directed or undirected. In a directed graph, each edge has a direction, directed vs. undirected 
which indicates that you can move from one vertex to the other through the edge. You may 
model parent/child relationships using a directed graph, where an edge from vertex A to B 
indicates that A is a parent of B. 

Figure 27.3(a) shows a directed graph. In an undirected graph, you can move in both direc- 
tions between vertices. The graph in Figure 27.1 is undirected. 




(a) A directed graph (b) A complete graph 

Figure 27.3 Graphs may appear in many forms. 



Edges may be weighted or unweighted. For example, each edge in the graph in Figure 27. 1 weighted vs. unweighted 
has a weight that represents the distance between two cities. 

Two vertices in a graph are said to be adjacent if they are connected by the same edge, adjacent 
Similarly two edges are said to be adjacent if they are connected to the same vertex. An edge 
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incident 
degree 

neighbor 
loop 

parallel edge 
simple graph 
complete graph 
spanning tree 



in a graph that joins two vertices is said to be incident to both vertices. The degree of a vertex 
is the number of edges incident to it. 

Two vertices are called neighbors if they are adjacent. Similarly two edges are called 
neighbors if they are adjacent. 

A loop is an edge that links a vertex to itself. If two vertices are connected by two or more 
edges, these edges are called parallel edges. A simple graph is one that has no loops and par- 
allel edges. A complete graph is the one in which every two pairs of vertices are connected, as 
shown in Figure 27.3(b). 

Assume that the graph is connected and undirected. A spanning tree of a graph is a sub- 
graph that is a tree and connects all vertices in the graph. 



27.3 Representing Graphs 

To write a program that processes and manipulates graphs, you have to store or represent 
graphs in the computer. 



27.3.1 Representing Vertices 

The vertices can be stored in an array. For example, you can store all the city names in the 
graph in Figure 27.1 using the following array: 

String [] vertices = {"Seattle", "San Francisco", "Los Angeles", 
"Denver", "Kansas City", "Chicago", "Boston", "New York", 
"Atlanta", "Miami", "Dallas", "Houston"}; 

HI Note 

vertex type " The vertices can be objects of any type. For example, you may consider cities as objects that con- 

tain the information such as name, population, and mayor. So, you may define vertices as follows: 

City cityO = new City ("Seattle", 563374, "Greg Nickels"); 

City cityll = new Ci ty ("Houston" , 1000203, "Bill White"); 
0bject[] vertices = {cityO, cityl, cityll}; 

public class City { 

private String cityName; 
private int population; 
private String mayor; 

public City (String cityName, int population, String mayor) { 
this . ci tyName = cityName; 
this . popul ati on = population; 
this. mayor = mayor; 



public String getCi tyName() { 
return cityName; 

} 

public int getPopulation() { 
return population; 

} 

public String getMayor() { 
return mayor; 

} 
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public void setMayor(Stri ng mayor) { 
this. mayor = mayor; 

} 

public void setPopulation(int population) { 
this. population = population; 

} 

} 

The vertices can be conveniently labeled using natural numbers 0, 1, 2, . . . , n — 1, for a 
graphs for n vertices. So, vertices [0] represents "Seattle", vertices [1] represents 
"San Franci sco", and so on, as shown in Figure 27.4. 
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Figure 27.4 An array stores the vertex names. 
Note 

You can reference a vertex by its name or its index, whichever is convenient. Obviously, it is easy reference vertex 

to access a vertex via its index in a program. 

27.3.2 Representing Edges: Edge Array 

The edges can be represented using a two-dimensional array. For example, you can store all 
the edges in the graph in Figure 27.1 using the following array: 

int[] [] edges = { 



{0, 


1}, 


{0, 


3}, 


{0, 


5}, 










{1, 


0}, 


{1, 


2}, 


{1, 


3}, 










{2, 


1}, 


{2, 


3}, 


{2, 


4}, 


{2, 


10}, 






{3, 


0}, 


{3, 


1}, 


{3, 


2}, 


{3, 


4}, 


{3, 


5}, 


{4, 


2}, 


{4, 


3}, 


{4, 


5}, 


{4, 


7}, 


{4, 


8}, {4, 


{5, 


0}, 


{5, 


3}, 


{5, 


4}, 


{5, 


6}, 


{5, 


7}, 


{6, 


5}, 


{6, 


7}, 














{7, 


4}, 


{7, 


5}, 


{7, 


6}, 


{7, 


8}, 






{8, 


4}, 


{8, 


7}, 


{8, 


9}, 


{8, 


10}, 


{8, 


11}, 
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{9, 8}, {9, 11}, 

{10, 2}, {10, 4}, {10, 8}, {10, 11}, 
{11, 8}, {11, 9}, {11, 10} 

}; 

array edge This is known as the edge representation using arrays. 

27.3.3 Representing Edges: Edge Objects 

Another way to represent the edges is to define edges as objects and store the edges in a 
java.util .ArrayList. The Edge class can be defined as follows: 

public class Edge { 
int u ; 
int v; 

public Edge(int u, int v) { 
this . u = u ; 
this.v = v; 

} 

} 

For example, you can store all the edges in the graph in Figure 27.1 using the following list: 

java. uti 1 .ArrayLi st<Edge> list = new java. uti 1 . ArrayLi st<Edge>() ; 
1 i st. add (new Edge (0, 1)); 
1 i st. add (new Edge (0, 3)); 
1 i st. add (new Edge (0, 5)); 



Storing Edge objects in an ArrayList is useful if you don't know the edges in advance. 

Representing edges using edge array or Edge objects in §27.3.2 and §27.3.3 is intuitive for 
input, but not efficient for internal processing. The next two sections introduce the represen- 
tation of graphs using adjacency matrices and adjacency lists. These two data structures are 
efficient for processing graphs. 

27.3.4 Representing Edges: Adjacency Matrices 

Assume that the graph has n vertices. You can use a two-dimensional n X n matrix, say 
adjacencyMatrix, to represent edges. Each element in the array is or 1. 
adjacencyMatrix[i] [j] is 1 if there is an edge from vertex ; to vertex j; otherwise, 
adjacencyMatrix[i] [j] is 0. If the graph is undirected, the matrix is symmetric, because 
adjacencyMatrix[i] [j] is the same as adjacencyMatrix[j] [i]. For example, the 
edges in the graph in Figure 27.1 can be represented using an adjacency matrix as follows: 

int[][] adjacencyMatrix = { 



{0, 
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// 
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// 
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// 
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// 


New York 


{0, 






















1}, 


// 


Atlanta 


{0, 






















1}, 


// 


Mi ami 


{0, 






















1}, 


// 


Dallas 


{0, 






















0} 


// 


Houston 



}; 
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|p Note 

Since the matrix is symmetric for an undirected graph, to save storage you may use a ragged array. ragged array 

The adjacency matrix for the directed graph in Figure 27.3(a) can be represented as 
follows: 



-int[][] a = {{0, 0, 1, 0, 0}, // Peter 

{0, 0, 1, 0, 0}, // Dane 

{0, 0, 0, 0, 1}, // Mark 

{0, 0, 0, 0, 1}, // Cindy 

{0, 0, 0, 0, 0} // Wendy 

}; 



27.3.5 Representing Edges: Adjacency Lists 

To represent edges using adjacency lists, define an array of lists. The array has n entries. Each 
entry is a linked list. The linked list for vertex i contains all the vertices j such that there is an 
edge from vertex i to vertex j. For example, to represent the edges in the graph in Figure 27.1, 
you may create an array of linked lists as follows: 

java. uti 1 . Li nkedLi st [] neighbors = new java. uti 1 . Li nkedLi st [12] ; 

1 i sts [0] contains all vertices adjacent to vertex (i.e., Seattle), 1 i sts [1] contains all ver- 
tices adjacent to vertex 1 (i.e., San Francisco), and so on, as shown in Figure 27.5. 
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Figure 27.5 Edges in the graph in Figure 27.1 are represented using linked lists. 



To represent the edges in the graph in Figure 27.3(a), you may create an array of linked 
lists as follows: 

java.util .LinkedList[] neighbors = new java. uti 1 . Li nkedLi st [5] ; 

1 i sts [0] contains all vertices pointed from vertex via directed edges, 1 i sts [1] contains 
all vertices pointed from vertex 1 via directed edges, and so on, as shown in Figure 27.6. 
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Peter 

Jane 

Mark 

Cindy 

Wendy 



nei ghbors [0]- 



neighbors[l]. 



neighbors[2]. 



neighbors[3]. 



nei ghbors [4]- 



nuH 



Figure 27.6 Edges in the graph in Figure 27.3(a) are represented using linked lists. 



adjacency matrices vs. 
adjacency lists 



Note 

You can represent a graph using an adjacency matrix or adjacency lists. Which one is better? If 
the graph is dense (i.e., there are a lot of edges), using an adjacency matrix is preferred. If the 
graph is very sparse (i.e., very few edges), using adjacency lists is better, because using an adja- 
cency matrix would waste a lot of space. 

Both adjacency matrices and adjacency lists may be used in a program to make algorithms 
more efficient. For example, it takes 0( I ) constant time to check whether two vertices are con- 
nected using an adjacency matrix and it takes linear time 0(m) to print all edges in a graph using 
adjacency lists, where m is the number of edges. 



other representations 



using ArrayList 



Note 

Adjacency matrices and adjacency lists are two common representations for graphs, but they are 
not the only ways to represent graphs. For example, you may define a vertex as an object with a 
method getNeighborsO that returns all its neighbors. For simplicity, the text will use adja- 
cency lists to represent graphs. Other representations will be explored in the exercises. 

For flexibility and simplicity, we will use array lists to represent arrays. Also we will use 
array lists instead of linked lists, because our algorithms only require searching for adjacent 
vertices in the list. Using array lists is more efficient for our algorithms. Using array lists, the 
adjacency list in Figure 27.5 can be built as follows: 

Li st<ArrayLi st<Integer» nei ghbors 

= new ArrayList<List<Integer»0 ; 
nei ghbors . add (new Array Li st<Integer>()) ; 
neighbors. get(0) .add(l) ; neighbors. get(0) .add(3) ; 

nei ghbors . get(0) . add (5) ; 
nei ghbors . add (new Array Li st<Integer>()) ; 
nei ghbors . get (1) . add(0) ; neighbors . get(l) . add (2) ; 

neighbors. get(l) .add(3) ; 



27.4 Modeling Graphs 

The Java Collections Framework serves as a good example for designing complex data struc- 
tures. The common features of data structures are defined in the interfaces (e.g., Collection, 
Set, List), as shown in Figure 22.1. Abstract classes (e.g., Abstracted lection, 
AbstractSet, AbstractList) partially implement the interfaces. Concrete classes (e.g., 
HashSet, LinkedHashSet, TreeSet, ArrayList, LinkedList, Priori tyQueue) provide 
concrete implementations. This design pattern is useful to model graphs. We will define an inter- 
face named Graph that contains all common operations of graphs and an abstract class named 
AbstractCraph that partially implements the Graph interface. Many concrete graphs may be 
added to the design. For example, we will define such graphs named UnweightedGraph and 
WeightedGraph. The relationships of these interfaces and classes are illustrated in Figure 27.7. 
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Graph | <- 













AbstractCraph | 


.... 







UnweightedGraph 



■ WeightedGraph 



Interface Abstract Class Concrete Classes 

Figure 27.7 Graphs can be modeled using interfaces, abstract classes, and concrete classes. 



«interface» 


- The generic type V is the type for vertices. 


Graph<V> ~* 




+getSize() : int 




Returns the number of vertices in the graph. 


+getVerti ces() : List<V> 




Returns the vertices in the graph. 


+getVertex(index: int): V 




Returns the vertex object for the specified vertex index. 


+getlndex(v: V) : int 




Returns the index for the specified vertex. 


+getNeighbors(index: int): Li st<Integer> 




Returns the neighbors of vertex with the specified index. 


+getDegree(index: int): int 




Returns the degree for a specified vertex index. 


+getAdjacencyMatrix() : int[] [] 




Returns the adjacency matrix. 


+pri ntAdj acencyMatri x() : void 




Prints the adjacency matrix. 


+printEdges() : void 




Prints the edges. 


+dfs(index: int): AbstractCraph<V> .Tree 




Obtains a depth-first search tree. 


+bfs(index: int): AbstractCraph<V> .Tree 




Obtains a breadth-first search tree. 



I 

AbstractGraph< V> 



#vertices: List<V> 

#neighbors: Li st<Li st<Integer» 



#AbstractGraph(edges : int[][], vertices: V[]) 

#AbstractGraph (edges : Li st<Edge>, 

vertices: List<V>) 
#AbstractGraph(edges : int[][], 

numberOfVerti ces : int) 
#AbstractGraph (edges : Li st<Edge>, 

numberOfVerti ces : int) 
Inner classes Tree is defined here 



T 



Vertices in the graph. 




Neighbors for each vertex in the graph. 




Constructs a graph with the specified edj 


;es and vertices 


in arrays. 




Constructs a graph with the specified edj 


;es and vertices 


stored in lists. 




Constructs a graph with the specified edj 


;es in an array 


and the integer vertices 1, 2, .... 




Constructs a graph with the specified edj 


;es in a list and 


the integer vertices 1, 2 





UnweightedGraph<V> 


+UnweightedGraph(edges : 


i nt [] [] , verti ces : 


V[]) " 




+UnweightedGraph(edges : 


List<Edge>, 


vertices: List<V>) 




+UnweightedGraph(edges : 


List<Edge>, 


numberOfVerti ces : int) 




+UnweightedGraph(edges : 


int[] [], 


numberOfVerti ces : int) 





Constructs a graph with the specified edges and vertices 
in arrays. 

Constructs a graph with the specified edges and vertices 

stored in lists. 
Constructs a graph with the specified edges in an array 

and the integer vertices 1, 2, .... 
Constructs a graph with the specified edges in a list and 

the integer vertices 1,2, .... 



Figure 27.8 The Graph interface defines the common operations for all types of graphs. 
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What are the common operations for a graph? In general, you need to get the number of 
vertices in a graph, get all vertices in a graph, get the vertex object with a specified index, get 
the index of the vertex with a specified name, get the neighbors for a vertex, get the adjacency 
matrix, get the degree for a vertex, perform a depth-first search, and perform a breadth-first 
search. Depth-first search and breadth-first search will be introduced in the next section. 
Figure 27.8 illustrates these methods in the UML diagram. 

AbstractGraph does not introduce any new methods. A list of vertices and a list of adja- 
cency lists for the vertices are defined in the AbstractGraph class. With these data fields, it 
is sufficient to implement all the methods defined in the Graph interface. 

Unwei ghtedGraph simply extends AbstractGraph with four constructors for creating the 
concrete Graph instances. Unwei ghtedGraph inherits all methods from AbstractGraph, 
and it does not introduce any new methods. 

# Note 

You can create a graph with any type of vertices. Each vertex is associated with an index, which 
vertices and their indices is the same as the index of the vertex in the list for vertices. If you create a graph without speci- 

fying the vertices, the vertices are the same as their indices. 

|§| Note 

why AbstractGraph? The AbstractGraph class implements all the methods in the Graph interface. So, why is it 

defined as abstract? In the future, you may need to add new methods to the Graph interface that 
cannot be implemented in AbstractGraph. To make the classes easy to maintain, it is desir- 
able to define the AbstractGraph class as abstract. 

Assume all these interfaces and classes are available. Listing 27.1 gives a test program that 
creates a graph for the one in Figure 27.1 and another graph for the one in Figure 27.3(a). 

Listing 27.1 TestGraph. java 

1 public class TestGraph { 



2 public static void main(String[] args) { 

vertices 3 String[] vertices = {"Seattle", "San Francisco", "Los Angeles", 

4 "Denver", "Kansas City", "Chicago", "Boston", "New York", 

5 "Atlanta", "Miami", "Dallas", "Houston"}; 

6 

7 // Edge array for graph in Figure 27.1 

edges 8 int[][] edges = { 

9 {0, 1}, {0, 3}, {0, 5}, 

10 {1, 0}, {1, 2}, {1, 3}, 

11 {2, 1}, {2, 3}, {2, 4}, {2, 10}, 

12 {3, 0}, {3, 1}, {3, 2}, {3, 4}, {3, 5}, 

13 {4, 2}, {4, 3}, {4, 5}, {4, 7}, {4, 8}, {4, 10}, 

14 {5, 0}, {5, 3}, {5, 4}, {5, 6}, {5, 7}, 

15 {6, 5}, {6, 7}, 

16 {7, 4}, {7, 5}, {7, 6}, {7, 8}, 

17 {8, 4}, {8, 7}, {8, 9}, {8, 10}, {8, 11}, 

18 {9, 8}, {9, 11}, 

19 {10, 2}, {10, 4}, {10, 8}, {10, 11}, 

20 {11, 8}, {11, 9}, {11, 10} 

21 }; 
22 

create a graph 23 Craph<Stri ng> graphl = 

24 new UnweightedCraph<Stri ng>(edges , vertices); 

25 System. out. println ("The number of vertices in graphl: " 
number of vertices 26 + graphl . getSi ze() ) ; 

27 System. out. println("The vertex with index 1 is " 

getvertex 28 + graphl . getVertex(l) ) ; 
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29 
30 
31 
32 
33 
34 
35 
36 
37 
38 
39 
40 
41 
42 
43 
44 
45 
46 
47 
48 
49 
50 
51 
52 
53 
54 
55 
56 

57 } 



System. out. println("The index for Miami is " + 

graphl.getIndex("Miami")) ; 
System. out. pri ntl n ("The edges for graphl:"); 
graphl. pri nt Edges () ; 

System. out. pri ntl n ("Adjacency matrix for graphl: 
graphl. pri ntAd jacencyMatri x() ; 



); 



// List of Edge objects for graph in Figure 27.3(a) 
String[] names = {"Peter", "Jane", "Mark", "Cindy", "Wendy" 
java.util . ArrayLi st<AbstractCraph . Edge> edgeList 

= new java. uti 1 .ArrayLi st<AbstractGraph . Edge>() ; 
edgeLi st . add(new AbstractCraph . Edge(0, 2)) 
edgeLi st . add(new AbstractGraph . Edge(l , 2)) 
edgeLi st . add(new AbstractGraph . Edge(2 , 4)) 
edgeLi st . add(new AbstractGraph . Edge(3 , 4)) 
// Create a graph with 5 vertices 
Graph<Stri ng> graph2 = new Unwei ghtedGraph<Stri ng> 

(edgeList, java.util .Arrays . asLi st(names)) ; 
System. out. println("The number of vertices in graph2 

+ graph2 .getSizeO) ; 
System. out. println("The edges for graph2:"); 
graph2 . pri nt Edges () ; 

System. out. pri ntl n("\nAdjacency matrix for graph2:") 
graph2 . pri ntAd jacencyMatri x() ; 



}; 



get index 
print edges 

print adjacency matrix 
list of Edge objects 



create a graph 
print edges 

print adjacency matrix 



for (int i = 0; i < 5; i++) 
System. out .pri ntl n("vertex 



+ i + 



+ graph2 . getVertex(i )) ; 



The number of vertices in graphl: 12 
The vertex with index lis San Francisco 
The index for Miami is 9 
The edges for graphl: 



Vertex 
Vertex 1 
Vertex 2 
Vertex 3 
Vertex 4 
Vertex 5 
Vertex 6 
Vertex 7 
Vertex 8 
Vertex 9 
Vertex 10: 
Vertex 11: 



(0, 

CI, 
C2, 
C3, 
C4, 
C5, 
C6, 
C7, 
C8, 
C9, 



1) 
0) 
1) 
0) 
2) 
0) 
5) 
4) 
4) 
8) 
C10, 2) 
(11, 8) 



(0, 
(1, 
(2, 
(3, 
(4, 
(5, 
(6, 
(7, 
(8, 
(9, 



3) 
2) 
3) 
1) 
3) 
3) 
7) 
5) 
7) 
11) 



(0, 

a, 

C2, 
C3, 
C4, 
C5, 

C7, 
C8, 



C10, 
Cll, 



4) 
9) 



5) 
3) 
4) 
2) 
5) 
4) 

6) 
9) 

C10, 
Cll, 



(2, 
(3, 
(4, 
(5, 

(7, 
(8, 



10) 

4) (3, 



7) 
6) 

8) 
10) 



(4, 
C5, 



5) 
8) 
7) 



C4, 10) 



C8, 11) 



8) C10, 11) 
10) 



Adjacency matrix for graphl: 



1 

1 

1 

1 1 




01000000 
00000000 
10000010 







10 

1 
1 
00000000 
00101000 
00000000 



10 10 







111 

1 
1 
110 
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The number of vertices in graph2: 5 

The edges for graph2: 

Vertex 0: (0, 2) 

Vertex 1: (1, 2) 

Vertex 2: (2, 4) 

Vertex 3: (3, 4) 

Vertex 4: 

Adjacency matrix for graph2: 

10 

10 

1 

1 



vertex 0: Peter 

vertex 1: Jane 

vertex 2: Mark 

vertex 3: Cindy 

vertex 4: Wendy 



The program creates graphl for the graph in Figure 27.1 in lines 3-24. The vertices for 
graph 1 are defined in lines 3-5. The edges for graphl are defined in 8-21. The edges are 
represented using a two-dimensional array. For each row i in the array, edges [i] [0] and 
edges [i][l] indicate that there is an edge from vertex edges [i][0] to vertex 
edges [i][l]. For example, the first row {0, 1} represents the edge from vertex 
(edges [0] [0]) to vertex 1 (edges [0] [1]). The row {0, 5} represents the edge from vertex 
(edges [2] [0]) to vertex 5 (edges [2] [1]). The graph is created in line 24. Line 32 
invokes the printEdgesO method on graphl to display all edges in graphl. Line 34 
invokes the printAdjacencyMatrix() method on graphl to display the adjacency matrix 
for graphl. 

The program creates graph2 for the graph in Figure 27.3(a) in lines 37-46. The edges for 
graph2 are defined in lines 4CM-3. graph2 is created using a list of Edge objects in line 46. 
Line 50 invokes the printEdgesO method on graph2 to display all edges in graph2. Line 
52 invokes the printAdjacencyMatrixO method on graph2 to display the adjacency 
matrix for graphl. 

Note that both graphs contain the vertices of strings. The vertices are associated with 
indices 0,1, . . . , n-1. The index is the location of the vertex in vertices. For example, the 
index of vertex Miami is 9. 

Now we turn our attention to implementing the interface and classes. Listings 27.2, 27.3, 
and 27.4 give the Graph interface, the AbstractGraph class, and the UnweightedGraph 
class, respectively. 

Listing 27.2 Graph, java 

1 public interface Craph<V> { 

2 /** Return the number of vertices in the graph */ 



getSize 



3 
4 
5 
6 
7 
8 
9 
10 



public int getSizeQ; 



getVertices 



/** Return the vertices in the graph */ 
public java. uti 1 . Li st<V> getVerti ces () ; 



getVertex 



/** Return the object for the specified vertex index */ 
public V getVertex(int index); 
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11 

12 
13 
14 
15 
16 
17 
18 
19 
20 
21 
22 
23 
24 
25 
26 
27 
28 
29 
30 
31 
32 
33 
34 



/** Return the index for the specified vertex object */ 
public int getIndex(V v) ; 

/** Return the neighbors of vertex with the specified index */ 
public java. uti 1 . Li st<Integer> getNeighbors(int index); 

/** Return the degree for a specified vertex */ 
public int getDegree(int v) ; 

/** Return the adjacency matrix */ 
public int[][] getAdjacencyMatrixO ; 

/** Print the adjacency matrix */ 
public void printAdjacencyMatrixO ; 

/** Print the edges */ 
public void pri ntEdgesO ; 

/** Obtain a depth-first search tree */ 
public AbstractCraph<V> .Tree dfs(int v) ; 

/** Obtain a breadth-first search tree */ 
public AbstractCraph<V>.Tree bfs(int v) ; 



getlndex 

getNeighbors 

getDegree 

getAd j acencyMatri x 

printAdjacencyMatrix 

printEdges 

dfs 

bfs 



Listing 27.3 AbstractGraph . java 

1 import java. uti 1 ; 

2 

3 public abstract class AbstractGraph<V> implements Graph<V> { 

4 protected List<V> vertices; // Store vertices 

5 protected Li st<Li st<Integer» neighbors; // Adjacency lists 
6 

7 /** Construct a graph from edges and vertices stored in arrays */ 

8 protected AbstractGraph(int [] [] edges, V[] vertices) { constructor 

9 this. vertices = new ArrayLi st<V>() ; 

10 for (int i = 0; i < verti ces . 1 ength ; i++) 

11 this. vertices. add(vertices[i]) ; 
12 

13 createAdjacencyLi sts(edges , verti ces . 1 ength) ; 

14 } 
15 

16 /** Construct a graph from edges and vertices stored in List */ 

17 protected AbstractGraph (Li st<Edge> edges, List<V> vertices) { constructor 

18 this. vertices = vertices; 

19 createAdjacencyLi sts(edges , vertices. size()) ; 

20 } 
21 

22 /** Construct a graph for integer vertices 0, 1, 2 and edge list */ 

23 protected AbstractGraph(Li st<Edge> edges, int numberOfVerti ces) { constructor 

24 vertices = new ArrayLi st<V>() ; // Create vertices 

25 for (int i = 0; i < numberOfVerti ces ; i++) { 

26 verti ces . add((V) (new Integer(i ))) ; // vertices is {0, 1, ...} 

27 } 

28 createAdjacencyLi sts(edges , numberOfVerti ces) ; 

29 } 
30 
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constructor 



getSize 



getVertices 



getVertex 



getlndex 



31 
32 
33 
34 
35 
36 
37 
38 
39 
40 
41 
42 
43 
44 
45 
46 
47 
48 
49 
50 
51 
52 
53 
54 
55 
56 
57 
58 
59 
60 
61 
62 
63 
64 
65 
66 
67 
68 
69 
70 
71 
72 
73 
74 
75 
76 
77 
78 
79 
80 
81 
82 
83 
84 
85 
86 
87 
88 
89 



/** Construct a graph from integer vertices 0, 1, and edge array 
protected AbstractGraph(int [] [] edges, int numberOfVerti ces) { 

vertices = new ArrayLi st<V>() ; // Create vertices 

for (int i = 0; i < numberOfVerti ces ; i++) { 

verti ces . add ((V) (new Integer(i ))) ; // vertices is {0, 1, ... 

} 

createAdjacencyLi sts(edges , numberOfVerti ces) ; 



7 



{ 



/** Create adjacency lists for each vertex 
private void createAdjacencyLi sts( 

int[][] edges, int numberOfVerti ces) 
// Create a linked list 

neighbors = new ArrayLi st<Li st<Integer»() 
for (int i = 0; i < numberOfVerti ces ; i++) 
neighbors. add(new ArrayLi st<Integer>()) ; 

} 



for (int i = 0; i < edges . 1 ength ; i++) { 
int u = edges [i ] [0] ; 
int v = edges [i ] [1] ; 
neighbors .get(u) .add(v) ; 

} 

} 

/** Create adjacency lists for each vertex */ 
private void createAdjacencyLi sts( 

List<Edge> edges, int numberOfVerti ces) { 
// Create a linked list 

neighbors = new ArrayList<List<Integer»() ; 
for (int i = 0; i < numberOfVerti ces ; i++) { 
neighbors. add(new ArrayLi st<Integer>()) ; 

} 

for (Edge edge: edges) { 

nei ghbors . get (edge . u) . add (edge . v) ; 

} 

} 

/** Return the number of vertices in the graph */ 
public int getSize() { 
return verti ces . si ze() ; 

} 

/** Return the vertices in the graph */ 
public List<V> getVerti ces() { 
return vertices; 

} 

/** Return the object for the specified vertex */ 
public V getVertex(int index) { 
return verti ces . get(i ndex) ; 

} 

/** Return the index for the specified vertex object */ 
public int getIndex(V v) { 
return verti ces . i ndexOf(v) ; 

} 
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90 /** Return the neighbors of vertex with the specified index */ 

91 public List<Integer> getNeighbors(int index) { getNeighbors 

92 return neighbors . get(i ndex) ; 

93 } 
94 

95 /** Return the degree for a specified vertex */ 

96 public int getDegree(int v) { getDegrees 

97 return neighbors. get(v) .size() ; 

98 } 
99 

100 /** Return the adjacency matrix */ 

101 public int[][] getAdjacencyMatri x() { getAdjacencyMatrix 

102 int[][] adjacencyMatrix = new int[getSize()] [getSizeO] ; 
103 

104 for (int i = 0; i < neighbors. sizeO ; i++) { 

105 for (int j = 0; j < neighbors. get(i) .size() ; { 

106 int v = nei ghbors . get(i ) . get(j) ; 

107 adjacencyMatri x [i ] [v] = 1; 

108 } 

109 } 
110 

111 return adjacencyMatrix; 

112 } 
113 

114 /** Print the adjacency matrix */ 

115 public void pri ntAdjacencyMatrixO { printAdjacencyMatrix 

116 int[][] adjacencyMatrix = getAdjacencyMatrix() ; 

117 for (int i = 0; i < adjacencyMatri x . 1 ength ; i++) { 

118 for (int j = 0; j < adjacencyMatrix[0] .length; j++) { 

119 System. out. pri nt(adjacencyMatri x [i ] [j] + " "); 

120 } 
121 

122 System. out. println() ; 

123 } 

124 } 
125 

126 /** Print the edges */ 

127 public void printEdgesO { printEdges 

128 for (int u = 0; u < neighbors. sizeO ; u++) { 

129 System. out. print("Vertex " + u + ": ") ; 

130 for (int j = 0; j < nei ghbors . get(u) . si ze() ; j++) { 

131 System. out. print("(" + u + ", " + 

132 neighbors. get(u) .get(j) + ") ") ; 

133 } 

134 System. out. println() ; 

135 } 

136 } 
137 

138 /** Edge inner class inside the AbstractCraph class */ 

139 public static class Edge { Edge inner class 

140 public int u; // Starting vertex of the edge 

141 public int v; // Ending vertex of the edge 
142 

143 /** Construct an edge for (u, v) */ 

144 public Edge(int u, int v) { 

145 this.u = u; 

146 this.v = v; 

147 } 

148 } 
149 
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dfs method 



bfs method 



150 
151 
152 
153 
154 
155 
156 
157 
158 
159 
160 
161 
162 
163 
164 
165 
166 
167 
168 
169 
170 
171 
172 
173 
174 
175 
176 
177 
178 
179 
180 
181 
182 
183 
184 
185 
186 
187 
188 
189 
190 
191 
192 
193 
194 
195 
196 
197 
198 
199 
200 
201 
202 
203 
204 
205 
206 
207 
208 



/** Obtain a DFS tree starting from vertex v */ 
/** To be discussed in Section 27.6 */ 
public Tree dfs(int v) { 

Li st<Integer> searchOrders = new ArrayLi st<Integer>() ; 

int[] parent = new int[vertices.size()] ; 

for (int i = 0; i < parent . 1 ength ; i++) 

parent[i] = -1; // Initialize parent[i] to -1 

// Mark visited vertices 

boolean[] isVisited = new bool ean [vertices. si ze ()] ; 

// Recursively search 

dfs(v, parent, searchOrders, isVisited); 

// Return a search tree 

return new Tree(v, parent, searchOrders); 

} 

/** Recursive method for DFS search */ 

private void dfs(int v, int[] parent, Li st<Integer> searchOrders, 
bool ean [] isVisited) { 

// Store the visited vertex 
searchOrders . add(v) ; 

isVisited[v] = true; // Vertex v visited 

for (int i : neighbors. get(v)) { 
if (HsVisited[i]) { 

parent[i] = v; // The parent of vertex i is v 

dfs(i , parent, searchOrders, isVisited); // Recursive search 

} 

} 

} 

/** Starting bfs search from vertex v */ 
/** To be discussed in Section 27.7 */ 
public Tree bfs(int v) { 

Li st<Integer> searchOrders = new ArrayLi st<Integer>() ; 

int[] parent = new int[vertices.size()] ; 

for (int i = 0; i < parent . 1 ength ; i++) 

parent[i] = -1; // Initialize parent[i] to -1 

java. uti 1 . Li nkedLi st<Integer> queue = 

new java. uti 1 . Li nkedLi st<Integer>() ; // list used as a queue 
boolean[] isVisited = new bool ean [vertices. si ze ()] ; 
queue . offer(v) ; // Enqueue v 
isVisited[v] = true; // Mark it visited 

while (Iqueue.isEmptyO) { 

int u = queue.poll(); // Dequeue to u 
searchOrders .add(u) ; // u searched 
for (int w : nei ghbors . get(u)) { 
if (HsVisitedM) { 

queue. offer(w) ; // Enqueue w 
parent[w] = u; // The parent of w is u 



isVisited[w] = true; // Mark it visited 



} 
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209 return new Tree(v, parent, searchOrders) ; 

210 } 
211 

212 /** Tree inner class inside the AbstractCraph class */ 

213 /** To be discussed in Section 27.5 */ 

214 public class Tree { Tree inner class 

215 private int root; // The root of the tree 

216 private int[] parent; // Store the parent of each vertex 

217 private Li st<Integer> searchOrders; // Store the search order 
218 

219 /** Construct a tree with root, parent, and searchOrder */ 

220 public Tree(int root, int[] parent, Li st<Integer> searchOrders) { 

221 this. root = root; 

222 this. parent = parent; 

223 this. searchOrders = searchOrders; 

224 } 
225 

226 /** Construct a tree with root and parent without a 

227 * particular order */ 

228 public Tree(int root, int[] parent) { 

229 this. root = root; 

230 this. parent = parent; 

231 } 
232 

233 /** Return the root of the tree */ 

234 public int getRootfJ { 

235 return root; 

236 } 
237 

238 /** Return the parent of vertex v */ 

239 public int getParent(int v) { 

240 return parent [v]; 

241 } 
242 

243 /** Return an array representing search order */ 

244 public Li st<Integer> getSearchOrdersO { 

245 return searchOrders; 

246 } 
247 

248 /** Return number of vertices found */ 

249 public int getNumberOfVerti cesFoundO { 

250 return searchOrders . si ze() ; 

251 } 
252 

253 /** Return the path of vertices from a vertex index to the root */ 

254 public List<V> getPath(int index) { 

255 ArrayLi st<V> path = new ArrayLi st<V>() ; 
256 

257 do { 

258 path.add(vertices.get(index)) ; 

259 index = parent [i ndex] ; 

260 } 

261 while (index != -1); 
262 

263 return path; 

264 } 
265 

266 /** Print a path from the root to vertex v */ 

267 public void pri ntPath(int index) { 

268 List<V> path = getPath (index) ; 
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269 System. out. print("A path from " + vertices. get(root) + " to " + 

270 vertices. get (index) + ": ") ; 

271 for (int i = path.size() - 1; i >= 0; i — ) 

272 System. out. print(path.get(i) + " ") ; 

273 } 
274 

275 /** Print the whole tree */ 

276 public void printTreeO { 

277 System. out. pri ntl n("Root is: " + vertices. get(root)) ; 

278 System. out. pri nt("Edges: ") ; 

279 for (int i =0; i < parent . 1 ength ; i++) { 

280 if (parent [i] != -1) { 

281 // Display an edge 

282 System. out. print("(" + vertices. get(parent[i]) + ", " + 

283 vertices. get(i) + ") ") ; 

284 } 

285 } 

286 System, out. pri ntl n () ; 

287 } 



288 } 

289 } 



Listing 27.4 UnweightedGraph. java 



constructor 



constructor 



constructor 



constructor 



1 
2 
3 
4 
5 
6 
7 
8 
9 
10 
11 
12 
13 
14 
15 
16 
17 
18 
19 
20 
21 
22 
23 



import java.util.*; 



public class U 

/** Construe 
public Unwei 
super (edge 

} 

/** Construe 
public Unwei 
super (edge 

} 

/** Construe 
public Unwei 
super (edge 

} 

/** Construe 
public Unwei 
super (edge 

} 

} 



nwei ghtedCraph<V> extends AbstractGraph<V> { 

t a graph from edges and vertices stored in arrays */ 
ghtedGraph(int[] [] edges, V[] vertices) { 
s, vertices); 



t a graph from edges and vertices stored in List */ 
ghtedGraph(Li st<Edge> edges, List<V> vertices) { 
s, vertices); 



t a graph for integer vertices 0, 1, 2 and edge list */ 
ghtedCraph(Li st<Edge> edges, int numberOfVerti ces) { 
s, numberOfVerti ces) ; 



t a graph from integer vertices 0, 1, and edge array */ 
ghtedGraph(int[] [] edges, int numberOfVerti ces) { 
s, numberOfVerti ces) ; 



The code in the Graph interface in Listing 27.2 and the UnweightedGraph class are 
straightforward. Let us digest the code in the AbstractGraph class in Listing 27.3. 

The AbstractGraph class defines the data field vertices (line 4) to store vertices and 
neighbors (line 5) to store edges in adjacency lists, neighbors. get(i) stores all vertices 
adjacent to vertex i. Four overloaded constructors are defined in lines 8-38 to create graphs 
from arrays or lists of edges and vertices. The createAdjacencyLists(int[] [] edges, 
int numberOfVerti ce) method creates adjacency lists from edges in an array (lines 
41-54). The createAdjacencyLists(List<Edge> edges, int numberOfVerti ce) 
method creates adjacency lists from edges in a list (lines 57-68). 
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The getAdjacencyMatrixO method (lines 101-112) returns a two-dimensional array 
for representing an adjacency matrix of the edges. The printAdjacencyMatrixO method 
(lines 115-124) displays the adjacency matrix. The printEdgesO method (lines 127-136) 
displays all vertices and edges adjacent to each vertex. 

The code in lines 150-288 gives the methods for finding a depth-first search tree and a 
breadth-first search tree, which will be introduced in §§27.7-27.8. 

27.5 Graph Visualization 

The preceding section introduced how to model a graph using the Graph interface, 
AbstractGraph class, and UnweightedGraph class. This section introduces how to dis- 
play graphs graphically. In order to display a graph, you need to know where each vertex is 
displayed and the name of each vertex. To ensure a graph can be displayed, we define an inter- 
face named Di spl ayabl e in Listing 27.5 and make vertices instances of Di spl ayabl e. 

Listing 27.5 Di spl ayabl e. java 

1 public interface Di spl ayabl e { Di spl ayabl e interface 

2 public int getXO; // Get x-coordinate of the vertex 

3 public int getYO; // Get y-coordinate of the vertex 

4 public String getNameO; // Get display name of the vertex 

5 } 

A graph with Di spl ayabl e vertices can now be displayed on a panel named GraphVi ew as 
shown in Listing 27.6. 

Listing 27.6 GraphVi ew.java 

1 public class GraphView extends javax. swing. JPanel { Di spl ayabl e interface 



2 private Craph<? extends Di spl ayabl e> graph; 
3 

4 public GraphVi ew(Graph<? extends Di spl ayabl e> graph) { 

5 this. graph = graph; 

6 } 
7 

8 protected void paintComponent(java.awt. Graphics g) { 

9 super . pai ntComponent(g) ; 
10 

11 // Draw vertices 

12 java. uti 1 . Li st<? extends Displayable> vertices 

13 = graph. getVertices() ; 

14 for (int i = 0; i < graph . getSi ze() ; i++) { 

15 int x = vertices. get(i) .getX() ; 

16 int y = vertices. get(i) .getY() ; 

17 String name = vertices. get(i) .getNameO ; 
18 

19 g.fill0val(x - 8, y - 8, 16, 16); // Display a vertex 

20 g.drawString(name, x - 12, y - 12); // Display the name 

21 } " 
22 

23 // Draw edges for pair of vertices 

24 for (int i = 0; i < graph . getSi ze() ; i++) { 

25 java. uti 1 . Li st<Integer> neighbors = graph. getNeighbors(i) ; 

26 for (int j = 0; j < nei ghbors . si ze() ; j++) { 

27 int v = neighbors. get(j) ; 

28 int xl = graph . getVertex(i ). getX() ; 

29 int yl = graph . getVertex(i ). getY() ; 

30 int x2 = graph . getVertex(v) . getXQ ; 



910 Chapter 27 Graphs and Applications 



31 int y2 = graph . getVertex(v) . getY() ; 

32 

33 g.drawLine(xl, yl, x2 , y2) ; // Draw an edge for (i , v) 

34 } 

35 } 

36 } 

37 } 

To display a graph on a panel, simply create an instance of GraphView by passing the graph 
as an argument in the constructor (line 4). The class for the vertex of the graph must imple- 
ment the Di spl ayabl e interface in order to display the vertices (lines 12-21). For each ver- 
tex index i, invoking graph. getNeighbors(i) returns its adjacency list (line 25). From 
this list, you can find all vertices that are adjacent to i and draw a line to connect i with its 
adjacent vertex (lines 27-33). 

Listing 27.7 gives an example of displaying the graph in Figure 27.1, as shown in Figure 27.9. 



I DisplayUSMap 




Listing 27.7 DisplayUSMap. java 

1 import javax. swing.*; 
2 

3 public class DisplayUSMap extends JApplet { 

4 private City[] vertices = {new Ci ty("Seattl e" , 75, 50), 

5 new City ("San Francisco", 50, 210), 

6 new CityC'Los Angeles", 75, 275), new CityC'Denver" , 275, 175), 

7 new CityC'Kansas City", 400, 245), 

8 new CityC'Chicago", 450, 100), new City ("Boston" , 700, 80), 

9 new CityC'New York", 675, 120), new CityC'Atlanta", 575, 295), 

10 new City ("Miami", 600, 400), new CityC'Dallas", 408, 325), 

11 new City ("Houston", 450, 360) }; 
12 

13 // Edge array for graph in Figure 27.1 

14 private int[][] edges = { 

15 {0, 1}, {0, 3}, {0, 5}, {1, 0}, {1, 2}, {1, 3}, 

16 {2, 1}, {2, 3}, {2, 4}, {2, 10}, 

17 {3, 0}, {3, 1}, {3, 2}, {3, 4}, {3, 5}, 

18 {4, 2}, {4, 3}, {4, 5}, {4, 7}, {4, 8}, {4, 10}, 

19 {5, 0}, {5, 3}, {5, 4}, {5, 6}, {5, 7}, 

20 {6, 5}, {6, 7}, {7, 4}, {7, 5}, {7, 6}, {7, 8}, 
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21 {8, 4}, {8, 7}, {8, 9}, {8, 10}, {8, 11}, 

22 {9, 8}, {9, 11}, {10, 2}, {10, 4}, {10, 8}, {10, 11}, 

23 {11, 8}, {11, 9}, {11, 10} 

24 }; 
25 

26 private Graph<City> graph create a graph 

27 = new UnweightedCraph<City>(edges , vertices); 
28 

29 public DisplayUSMapO { 

30 add(new GraphVi ew(graph)) ; create a Graph View 

31 } 
32 

33 static class City implements Displayable { City class 

34 private int x, y; 

35 private String name; 
36 

37 City(String name, int x, int y) { 

38 this. name = name; 

39 this.x = x; 

40 this.y = y; 

41 } 
42 

43 public int getXO { 

44 return x; 

45 } 
46 

47 public int getY() { 

48 return y; 

49 } 
50 

51 public String getNameO { 

52 return name; 

53 } 

54 } 

55 } main method omitted 



The class City is defined to model the vertices with the coordinates and name (lines 33-54). 
The program creates a graph with the vertices of the City type (line 27). Since City imple- 
ments Di spl ayabl e, a GraphVi ew object can be created for the graph to be displayed in the 
panel (line 30). 

27.6 Graph Traversals 

Graph traversal is the process of visiting each vertex in the graph exactly once. There are two 
popular ways to traverse a graph: depth-first traversal (or depth-first search) and breadth-first depth-first 
traversal (or breadth-first search). Both traversals result in a spanning tree, which can be breadth-first 
modeled using a class, as shown in Figure 27.10. Note that Tree is an inner class defined in 
the AbstractCraph class. AbstractGraph<V> .Tree is different from the Tree interface 
defined in §26.2.5. AbstractGraph .Tree is a specialized class designed for describing the 
parent-child relationship of the nodes, whereas the Tree interface defines common opera- 
tions such as search, insert, and delete in a tree. Since there is no need to perform these oper- 
ations for a spanning tree, AbstractGraph<V> .Tree is not defined as a subtype of Tree. 

The Tree class is defined as an inner class in the AbstractGraph class in lines 214-288 
in Listing 27.3. 

The Tree class has two constructors. The first constructs a tree with a search order and the 
second without a search order. The second constructor will be used in the next chapter for 
finding the minimum spanning tree and shortest path where search order is not important. 
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AbstractGraph<V>.Tree 

-root: int 
-parent: int[] 

-searchOrders : Li st<Integer> 

+Tree(root: int, parent: int[], 
searchOrders: Li st<Integer>) 
+Tree(root: int, parent: int[]) 

+getRoot() : i nt 

+getSearchOrders() : Li st<Integer> 
+getParent(index: int): int 
+getNumberOfVerti cesFound() : int 
+getPath (index: int): List<V> 

+printPath (index: int): void 
+pri ntTree() : void 



Figure 27.1 The Tree class describes the nodes with parent-child relationship. 



The Tree class defines seven methods. The getRootO method returns the root of the 
tree. You can get the order of the vertices searched by invoking the getSearchOrdersO 
method. You can invoke getParent(v) to find the parent of vertex v in the search. Invoking 
getNumberOfVerticesFoiindO returns the number of vertices searched. Invoking 
getPath (index) returns a list of vertices from the specified vertex index to the root. Invok- 
ing printPath(v) displays a path from the root to v. You can display all edges in the tree 
using the printTreeO method. 

Sections 27.7 and 27.8 will introduce depth-first search and breadth-first search, respec- 
tively. Both searches will result in an instance of the Tree class. 

27.7 Depth-First Search (DFS) 

The depth-first search of a graph is like the depth-first search of a tree discussed in §26.2.4, 
"Tree Traversal." In the case of a tree, the search starts from the root. In a graph, the search 
may start from any vertex. 

A depth-first search of a tree first visits the root, then recursively visits the subtrees of the 
root. Similarly, the depth-first search of a graph first visits a vertex, then recursively visits all 
vertices adjacent to that vertex. The difference is that the graph may contain cycles, which 
may lead to an infinite recursion. To avoid this problem, you need to track the vertices that 
have already been visited. 

The search is called depth-first, because it searches "deeper" in the graph as much as possi- 
ble. The search starts from some vertex v. After visiting v, it next visits the first unvisited neigh- 
bor of v. If v has no unvisited neighbor, backtrack to the vertex from which we reached v. 

27.7.1 Depth-First Search Algorithm 

The algorithm for the depth-first search can be described in Listing 27.8. 

Listing 27.8 Depth-First Search Algorithm 



The root of the tree. 

The parents of the vertices. 

The orders for traversing the vertices. 

Constructs a tree with the specified root, parent, and 

searchOrders . 
Constructs a tree with the specified root and parent. 

Returns the root of the tree. 
Returns the order of vertices searched. 
Returns the parent for the specified vertex index. 
Returns the number of vertices searched. 
Returns a list of vertices from the specified vertex index 
to the root. 

Displays a path from the root to the specified vertex. 
Displays tree with the root and all edges. 



visit v 



1 dfs (vertex v) { 

2 visit v; 
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3 for each neighbor w of v 

4 if (w has not been visited) { check a neighbor 

5 dfs(w); recursive search 

6 } 

7 } 

You may use an array named isVisited to denote whether a vertex has been visited. Ini- 
tially, isVisited[i] is false for each vertex i. Once a vertex, say v, is visited, 
isVisited[v] is set to true. 

Consider the graph in Figure 27.1 1(a). Suppose you start the depth-first search from vertex 
0. First visit 0, then any of its neighbors, say 1. Now 1 is visited, as shown in Figure 27.1 1(b). 
Vertex 1 has three neighbors — 0, 2, and 4. Since has already been visited, you will visit 
either 2 or 4. Let us pick 2. Now 2 is visited, as shown in Figure 27.1 1(c). 2 has three neigh- 
bors 0, 1, and 3. Since and 1 have already been visited, pick 3. 3 is now visited, as shown in 
Figure 27.1 1(d). At this point, the vertices have been visited in this order: 

0, 1, 2, 3 

Since all the neighbors of 3 have been visited, backtrack to 2. Since all the vertices of 2 have 
been visited, backtrack to 1. 4 is adjacent to 1, but 4 has not been visited. So, visit 4, as shown 
in Figure 27.1 1(e). Since all the neighbors of 4 have been visited, backtrack to 1. Since all the 
neighbors of 1 have been visited, backtrack to 0. Since all the neighbors of have been vis- 
ited, the search ends. 



10 10 1 




Figure 27.1 1 Depth-first search visits a node and its neighbors recursively. 

Since each edge and each vertex is visited only once, the time complexity of the df s DFS time complexity 
method is 0( | E | + |V|), where | E | denotes the number of edges and | V | the number of 
vertices. 

27.7.2 Implementation of Depth-First Search 

The algorithm is described in Listing 27.8 using recursion. It is natural to use recursion to 
implement it. Alternatively, you can use a stack (see Exercise 27.3). 
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The dfs(int v) method is implemented in lines 152-181 in Listing 27.3. It returns an 
instance of the Tree class with vertex v as the root. The method stores the vertices searched 
in a list searchOrders (line 153), the parent of each vertex in an array parent (line 154), 
and uses the isVi sited array to indicate whether a vertex has been visited (line 159). It 
invokes the helper method dfs(v, parent, searchOrders, isVisited) to perform a 
depth-first search (line 162). 

In the recursive helper method, the search starts from vertex v. v is added to 
searchOrders in line 172 and is marked visited (line 173). For each unvisited neighbor of v, 
the method is recursively invoked to perform a depth-first search. When a vertex i is visited, 
the parent of i is stored in parent [i] (line 177). The method returns when all vertices are 
visited for a connected graph, or in a connected component. 

Listing 27.9 gives a test program that displays a DFS for the graph in Figure 27. 1 starting from 
Chicago. The graphical illustration of the DFS starting from Chicago is shown in Figure 27.12. 
For an interactive GUI program, see Exercise 27. 19. 



Listing 27.9 TestDFS . j ava 



edges 



create a graph 
get DFS 

get search order 



1 public class TestDFS { 

2 public static void main(String[] args) { 

3 String[] vertices = {"Seattle", "San Francisco", "Los Angeles", 

4 "Denver", "Kansas City", "Chicago", "Boston", "New York", 
"Atlanta", "Miami", "Dallas", "Houston"}; 



5 

6 

7 

8 

9 
10 
11 
12 
13 
14 
15 
16 
17 
18 
19 
20 
21 
22 
23 
24 
25 
26 
27 
28 
29 
30 
31 
32 
33 
34 
35 
36 
37 

38 } 



{ 



{0, 


3}, 


{0, 


5}, 








{1, 


2}, 


{1, 


3}, 








{2, 


3}, 


{2, 


4}, 


{2, 


10}, 




{3, 


1}, 


{3, 


2}, 


{3, 


4}, {?>, 


5}, 


{4, 


3}, 


{4, 


5}, 


{4, 


7}, {4, 


8}, {4, 10}, 


{5, 


3}, 


{5, 


4}, 


{5, 


6}, {5, 


7}, 


{6, 


7}, 












{7, 


5}, 


{7, 


6}, 


{7, 


8}, 




{8, 


7}, 


{8, 


9}, 


{8, 


10}, {8, 


11}, 


{9, 


11}, 













int[][] edges 
{0, 1}, 
{1, 0} 
{2, 1} 
{3, 0} 
{4, 2} 
{5, 0} 
{6, 5} 
{7, 4} 
{8, 4} 
{9, 8} 

{10, 2}, {10, 4}, {10, 8}, {10, 11}, 
{11, 8}, {11, 9}, {11, 10} 

}; 

Craph<Stri ng> graph = 

new UnweightedGraph<Stri ng>(edges , vertices); 
AbstractGraph<Stri ng> .Tree dfs = graph. dfs(5) ; // 5 is Chicago 

java. uti 1 . Li st<Integer> searchOrders = dfs.getSearchOrdersO ; 
System . out . pri ntl n (dfs . getNumberOfVerti ces Found () + 

" vertices are searched in this DFS order:"); 
for (int i = 0; i < searchOrders. size() ; i++) 

System. out . pri nt (graph . getVertex(searchOrders . get(i )) + " ") ; 
System . out . pri ntl n () ; 

for (int i = 0; i < searchOrders. size() ; i++) 
if (dfs.getParent(i) != -1) 
System. out. println("parent of " + graph . getVertex(i ) + 
" is " + graph. getVertex(dfs. getParent(i))) ; 
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12 vertices are searched in this DFS order: 

Chicago Seattle San Francisco Los Angeles Denver 

Kansas City New York Boston Atlanta Miami Houston Dallas 

parent of Seattle is Chicago 

parent of San Francisco is Seattle 

parent of Los Angeles is San Francisco 

parent of Denver is Los Angeles 

parent of Kansas City is Denver 

parent of Boston is New York 

parent of New York is Kansas City 

parent of Atlanta is New York 

parent of Miami is Atlanta 

parent of Dallas is Houston 

parent of Houston is Miami 



Seattle 




Miami 



Figure 27.12 DFS search starts from Chicago. 



27.7.3 Applications of the DFS 

The depth-first search can be used to solve many problems, such as the following: 

■ Detecting whether a graph is connected. Search the graph starting from any vertex. If 
the number of vertices searched is the same as the number of vertices in the graph, 
the graph is connected. Otherwise, the graph is not connected. (See Exercise 27.1.) 

■ Detecting whether there is a path between two vertices. (See Exercise 27.5.) 

■ Finding a path between two vertices. (See Exercise 27.5.) 

■ Finding all connected components. A connected component is a maximal con- 
nected subgraph in which every pair of vertices are connected by a path. (See 
Exercise 27.4.) 
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■ Detecting whether there is a cycle in the graph. (See Exercise 27.6.) 

■ Finding a cycle in the graph. (See Exercise 27.7.) 

The first four problems can be easily solved using the df s method in Listing 27.3. To detect 
or find a cycle in the graph, you have to slightly modify the df s method. 



27.8 Breadth-First Search (BFS) 

The breadth-first traversal of a graph is like the breadth-first traversal of a tree discussed in 
§26.2.4, "Tree Traversal." With breadth-first traversal of a tree, the nodes are visited level by 
level. First the root is visited, then all the children of the root, then the grandchildren of the 
root, and so on. Similarly, the breadth-first search of a graph first visits a vertex, then all its 
adjacent vertices, then all the vertices adjacent to those vertices, and so on. To ensure that 
each vertex is visited only once, skip a vertex if it has already been visited. 



create a queue 
enqueue v 



dequeue into u 
u traversed 
check a neighbor w 
is w visited? 
enqueue w 



BFS time complexity 



27.8.1 Breadth-First Search Algorithm 

The algorithm for the breadth-first search starting from vertex v in a graph can be described in 
Listing 27.10. 

Listing 27.10 Breadth-First Search Algorithm 



i 

2 
3 
4 
5 
6 
7 
8 
9 
10 
11 
12 
13 
14 
15 



bfs (vertex v) { 

create an empty queue for storing vertices to be visited; 
add v into the queue; 
mark v visited; 

while the queue is not empty { 

dequeue a vertex, say u, from the queue 
add u into a list of traversed vertices; 
for each neighbor w of u 
if w has not been visited { 
add w into the queue; 
mark w visited; 

} 



} 



} 



Consider the graph in Figure 27.13(a). Suppose you start the breadth-first search from vertex 0. 
First visit 0, then all its visited neighbors, 1 , 2, and 3, as shown in 27.13(b). Vertex 1 has three 
neighbors, 0, 2, and 4. Since and 2 have already been visited, you will now visit just 4, as 
shown in Figure 27.13(c). Vertex 2 has three neighbors, 0, 1, and 3, which are all visited. Vertex 
3 has three neighbors, 0, 2, and 4, which are all visited. Vertex 4 has two neighbors, 1 and 3, 
which are all visited. So, the search ends. 

Since each edge and each vertex is visited only once, the time complexity of the bfs method 
isO(|E| + |V|), where | E | denotes the number of edges and | V | the number of vertices. 



27.8.2 Implementation of Breadth-First Search 

The bfs(int v) method is defined in the Graph interface and implemented in the 
AbstractGraph class (lines 185-210). It returns an instance of the Tree class with vertex v 
as the root. The method stores the vertices searched in a list searchOrders (line 186), the 
parent of each vertex in an array parent (line 187), uses a linked list for a queue (lines 
191-192), and uses the isVisited array to indicate whether a vertex has been visited (line 
193). The search starts from vertex v. v is added to the queue in line 194 and is marked visited 
(line 195). The method now examines each vertex u in the queue (line 198) and adds it to 
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10 10 1 




(a) (b) (c) 



Figure 27.1 3 Breadth-first search visits a node, then its neighbors, then its neighbors' 
neighbors, and so on. 

searchOrders (line 199). The method adds each unvisited neighbor w of u to the queue (line 
202), set its parent to u (line 203), and mark it visited (line 204). 

Listing 27. 1 1 gives a test program that displays a BFS for the graph in Figure 27. 1 starting 
from Chicago. The graphical illustration of the BFS starting from Chicago is shown in Figure 
27.14. For an interactive GUI program, see Exercise 27.19. 

Listing 27.1 1 TestBFS.java 

1 public class TestBFS { 



2 public static void main(String[] args) { 

3 String[] vertices = {"Seattle", "San Francisco", "Los Angeles", vertices 

4 "Denver", "Kansas City", "Chicago", "Boston", "New York", 

5 "Atlanta", "Miami", "Dallas", "Houston"}; 

6 

7 int[][] edges = { edges 

8 {0, 1}, {0, 3}, {0, 5}, 

9 {1, 0}, {1, 2}, {1, 3}, 

10 {2, 1}, {2, 3}, {2, 4}, {2, 10}, 

11 {3, 0}, {3, 1}, {3, 2}, {3, 4}, {3, 5}, 

12 {4, 2}, {4, 3}, {4, 5}, {4, 7}, {4, 8}, {4, 10}, 

13 {5, 0}, {5, 3}, {5, 4}, {5, 6}, {5, 7}, 

14 {6, 5}, {6, 7}, 

15 {7, 4}, {7, 5}, {7, 6}, {7, 8}, 

16 {8, 4}, {8, 7}, {8, 9}, {8, 10}, {8, 11}, 

17 {9, 8}, {9, 11}, 

18 {10, 2}, {10, 4}, {10, 8}, {10, 11}, 

19 {11, 8}, {11, 9}, {11, 10} 

20 }; 
21 

22 Craph<Stri ng> graph = create a graph 

23 new UnweightedCraph<Stri ng>(edges , vertices); create a bfs tree 

24 AbstractGraph<Stri ng> .Tree bfs = graph . bfs(5) ; // 5 is Chicago 
25 

26 java. uti 1 . Li st<Integer> searchOrders = bfs.getSearchOrdersO ; get search order 

27 System . out . pri ntl n (bfs . getNumberOfVerti cesFoundO + 

28 " vertices are searched in this order:"); 

29 for (int i = 0; i < searchOrders . si ze() ; i++) 

30 System. out .pri ntl n (graph . getVertex (searchOrders .get (i ))) ; 
31 

32 for (int i = 0; i < searchOrders . si ze() ; 

33 if (bfs.getParent(i) != -1) 

34 System. out. println("parent of " + graph. getVertex(i) + 

35 " is " + graph . getVertex(bf s . getParent(i ))) ; 

36 } 



37 } 
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12 vertices are searched in this order: 




Chicago Seattle Denver Kansas City Boston New 


York 


San Francisco Los Angeles Atlanta Dallas Miami 


Houston 


parent of Seattle is Chicago 




parent of San Francisco is Seattle 




parent of Los Angeles is Denver 




parent of Denver is Chicago 




parent of Kansas City is Chicago 




parent of Boston is Chicago 




parent of New York is Chicago 




parent of Atlanta is Kansas City 




parent of Miami is Atlanta 




parent of Dallas is Kansas City 




parent of Houston is Atlanta 





Seattle 




Miami 



Figure 27.14 BFS search starts from Chicago. 



The graphical illustration of the BFS starting from Chicago is shown in Figure 27.14. 

27.8.3 Applications of the BFS 

Many of the problems solved by the DFS can also be solved using the BFS. Specifically, the 
BFS can be used to solve the following problems: 

■ Detecting whether a graph is connected. A graph is connected if there is a path 
between any two vertices in the graph. 

■ Detecting whether there is a path between two vertices. 

■ Finding a shortest path between two vertices. You can prove that the path between 
the root and any node in the BFS tree is the shortest path between the root and the 
node. (See Review Question 27.10.) 

■ Finding all connected components. A connected component is a maximal connected 
subgraph in which every pair of vertices are connected by a path. 
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■ Detecting whether there is a cycle in the graph. (See Exercise 27.6.) 

■ Finding a cycle in the graph. (See Exercise 27.7.) 

■ Testing whether a graph is bipartite. A graph is bipartite if the vertices of the graph 
can be divided into two disjoint sets such that no edges exist between vertices in the 
same set. (See Exercise 27.8.) 



27.9 Case Study: The Nine Tail Problem 

The DFS and BFS algorithms have many applications. This section applies the BFS to solve 
the nine tail problem. 

The problem is stated as follows. Nine coins are placed in a three-by-three matrix with 
some face up and some face down. A legal move is to take any coin that is face up and reverse 
it, together with the coins adjacent to it (this does not include coins that are diagonally adja- 
cent). Your task is to find the minimum number of moves that lead to all coins face down. For 
example, you start with the nine coins as shown in Figure 27.15(a). After you flip the second 
coin in the last row, the nine coins are now as shown in Figure 27. 15(b). After you flip the sec- 
ond coin in the first row, the nine coins are all face down, as shown in Figure 27.15(c). 
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H 


T 


T 


T 


H 


H 


H 



(a) 
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T 


T 


T 


T 



(b) 



T T T 



T T T 



(c) 



Figure 27.1 5 The problem is solved when all coins are face down. 

We will write a program that prompts the user to enter an initial state of the nine coins and 
displays the solution, as shown in the following sample run. 





Enter an initial nine coin H's and T's: HHHT 


fTHHH -Enter 


The steps to flip the coins are 




HHH 




TTT 




HHH 




HHH 




THT 




TTT 




TTT 




TTT 




TTT 





Each state of the nine coins represents a node in the graph. For example, the three states in Figure 
27.15 correspond to three nodes in the graph. For convenience, we use a 3 X 3 matrix to repre- 
sent all nodes and use for head and 1 for tail. Since there are nine cells and each cell is either 
or 1, there are a total of 2 9 (512) nodes, labeled 0,1, . . . , and 511, as shown in Figure 27.16. 
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511 



Figure 27.1 6 There are total of 512 nodes, labeled in this order as 0, 1, 2, . . . , 511. 

We assign an edge from node u to v if there is a legal move from v to u. Figure 27.17 
shows the directed edges to node 56. 
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Figure 27.1 7 If node v becomes node u after cells are flipped, assign an edge from u to v. 

The last node in Figure 27.16 represents the state of nine face-down coins. For conve- 
nience, we call this last node the target node. So, the target node is labeled 511. Suppose the 
initial state of the nine tail problem corresponds to the node s. The problem is reduced to find- 
ing a shortest path from node s to the target node, which is equivalent to finding a path from 
node s to the target node in a BFS tree rooted at the target node. 

Now the task is to build a graph that consists of 512 nodes labeled 0, 1, 2, . . . , 511, and 
edges among the nodes. Once the graph is created, obtain a BFS tree rooted at node 511. 
From the BFS tree, you can find the shortest path from the root to any vertex. We will create 
a class named NineTail Model , which contains the method to get the shortest path from the 
target node to any other node. The class UML diagram is shown in Figure 27.18. 




#tree : AbstractCraph<Integer> .Tree 
+NineTail Model O 

+getShortestPath (nodelndex : i nt) : 

Li st<Integer> 
#getEdges() : 

Li st<AbstractCraph . Edge> 

+getNode(i ndex : int): char[] 

+getIndex(node : char[]) : int 

+ getFl i ppedNode(node : char[], 
position: int) : int 

+ flipACel1 (node: char[], row: int, 
column: int) : void 

+pri ntNode(node : char[]): void 



Figure 27.18 The NineTail Model class models the nine tail problem using a graph. 

Visually, a node is represented in a 3 X 3 matrix with letters H and T. In our program, we 
use a single-dimensional array of nine characters to represent a node. For example, the node 
for vertex 1 in Figure 27.16 is represented as {'H', 'H', 'H', 'H', 'H', 'H', 'H', 'H', 
' T ' } in the array. 

The getEdgesO method returns a list of Edge objects. 

The getNode(index) method returns the node for the specified index. For example, 
getNode(O) returns the node that contains nine H's. getNode(511) returns the node that 
contains nine T's. The getlndex(node) method returns the index of the node. 



A tree rooted at node 511. 

Constructs a model for the nine tail problem and obtains the 
tree. 

Returns a path from the specified node to the root. The path 
returned consists of the node labels in a list. 

Returns a list of Edge objects for the graph. 

Returns a node consisting of nine characters of H's and T's. 
Returns the index of the specified node. 

Flips the node at the specified position and returns the index 
of the flipped node. 

Flips the node at the specified row and column. 
Displays the node to the console. 
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Note that the data field tree and methods getEdgesO, get Fl ippedNode (node, 
position), and fl ipACell (node, row, column) are defined protected so that they can 
be accessed from subclasses in the next chapter. 

The getFl ippedNode(char [] node, int position) method flips the node at the 
specified position and its adjacent positions. This method returns the index of the new node. 
For example, for node 56 in Figure 27. 17, flip it at position 0, and you will get node 5 1. If you 
flip node 56 at position 1, you will get node 47. 

The fl ipACell (char [] node, int row, int column) method flips a node at the 
specified row and column. For example, if you flip node 56 at row and column 0, the new 
node is 408. If you flip node 56 at row 2 and column 0, the new node is 30. 

Listing 27.12 shows the source code for NineTailModel.java. 

Listing 27. 1 2 Ni neTai 1 Model . java 

1 import java.util.*; 
2 

3 public class Ni neTai IModel { 



4 public final static int NUMBER OF NODES = 512; 

5 protected AbstractCraph<Integer> .Tree tree; // Define a tree declare a tree 
6 

7 /** Construct a model */ 

8 public Ni neTai 1 Model () { 

9 // Create edges 

10 Li st<AbstractGraph . Edge> edges = getEdgesO; create edges 

11 

12 // Create a graph 

13 Unwei ghtedGraph<Integer> graph = new UnweightedCraph<Integer>( creategraph 

14 edges, NUMBER_0F_N0DES) ; 
15 

16 // Obtain a BSF tree rooted at the target node 

17 tree = graph . bfs(511) ; create tree 

18 } 
19 

20 /** Create all edges for the graph */ 

21 private Li st<AbstractCraph . Edge> getEdgesO { get edges 

22 Li st<AbstractGraph . Edge> edges = 

23 new ArrayLi st<AbstractGraph . Edge>() ; // Store edges 
24 

25 for (int u = 0; u < NUMBER_0F_N0DES ; u++) { 

26 for (int k = 0; k < 9; k++) { 

27 char[] node = getNode(u); // Get the node for vertex u 

28 if (node[k] == 'H') { 

29 int v = getFl i ppedNode(node , k) ; 

30 // Add edge (v, u) for a legal move from node u to node v 

31 edges. add(new AbstractGraph . Edge(v , u)); addanedge 

32 } 

33 } 

34 } 
35 

36 return edges; 

37 } 
38 

39 public static int getFlippedNode(char[] node, int position) { flipcells 

40 int row = position / 3; 

41 int column = position % 3; 
42 

43 f 1 i pACel 1 (node , row, column); 

44 f 1 i pACel 1 (node , row - 1, column); 
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flip a cell 



get index for a node 



get node for an index 



shortest path 



display a node 
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f 1 i pACel 1 (node , row + 1, column) 
f 1 i pACel! (node , row, column - 1) 
f 1 i pACel 1 (node , row, column + 1) 

return getlndex(node) ; 

} 

public static void flipACell (char[] node, int row, int column) { 
if (row >= && row <= 2 && column >= && column <= 2) { 

// Within the boundary 

if (node [row * 3 + column] == 'H') 

node[row * 3 + column] = 'T' ; // Flip from H to T 
el se 

node [row * 3 + column] = 'H' 

} 

} 



// Flip from T to H 



public static int getlndex(char [] node) { 
int result = 0; 

for (int i = 0; i < 9; i++) 
if (node[i] == 'T') 

result = result * 2 + 1; 
else 

result = result * 2 +0; 



For example: 
index: 3 

node: HHHHHHHTT 
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H 


H 


H 


H 


H 


H 


T 


T 



return result; 



} 

public static char[] getNode(int index) { 
char[] result = new char [9]; 

for (int i = 0; i < 9; i++) { 
int digit = index % 2; 
if (digit == 0) 

result[8 - i] = 'H' 
el se 

result[8 - i] = 'T' : 
index = index / 2; 

} 

return result; 

} 

public Li st<Integer> getShortestPath(i nt nodelndex) { 
return tree.getPath(nodelndex) ; 

} 

public static void printl\lode(char[] node) { 
for (int i = 0; i < 9; i++) 
if (i % 3 != 2) 

System. out. pri nt(node [i ] ) ; 
el se 

System. out. pri ntln(node[i]) ; 
System. out. println() ; 



For example: 
node: THHHHHHTT 
index: 259 
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T 
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The constructor (lines 8-18) creates a graph with 512 nodes, and each edge corresponds to 
the move from one node to the other (line 10). From the graph, a BFS tree rooted at the target 
node 511 is obtained (line 17). 

To create edges, the getEdges method (lines 21-37) checks each node u to see if it can be 
flipped to another node v. If so, add (v, u) to the Edge vector (line 31). The 
getFl ippedNode(node, position) method finds a flipped node by flipping an H cell and 
its neighbors in a node (lines 43^7). The fl ipACell (node, row, column) method actu- 
ally flips an H cell and its neighbors in a node (lines 52-60). 

The getlndex(node) method is implemented in the same way as converting a binary 
number to a decimal (lines 62-72). The getNode(index) method returns a node consisting 
of letters H and T's (lines 74-87). 

The getShortestpath(nodelndex) method invokes the getPath(nodelndex) method 
to get the vertices in the shortest path from the specified node to the target node (lines 89-91). 

The printNode(node) method displays a node to the console (lines 93-101). 

Listing 27.13 gives a program that prompts the user to enter an initial node and displays the 
steps to reach the target node. 

Listing 27. 1 3 Ni neTai 1 . j ava 

1 import java.util .Scanner; 

2 

3 public class Ni neTai 1 { 

4 public static void main(String[] args) { 

5 // Prompt the user to enter nine coins H's and T's 

6 System . out . pri nt("Enter an initial nine coin H's and T's: ") ; 

7 Scanner input = new Scanner(System . i n) ; 

8 String s = input. nextLineO ; 

9 char[] initial Node = s . toCharArrayO ; initial node 
10 

11 Ni neTai 1 Model model = new Ni neTai 1 Model () ; create model 

12 java. uti 1 . Li st<Integer> path = 

13 model . getShortestPath(Ni neTai 1 Model . getlndex(initialNode)) ; get shortest path 
14 

15 System. out. println("The steps to flip the coins are ") ; 

16 for (int i =0; i < path.sizeO; i++) 

17 Ni neTai 1 Model . pri ntNode( 

18 NineTailModel .getNode(path.get(i) . i ntVal ue())) ; 

19 } 

20 } 

The program prompts the user to enter an initial node with nine letters, H's and T's, as a string 
in line 8, obtains an array of characters from the string (line 9), creates a model to create a 
graph and get the BFS tree (line 1 1), obtains a shortest path from the initial node to the target 
node (lines 12-13), and displays the nodes in the path (lines 16-18). 

27.10 Case Study: The Knight's Tour Problem 

Graph algorithms are used in everyday life. Delivery companies such as UPS and FedEx use 
graph algorithms to determine the best delivery routes for their drivers. Google uses graph 
algorithms to map the best travel routes. The key to solving a real-world problem using 
graph algorithms is to model the problem into a graph problem. In the preceding section, we 
model the nine tail problem into the problem of finding a shortest path between two vertices 
in a graph. This section introduces a solution of the Knight's Tour problem using graph 
algorithms. 

The Knight's Tour is a well-known classic problem. The objective is to move a knight, 
starting from any square on a chessboard, to every other square once. Note that the knight 



924 Chapter 27 



Graphs and Applications 



makes only L-shaped moves (two spaces in one direction and one space in a perpendicular 
direction). As shown in Figure 27.19(a), the knight can move to eight squares. 



01234567 




(a) (b) 

Figure 27.1 9 (a) A knight makes an L-shaped move, (b) A solution for a knight to traverse 
all squares once. 

There are several approaches to solving this problem. One approach is to reduce it to a 
Hamiltonian path problem for finding a Hamiltonian path in a graph — that is, a path that visits each vertex in 

Hamiltonian cycle the graph exactly once. A Hamiltonian cycle visits each vertex in the graph exactly once and 

returns to the starting vertex. To solve the Knight's Tour problem, create a graph with 64 ver- 
tices representing all the squares in the chessboard. Two vertices are connected if a knight can 
move between them. 

We will write an applet that lets the user specify a starting square and displays a tour, as 
shown in Figure 27.20. 




Figure 27.20 The applet displays a knight's tour. 



A graph model was built for the nine tail problem in the preceding section. In the same 
spirit, we will build a graph model for the Knight's Tour problem. We will create two classes: 
KnightTourApp and KnightTourModel . The KnightTourApp class is responsible for 
user interaction and for displaying the solution, and the KnightTourModel class creates a 
graph for modeling this problem, as shown in Figure 27.21. 

The KnightTourModel class is given in Listing 27.14 to create the vertices and the edges. 
For convenience, the vertices are labeled 0, 1, 2, . . . , 63. A square in the chessboard at row i 
and column j corresponds to the vertex (i * 8 + j). The getEdgesO method (lines 20-70) 
creates all edges and adds them to the edges list. For each node u at square (i , j), check eight 
possible edges from u (lines 28-66), as shown in Figure 27.22. The model builds a graph from 
the edges and nodes (line 11). The method getHamil tonianPath(int v) returns a Hamil- 
tonian path from the specified starting vertex v by applying the getHamil tonianPath 
method on the graph. 
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KnightTourModel 



-edges: java. uti 1 . Li st<Edge> 
-graph: Craph<Integer> 



i-Kni ghtTou rModel () 

i-getHamil torn' an Path () : Li st<Integer> 
-getEdges() : 
ArrayLi st<AbstractCraph . Edge> 



j avax . swi ng . D Appl et 

7 



KnightTourApp 



-pai ntKni ghtTou r : Pai ntKni ghtTou r 
-jbtSearch: j avax. swing.] Button 
-jtfRow: j avax. swi ng.JTextFi eld 
- j tf Col umn : j avax . swi ng . DText Fi eld 
-model: KnightTourModel 



+KnightTourAppQ 



Figure 27.21 

the solution. 



KnightTourModel creates a graph for modeling the problem and KnightTourApp presents a view for 
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Figure 27.22 Each node may be connected with eight other vertices. 



Listing 27.14 KnightTourModel .java 

1 import java.util ; 

2 

3 public class KnightTourModel { 



4 private UnweightedCraph<Integer> graph; // Define a graph edges 
5 

6 public KnightTourModel () { declare a graph 

7 // (u, v) is an edge if a knight can move from u and v 

8 ArrayLi st<AbstractGraph . Edge> edges = getEdgesO; 
9 

10 // Create a graph with 64 vertices labeled to 63 create edges 

11 graph = new Unwei ghtedCraph<Integer>(edges , 64); 

12 } 
13 

14 /** Get a Hamiltonian path starting from vertex v */ 

15 public Li st<Integer> getHamiltonianPath(int v) { 

16 return graph. getHamiltonianPath(v) ; 

17 } 

18 Hamiltonian path 

19 /** Create edges for the graph */ 

20 public static ArrayLi st<AbstractGraph . Edge> getEdgesO { 

21 ArrayLi st<AbstractGraph . Edge> edges 

22 = new ArrayLi st<AbstractGraph . Edge>() ; // Store edges create edges 

23 for (int i = 0; i < 8; i++) 

24 for (int j = 0; j < 8; j++) { 

2 5 int u = i * 8 + j ; // The vertex label vertex label 

26 

27 // Check eight possible edges from u 

28 if (i - 1 >= && j - 2 >= 0) { find an edge 

29 int vl = (i - 1) * 8 + (j - 2) ; 
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30 edges . add(new AbstractGraph . Edge(u , vl)); 

31 } 
32 

33 if (i - 2 >= && j - 1 >= 0) { 

34 int v2 = (i - 2) * 8 + (j - 1) ; 

35 edges . add(new AbstractGraph . Edge(u , v2)); 

36 } 
37 

38 if (i - 2 >= && j + 1 <= 7) { 

39 int v3 = (i - 2) * 8 + (j + 1) ; 

40 edges . add(new AbstractGraph . Edge(u , v3)); 

41 } 
42 

43 if (i - 1 >= && j + 2 <= 7) { 

44 int v4 = (i - 1) * 8 + (j + 2) ; 

45 edges. add(new AbstractGraph. Edge(u, v4)); 

46 } 
47 

48 if (i + 1 <= 7 && j + 2 <= 7) { 

49 int v5 = (i + 1) * 8 + (j + 2); 

50 edges. add(new AbstractGraph. Edge(u, v5)); 

51 } 
52 

53 if (i + 2 <= 7 && j + 1 <= 7) { 

54 int v6 = (i + 2) * 8 + (j + 1); 

55 edges . add(new AbstractGraph . Edge(u , v6)); 

56 } 
57 

58 if (i + 2 <= 7 && j - 1 >= 0) { 

59 int v7 = (i + 2) * 8 + (j - 1); 

60 edges . add(new AbstractGraph . Edge(u , v7)); 

61 } 
62 

63 if (i + 1 <= 7 && j - 2 >= 0) { 

64 int v8 = (i + 1) * 8 + (j - 2); 

65 edges . add(new AbstractGraph . Edge(u , v8)); 

66 } 

67 } 
68 

69 return edges; 



70 } 

71 } 

Now the question is: how can you find a Hamiltonian path in a graph? You can apply the DFS 
approach to search for a subpath that contains unvisited vertices as deep as possible. In the 
DFS, after a vertex is visited, it will never be revisited. In the process of finding a Hamilton- 
ian path, you may have to backtrack to revisit the same vertex in order to search for a new 
path. The algorithm can be described in Listing 27.15. 

Listing 27.15 Hamiltonian Path Algorithm 

1 /** hamiltonianPath(v) is to find a Hamiltonian path for 

2 * all unvisited vertices. */ 

3 boolean hami I tonianPath (vertex v) { 

4 isVisited[v] = true; 
5 

6 if (all vertices are marked visited) 

7 return true; 

8 

9 for each neighbor u of v 



visit v 

all visited? 

check a neighbor 
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10 if (u is not visited && hamiltonianPath(u)) { recursive search 

11 next[v] = u; // u is the next vertex in the path from v 

12 return true; 

13 } 
14 

15 i sVi si ted [v] = false; // Backtrack 

16 return false; // No path starting from v 

17 } 

To find a Hamiltonian path starting from v, the algorithm first visits v and then recursively 
finds a Hamiltonian path for the remaining unvisited vertices starting from a neighbor of v 
(line 10). If so, a Hamiltonian path is found; otherwise, a Hamiltonian path from v does not 
exist (line 16). 

Let T(ri) denote the time for finding a Hamiltonian path in a graph of n vertices and d be the time complexity 
largest degree among all vertices. Clearly, 

T{n) = 0{d X T(n - 1)) = 0{d X d X T(n - 2)) = 0{d n ) 

This is an exponential-time algorithm. Can you develop an algorithm in polynomial time? 
No. It has been proven that the Hamiltonian path problem is NP-complete, meaning that no NP-complete 
polynomial-time algorithm for such problems can be found. However, you can apply some 
heuristic to speed up the search. Intuitively, you should attempt to search the vertices with 
small degrees and leave those vertices with large degrees open, so there will be a better chance 
of success at the end of the search. 

Add the following two methods in the Graph interface. 

/** Return a Hamiltonian path from the specified vertex object 

* Return null if the graph does not contain a Hamiltonian path */ 
public java. uti 1 . Li st<Integer> getHamiltonianPath(V vertex); 

/** Return a Hamiltonian path from the specified vertex label 

* Return null if the graph does not contain a Hamiltonian path */ 
public java. uti 1 . Li st<Integer> getHamiltonianPath(int index); 

Implement these methods in the AbstractCraph class as follows: 

1 /** Return a Hamiltonian path from the specified vertex object 

2 - Return null if the graph does not contain a Hamiltonian path */ 

3 public Li st<Integer> getHamiltonianPath(V vertex) { 

4 return getHamiltonianPath(getIndex(vertex)) ; 

5 } 
6 

7 /** Return a Hamiltonian path from the specified vertex label 

8 * Return null if the graph does not contain a Hamiltonian path */ 

9 public Li st<Integer> getHamiltonianPath(int v) { 

10 // A path starts from v. (i , next[i]) represents an edge in 

11 // the path, i sVi si ted [i ] tracks whether i is currently in the 

12 // path. 

13 int[] next = new int[getSize()] ; 

14 for (int i =0; i < next. length; i++) 

15 next[i] = -1; // Indicate no subpath from i is found yet 
16 

17 boolean[] isVisited = new boolean [getSizeO] ; 
18 

19 // The vertices in the Hamiltonian path are stored in result 

20 Li st<Integer> result = null; 
21 

22 // To speed up search, reorder the adjacency list for each 

23 // vertex so that the vertices in the list are in increasing 
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reorder adjacency list 



recursive search 
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// order of their degrees 

for (int i = 0; i < getSizeO; i++) 

reorderNeigborsBasedOnDegree(nei ghbors . get(i )) ; 

if (getHamiltonianPath(v, next, isVisited)) { 

result = new ArrayLi st<Integer>() ; // Create a list for path 
int vertex = v; // Starting from v 
while (vertex != -1) { 

result. add(vertex) ; // Add vertex to the result list 
vertex = next[vertex] ; // Get the next vertex in the path 

} 

} 

return result; // return null if no Hami 1 toni an path is found 

} 

/** Reorder the adjacency list in increasing order of degrees */ 
private void reorderNei gborsBasedOnDegree(Li st<Integer> list) { 
for (int i = list.sizeO - 1; i >= 1; i--) { 
// Find the maximum in the list[0..i] 
int currentMaxDegree = getDegree(list.get(0)) ; 
int currentMaxIndex = 0; 

for (int j =1; j <= i ; { 

if (currentMaxDegree < getDegree(list.get(j))) { 
currentMaxDegree = getDegree(l i st . get(j)) ; 
currentMaxIndex = j; 

} 

} 

// Swap list[i] with 1 i st [currentMaxIndex] if necessary; 
if (currentMaxIndex != i) { 

int temp = list.get(currentMaxIndex) ; 

list.set(currentMaxIndex, list.get(i)) ; 

list.set(i , temp) ; 

} 

} 

} 

/** Return true if all elements in array isVisited are true */ 
private boolean allVisited(boolean[] isVisited) { 
boolean result = true; 

for (int i =0; i < getSizeO; i++) 
result = result && i sVi si ted [i ] ; 

return result; 

} 

/** Search for a Hami 1 toni an path from v */ 
private boolean getHamiltonianPath(int v, int[] next, 
boolean [] isVisited) { 
isVisited[v] = true; // Mark vertex v visited 

if (allVisited(isVisited)) 

return true; // The path now includes all vertices, thus found 

for (int i = 0; i < nei ghbors . get(v) . si ze() ; i++) { 
int u = neighbors .get(v) .get(i) ; 
if (! isVisited [u] && 
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87 getHamiltonianPath(u , next, i sVi si ted)) { 

88 next[v] = u; // Edge (v, u) is in the path 

89 return true; 

90 } 

91 } 
92 

93 isVisited[v] = false; // Backtrack, v is marked unvisited now 

94 return false; // No Hamiltonian path exists from vertex v 

95 } 

The getHamil tonianPath(V vertex) finds a Hamiltonian path for the specified vertex 
object, and the getHamil tonianPath(int index) finds a Hamiltonian path for the speci- 
fied vertex index, getlndex (vertex) returns the label for the vertex object (line 4). 

To implement the getHamil tonianPath(int v) method, first create an array next, 
which keeps track of the next vertex in the path (line 13). next [v] denotes the next vertex 
in the path after v. Initially, next[i] is set to -1 for all vertices i (line 15). The isVisited 
array keeps track of the vertices that are currently in the path (line 17). Initially, all elements 
in isVisited are false. 

To speed up search, the adjacency list for every vertex is reordered in increasing order of heuristics 
their degrees (line 26). So, the vertices with small degrees will be visited earlier. 

The recursive getHamil tonianPath(v, next, isVisited) method is invoked to find 
a Hamiltonian path starting from v. When a vertex v is visited, i sVi si ted [v] is set to true 
(line 79). If all the vertices are visited, the search returns true (line 82). For each neighbor of 
v, recursively search a Hamiltonian subpath starting from a neighbor of v (line 85). If a subpath 
is found, set u to next[v] and return true (line 89). After all neighbors of v are searched 
without success, backtrack by setting v unvisited (line 93) and return f al se to indicate a path 
or a subpath is not found (line 94). 

The KnightTourApp class is given in Listing 27.16 to create the GUI. An instance of the 
KnightTourModel class is created in line 7. The path of the knight's tour is displayed in an 
instance of PaintKnightTour panel (line 8). The user specifies the row and column of the 
starting square and clicks the Search button to display the path (line 24). 

Listing 27.16 KnightTourApp. java 

1 import java. util .List; 

2 import javax. swi ng . * ; 

3 import java.awt.*; 

4 import java.awt. event.*; 
5 

6 public class KnightTourApp extends JApplet { 

7 private KnightTourModel model = new KnightTourModel () ; 

8 private PaintKnightTour pai ntKni ghtTour = new Pai ntKni ghtTour() ; 

9 private JTextField jtfRow = new JTextFi el d(2) ; 

10 private JTextField jtfColumn = new JTextFi el d (2) ; 

11 private JButton jbtSearch = new JButton("Search") ; 
12 

13 public KnightTourAppO { 

14 J Panel panel = new JPanelO; 

15 panel . add(new J Label ("Specify a starting position, row: ")); 

16 panel .add (jtfRow) ; 

17 panel . add(new J Label ("column: ")); 

18 panel .add(jtfColumn) ; 

19 panel .add(jbtSearch) ; 

20 add(paintKnightTour, BorderLayout . CENTER) ; 

21 add(panel, BorderLayout . SOUTH) ; 
22 

23 jbtSearch. addActi onLi stener(new Acti onLi stenerQ { 



model 
paint panel 



button listener 
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public void actionPerformed(ActionEvent e) { 

int position = Integer. parselnt(jtfRow.getTextO) * 8 + 

Integer . parseInt(jtfCol umn . getTextO) ; 
pai ntKni ghtTou r . di spl ay Path ( 

model . getHami 1 toni anPath (position)) ; 

} 



}); 

} 

/** A panel to paint the chessboard and the knight's tour */ 
private static class Pai ntKnightTour extends JPanel { 
private Li st<Integer> path; // A knight's tour path 

public Pai ntKni ghtTou r() { 

setBorder (Border Factory . create Li neBorder(Color . bl ack , 1)) ; 

} 

public void displayPath(List<Integer> path) { 
this. path = path; 
repai nt() ; 

} 

protected void pai ntComponent(Graphi cs g) { 
super . pai ntComponent(g) ; 

// Display horizontal lines 
for (int i =0; i < 8; i++) 

g.drawLine(0, i * getHeight() / 8, 
getWidthO, i * getHeightfJ / 8); 

// Display vertical lines 
for (int i =0; i < 8; i++) 

g.drawLine(i * getWidthO / 8, 0, 

(int)i * getWidthO / 8, getHei ght()) ; 

if (path == null) return; // No path to be displayed yet 



for (int i = 0; i < path.size() 
int u = path.get(i) ; 
int v = path.get(i + 1); 



l; i++) { 



// Knight moves from u and v. Draw a line to connect u and v 
g.drawLine((u % 8) * getWidthO / 8 + getWidthO / 16, 
(u / 8) * getHeightO / 8 + getHeight() / 16, 
getWidthO / 8 + getWidthO / 16, 



(v % 8) 
(v / 8) 



getHeightO / 8 + getHeightO / 16); 



Key Terms 



adjacency list 897 
adjacent vertices 893 
adjacency matrix 896 
breadth- first search 916 



complete graph 894 
degree 894 
depth-first search 912 
directed graph 893 



Review Questions 93 1 

graph 892 
incident edges 894 
parallel edge 894 
Seven Bridges of Konigsberg 892 
simple graph 894 

Chapter Summary 



1 . A graph is a useful mathematical structure that represents relationships among entities 
in the real world. You learned how to model graphs using classes and interfaces, how 
to represent vertices and edges using arrays and linked lists, and how to implement 
operations for vertices and edges. 

2. Graph traversal is the process of visiting each vertex in the graph exactly once. You 
learned two popular ways for traversing a graph: depth-first search (DFS) and breadth- 
first search (BFS). 

3. DFS and BFS can be used to solve many problems such as detecting whether a graph 
is connected, detecting whether there is a cycle in the graph, and finding a shortest 
path between two vertices. 

Review Questions 



Sections 27.1-27.3 

27. 1 What is the famous Seven Bridges of Konigsberg problem? 

27.2 What is a graph? Explain the following terms: undirected graph, directed graph, 
weighted graph, degree of a vertex, parallel edge, simple graph, and complete 
graph. 

27.3 How do you represent vertices in a graph? How do you represent edges using an 
edge array? How do you represent an edge using an edge object? How do you rep- 
resent edges using an adjacency matrix? How do you represent edges using adja- 
cency lists? 

27.4 Represent the following graph using an edge array, a list of edge objects, an adja- 
cent matrix, and an adjacent list, respectively. 




Sections 27.4-27.7 

27.5 Describe the relationships among Graph, AbstractGraph, and UnweightedGraph. 

27.6 What is the return type from invoking dfs(v) and bfs(v)? 

27.7 What are depth- first search and breadth-first search? 

27.8 Show the DFS and BFS for the graph in Figure 27.1 starting from vertex Atlanta. 



spanning tree 894 
weighted graph 893 
undirected graph 893 
unweighted graph 893 
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27.9 The depth-first search algorithm described in Listing 27.8 uses recursion. Alterna- 
tively you may use a stack to implement it, as shown below. Point out the error in 
this algorithm and give a correct algorithm. 

// Wrong version 
dfs(vertex v) { 

push v into the stack; 

mark v visited; 

while (the stack is not empty) { 

pop a vertex, say u, from the stack 
visit u; 

for each neighbor w of u 
if (w has not been visited) 
push w into the stack; 

} 

} 

27. 1 Prove that the path between the root and any node in the BFS tree is the shortest 
path between the root and the node. 

Section 27.8 

27. 1 I What is returned after invoking getIndex("HTHTTTHHH" . toCharArray ()) in 

Listing 27.12? What is returned after invoking getNode(46) in Listing 27.12? 

Programming Exercises 



Sections 27.6-27.7 

27. 1 * (Testing whether a graph is connected) Write a program that reads a graph from a 
file and determines whether the graph is connected. The first line in the file con- 
tains a number that indicates the number of vertices (n). The vertices are labeled as 
0,1, . . . , n-1. Each subsequent line, with the format u vl v2 . . ., describes 
edges (u, vl), (u, v2), and so on. Figure 27.23 gives the examples of two files for 
their corresponding graphs. 



File 
6 




• 5 



File 
6 




(b) 



Figure 27.23 The vertices and edges of a graph can be stored in a file. 



Your program should prompt the user to enter the name of the file, should read data 
from a file, create an instance g of Unwei ghtedCraph, invoke g . pri ntEdges () 
to display all edges, and invokes dfs() to obtain an instance tree of 
AbstractGraph.Tree. If tree.getNumberOfVerticeFoundO is the same as 



Programming Exercises 933 



the number of vertices in the graph, the graph is connected. Here is a sample run of 
the program: 







Enter a file name: c:\exercise\Exercise27_la.txt ^mer 


The number of vertices is 6 


Vertex 


(0, 1) (0, 2) 


Vertex 1 


(1, 0) (1, 3) 


Vertex 2 


C2, 0) C2, 3) C2, 4) 


Vertex 3 


C3, 1) C3, 2) C3, 4) C3, 5) 


Vertex 4 


C4, 2) C4, 3) C4, 5) 


Vertex 5 


C5, 3) C5, 4) 


The graph is connected 



(Hint: Use new UnweightedGraph(l ist , numberOfVertices) to create a 
graph, where list contains a list of AbstractGraph . Edge objects. Use new 
AbstractCraph . Edge(u , v) to create an edge. Read the first line to get the number 
of vertices. Read each subsequent line into a string s and use s . spl it(" [\\s+] ") 
to extract the vertices from the string and create edges from the vertices.) 

27.2* (Creating a file for a graph) Modify Listing 27.1, TestGraph.java, to create a file 
for representing graphl. The file format is described in Exercise 27.1. Create the 
file from the array defined in lines 8-21 in Listing 27. 1. The number of vertices for 
the graph is 12, which will be stored in the first line of the file. The contents of the 
file should be as follows: 

12 

13 5 
1023 
2 1 34 10 
30 1245 
423 57 8 10 
503467 
657 
745 68 
8479 10 11 
9 8 11 
10248 11 
11 89 10 

(Implementing DFS using a stack) The depth-first search algorithm described in 
Listing 27.8 uses recursion. Implement it without using recursion. 

(Finding connected components) Add a new method in AbstractCraph to find 
all connected components in a graph with the following header: 

public Li st<Integer> getConnectedComponentsO ; 

The method returns a Li st<Integer>. Each element in the list is another list that 
contains all the vertices in a connected component. For example, if the graph has 
three connected components, the method returns a list with three elements, each 
containing the vertices in a connected component. 

27.5* (Finding paths) Add a new method in AbstractGraph to find a path between two 
vertices with the following header: 

public Li st<Integer> getPathCint u, int v) ; 
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The method returns a List<Integer> that contains all the vertices in a path 
from u to v in this order. Using the BFS approach, you can obtain a shortest 
path from u to v. If there is no path from u to v, the method returns nul 1 . 

27.6* (Detecting cycles) Add a new method in AbstractCraph to determine 
whether there is a cycle in the graph with the following header: 

public boolean isCyclicO; 

27.7* (Finding a cycle) Add a new method in AbstractCraph to find a cycle in the 
graph with the following header: 

public Li st<Integer> getACycleO; 

The method returns a Li st that contains all the vertices in a cycle from u to v 
in this order. If the graph has no cycles, the method returns nul 1 . 

27.8** (Testing bipartite) Recall that a graph is bipartite if its vertices can be divided 
into two disjoint sets such that no edges exist between vertices in the same set. 
Add a new method in AbstractCraph to detect whether the graph is bipartite: 

public boolean i sBi parti te() ; 

27.9** (Getting bipartite sets) Add a new method in AbstractCraph to return two 
bipartite sets if the graph is bipartite: 

public Li st<Li st<Integer» getBi parti te() ; 

The method returns a Li st that contains two sublists, each of which contains a 
set of vertices. If the graph is not bipartite, the method returns nul 1 . 

27. 1 0* (Finding a shortest path) Write a program that reads a connected graph from a 
file. The graph is stored in a file using the same format specified in Exercise 
27.1. Your program should prompt the user to enter the name of the file, then 
two vertices, and should display the shortest path between the two vertices. For 
example, for the graph in Figure 27.23(a), a shortest path between and 5 may 
be displayed as 1 3 5. 

Here is a sample run of the program: 



Enter a file name: c:\exercise\Exercise27_la.txt 
Enter two vertices (integer indexes): 
The number of vertices is 6 



Vertex 
Vertex 1 
Vertex 2 
Vertex 3 
Vertex 4 
Vertex 5 



(0, 1) (0, 2) 

(1, 0) (1, 3) 

C2, 0) C2, 3) C2, 4) 

C3, 1) C3, 2) C3, 4) C3, 5) 

C4, 2) C4, 3) C4, 5) 

C5, 3) C5, 4) 



The path is 1 3 5 



27.1 1 ** (Revising Listing 27.12, NineTail.java) The program in Listing 27.12 lets the 
user enter an input for the nine tail program from the console and displays the 
result on the console. Write an applet that lets the user set an initial state of the 
nine coins (see Figure 27.24(a)) and click the Solve button to display the solu- 
tion, as shown in Figure 27.24(b). Initially, the user can click the mouse button 
to flip a coin. 
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(a) (b) 
Figure 27.24 The applet solves the nine tail problem. 

27.12** (Variation of the nine tail problem) In the nine tail problem, when you flip a 
head, the horizontal and vertical neighboring cells are also flipped. Rewrite 
the program, assuming that all neighboring cells including the diagonal 
neighbors are also flipped. 

27.1 3** (4 X 4 16 tail model) The nine tail problem in the text uses a 3 X 3 matrix. 

Assume that you have 16 coins placed in a 4 X 4 matrix. Create a new model 
class named Tail Model 16. Create an instance of the model and save the 
object into a file named Exercise27_13.dat. 

27. 1 4** (4 X 4 16 tail view) Listing 27. 13, NineTail.java, presents a view for the nine 
tail problem. Revise this program for the 4 X 4 16 tail problem. Your pro- 
gram should read the model object created from the preceding exercise. 

27.15** (Dynamic graphs) Add the following methods in the Graph interface to 
dynamically add and remove vertices and edges: 

// Add a vertex to the graph and return true if succeeded 
public boolean add (Object vertex) 

// Remove a vertex from the graph and return true if succeeded 
public boolean remove (Object vertex) 

// Add an edge to the graph and return true if succeeded 
public boolean add (Edge edge) 

// Remove an edge from the graph and return true if succeeded 
public boolean remove (Edge edge) 

For simplicity, assume the vertices are labeled with integers 1, 2, . . . , and so on. 

27. 1 6** (Induced subgraph) Given an undirected graph G = (V, E) and an integer k, 
find an induced subgraph H of G of maximum size such that all vertices of H 
have degree >= k, or conclude that no such induced subgraph exists. Imple- 
ment the method with the following header: 

public static Graph maxInducedSubgraph(Graph edge, int k) 

The method returns nul 1 if such subgraph does not exist. 

(Hint: An intuitive approach is to remove vertices whose degree is less than k. 
As vertices are removed with their adjacent edges, the degrees of other ver- 
tices may be reduced. Continue the process until no vertices can be removed, 
or all the vertices are removed.) 

27.17*** (Hamiltonian cycle) Add the following method in the Graph interface and 
implement it in the AbstractGraph class: 



/** Return a Hamiltonian cycle 

* Return null if the graph contains no Hamiltonian cycle */ 
public Li st<Integer> getHamiltonianCycleO 
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27.18*** (Knight's Tour cycle) Rewrite Listing 27.16, KnightTourApp.java, to find a 
knight's tour that visits each square in a chessboard and returns to the starting 
square. Reduce the Knight's Tour cycle problem to the problem of finding a 
Hamiltonian cycle. 

27. 1 9** (Displaying a DFS/BFS tree in a graph) Modify GraphView in Listing 27.6 
to add a new data field tree with a set method. If a tree is set, the edges in 
the tree are displayed in blue. Write a program that displays the graph in 
Figure 27.1 and the DFS/BFS tree starting from a specified city, as shown in 
Figure 27.25(a). If a city not in the map is entered, the program displays a dia- 
log box to alert the user, as shown in Figure 27.25(b). 



|0 Fx«r[pj07_1*l 



Message 




27.20* (Displaying a graph) Write a program that reads a graph from a file and dis- 
plays it. The first line in the file contains a number that indicates the number 
of vertices (n). The vertices are labeled 0,1, . . . , n-1. Each subsequent line, 
with the format u x y vl v2 . . . , describes the position of u at (x, y) and 
edges (u, vl), (u, v2), and so on. Figure 27.26(a) gives an example of the file 
for their corresponding graph. Your program prompts the user to enter the 
name of the file, reads data from a file, and displays the graph on a panel 
using GraphView, as shown in Figure 27.26(b). 



File 
7 

30 30 1 

1 90 30 



30 90 
90 90 1 
30 150 2 3 5 
90 150 3 4 6 
130 90 1 5 




o i 




(a) 



(b) 



Figure 27.26 The program reads the information about the graph and displays it visually. 
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27.2 I *** (Dynamic graphs) Write a program that lets the user create a graph dynamically. 

The user can create a vertex by entering its index and location, as shown in 
Figure 27.27. The user can also create an edge to connect two vertices. To make 
this program work, add the following two methods in the AbstractGraph 
class. 



I Exercise27_21 




Aihl d new tci lex 
Vertex name: 
H-coorriiiiatc: 
^-coordinate: 



AUlI a new eilge 
Vertex u (index): 
Vertex v (index): 



Add Edge 



FieiU a sliuiiesl ijuLIi 
Starting vertex: 
Ending vertex: 



Shortest Path 



Figure 27.27 The program can add vertices and edges and display a shortest path between 
two specified vertices. 



public void addVertex(V vertex) 
public void addEdge(int u, int v) 

To simplify the program, assume that vertex names are the same as vertex indices. 
You have to add the vertex indices 0,1, . . . , n, in this order. The user may specify 
two vertices and let the program display their shortest path in blue. 
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Chapter 28 



Weighted Graphs 
and Applications 

Objectives 

■ To represent weighted edges using adjacency matrices and priority 
queues (§28.2). 

■ To model weighted graphs using the Wei ghtedGraph 

class that extends the AbstractCraph class (§28.3). 

■ To design and implement the algorithm for finding a 
minimum spanning tree (§28.4). 

■ To define the MST class that extends the Tree class (§28.4). 

■ To design and implement the algorithm for finding 
single-source shortest paths (§28.5). 

■ To define the ShortestPathTree class that extends 
the Tree class (§28.5). 

■ To solve the weighted nine tail problem using the 
shortest-path algorithm (§28.6). 
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28.1 Introduction 

The preceding chapter introduced the concept of graphs. You learned how to represent edges 
using edge arrays, edge lists, adjacency matrices, and adjacency lists, and how to model a 
graph using the Graph interface, the AbstractGraph class, and the UnweightedGraph 
class. The preceding chapter also introduced two important techniques for traversing graphs: 
depth-first search and breadth-first search, and applied traversal to solve practical problems. 
This chapter will introduce weighted graphs. You will learn the algorithm for finding a mini- 
mum spanning tree in §28.4 and the algorithm for finding shortest paths in §28.5. 

28.2 Representing Weighted Graphs 

There are two types of weighted graphs: vertex weighted and edge weighted. In a vertex- 
weighted graph, each vertex is assigned a weight. In an edge-weighted graph, each edge is 
assigned a weight. Of the two types, edge-weighted graphs have more applications. This 
chapter considers edge- weighted graphs. 

Weighted graphs can be represented in the same way as unweighted graphs, except that 
you have to represent the weights on the edges. As with unweighted graphs, the vertices in 
weighted graphs can be stored in an array. This section introduces three representations for 
the edges in weighted graphs. 

28.2.1 Representing Weighted Edges: Edge Array 

Weighted edges can be represented using a two-dimensional array. For example, you can store 
all the edges in the graph in Figure 28.1 using the following array: 









vertex 


weig 


hi 












1 1 


1 








int[][] 


edges 




{{0, 1, 


2}, 


{ , 




8}, 


{1, o, 


2}, 


{1, 


2, 7}, 


{ , 




3}, 




{2, 1, 


7}, 


{2, 


3, 4}, 


{2, 




5}, 




{3, 0, 


8}, 


{3, 


1, 3}, 


{3, 




4}, 


{3, 


{4, 2, 


5}, 


{4, 


3, 6} 











}; 



1 7 2 




3 4 



Figure 28.1 Each edge is assigned a weight on an edge-weighted graph. 
||| Note 

integer weights For simplicity, we assume that the weights are integers. Weights can be of any type. In that case, 

you may use a two-dimensional array of the Object type as follows: 

Object [] [] edges = { 

{new Integer(O), new Integer(l), new SomeTypeForWeight(2)} , 
{new Integer(O), new Integer(3), new SomeTypeForWeight(8)} , 



}; 
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28.2.2 Weighted Adjacency Matrices 

Assume that the graph has n vertices. You can use a two-dimensional n X n matrix, say 
weights, to represent the weights on edges. weights[i] [j] represents the weight on edge 
(i, j). If vertices i and j are not connected, weights[i][j] is null. For example, the 
weights in the graph in Figure 28.1 can be represented using an adjacency matrix as follows: 



Integer[][] adjacencyMatrix = { 







1 


2 


3 


4 


{null, 2, null, 8, null }, 





null 


2 


null 


8 


null 


{2, null, 7, 3, null }, 


1 


2 


null 


7 


3 


null 


{null , 7, null , 4, 5}, 


2 


null 


7 


null 


4 


5 


{8, 3, 4, null, 6}, 


3 


8 


3 


4 


null 


6 


{null, null, 5, 6, null} 


4 


null 


null 


5 


6 


null 



28.2.3 Priority Adjacency Lists 

Another way to represent the edges is to define edges as objects. The AbstractGraph . Edge 
class was defined to represent edges in unweighted graphs. For weighted edges, we define the 
WeightedEdge class as shown in Listing 28.1. 

Listing 28.1 WeightedEdge.java 

1 public class WeightedEdge extends AbstractGraph . Edge 

2 implements Comparabl e<Wei ghtedEdge> { 

3 public int weight; // The weight on edge (u , v) edgeweight 
4 

5 /** Create a weighted edge on (u, v) */ 

6 public WeightedEdge(int u, int v, int weight) { constructor 

7 super (u, v) ; 

8 this. weight = weight; 

9 } 
10 

11 /** Compare two edges on weights */ 

12 public int compareTo(Wei ghtedEdge edge) { compare edges 

13 if (weight > edge. weight) 

14 return 1; 

15 else if (weight == edge. weight) 

16 return 0; 

17 el se 

18 return -1; 

19 } 

20 } 

AbstractGraph. Edge is an inner class defined in the AbstractGraph class. It represents 
an edge from vertex u to v. WeightedEdge extends AbstractGraph . Edge with a new 
property weight. 

To create a WeightedEdge object, use new Wei ghtedEdge (i , j , w), where w is the 
weight on edge (i, j). Often it is desirable to store a vertex's adjacent edges in a priority 
queue so that you can remove the edges in increasing order of their weights. For this reason, 
the Edge class implements the Comparabl e interface. 

For unweighted graphs, we use adjacency lists to represent edges. For weighted graphs, we 
still use adjacency lists, but the lists are priority queues. For example, the adjacency lists for 
the vertices in the graph in Figure 28.1 can be represented as follows: 

java. uti 1 . Pri ori tyQueue<Wei ghtedEdge> [] queues = 
new java.util . Priori tyQueue<Wei ghtedEdge> [5] ; 
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queues [0] 
queuesfl] 
queues [2] 
queues [3] 
queues [4] 



WeightedEdge(0, 1, 2) 



WeightedEdge(l,0, 2) 



WeightedEdge(2, 3, 4) 



WeightedEdge(3, 1, 3) 



WeightedEdge(4, 2, 5) 



Wei| 


;htedEd| 


?e(0, 3, 8) 


WeightedEdge(l, 3, 3) 


Wei| 


;htedEd| 


?e(2, 4, 5) 


Wei| 


;htedEd| 


?e(3, 2, 4) 


Wei| 


;htedEd| 


;e(4, 3, 6) 



WeightedEdge(l, 2, 7) 



WeightedEdge(2, 1, 7) 



WeightedEdge(3, 4, 6) WeightedEdge(3, 0, 8) 



queues [i] stores all edges adjacent to vertex i. 

For flexibility, we will use an array list rather than a fixed-sized array to represent queues. 

28.3 The WeightedGraph Class 

The preceding chapter designed the Graph interface, the AbstractGraph class, and the 
UnweightedGraph class for modeling graphs. Following this pattern, we design 
WeightedGraph as a subclass of AbstractGraph, as shown in Figure 28.2. 



«i nterface» 
Craph<V> 



AbstractCraph<V> 



WeightedGraph<V> 



-queues : 

Li st<java . uti 1 . Priori tyQueue<Wei ghtedEdge» 



+WeightedCraph (edges: int[][], vertices: V[]) 

+Wei ghtedCraph (edges : Li st<Wei ghtedEdge> , 
vertices: List<V>) 

+Wei ghtedCraph (edges : i nt [] [] , 
numberOfVerti ces : int) 

+Wei ghtedCraph (edges : Li st<Wei ghtedEdge> , 
numberOfVerti ces : int) 

+printWeightedEdges() : void 

+getMi nimumSpanni ngTree() : MST 

+getMi nimumSpanni ngTree (index: int): MST 

+getShortestPath(i ndex : int): ShortestPathTree 

+getWeightedEdges() : 

Li st<Priori tyQueue<WeightedEdge» 



queues . get (i ) is a priority queue that contains all the edges 
adjacent to vertex i . 

Constructs a weighted graph with the specified edges and 
the number of vertices in arrays. 

Constructs a weighted graph with the specified edges and 
the number of vertices. 

Constructs a weighted graph with the specified edges in 
an array and the number of vertices. 

Constructs a weighted graph with the specified edges in a 
list and the number of vertices. 

Displays all edges and weights. 

Returns a minimum spanning tree starting from vertex 0. 
Returns a minimum spanning tree starting from vertex v. 
Returns all single-source shortest paths. 
Returns all weighted edges for each vertex in a priority 
queue. 



Figure 28.2 WeightedGraph extends AbstractGraph. 



WeightedGraph simply extends AbstractGraph with four constructors for creating 
concrete WeightedGraph instances. WeightedGraph inherits all methods from 
AbstractGraph and also introduces the new methods for obtaining minimum spanning trees 
and for finding single-source all shortest paths. Minimum spanning trees and shortest paths 
will be introduced in §28.4 and §28.5, respectively. 
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Listing 28.2 implements WeightedGraph. Priority adjacency lists (line 5) are used internally 
to store adjacent edges for a vertex. When a WeightedGraph is constructed, its priority adja- 
cency lists are created (lines 10, 16, 22, and 29). The methods getMinimumSpanningTreeO 
(lines 74-158) and getShortestPathsO (lines 161-241) will be introduced in the upcoming 
sections. 

Listing 28.2 WeightedGraph. java 

1 import java. uti 1 . ; 

2 

3 public class WeightedGraph<V> extends AbstractCraph<V> { 

4 // Priority adjacency lists 

5 private List<PriorityQueue<WeightedEdge» queues; priority queue 
6 

7 /** Construct a WeightedGraph from edges and vertices in arrays */ 

8 public WeightedGraph(int[] [] edges, V[] vertices) { constructor 

9 super (edges, vertices); superclass constructor 

10 createQueues(edges , verti ces . 1 ength) ; create priority queues 

11 } 
12 

13 /** Construct a WeightedGraph from edges and vertices in List */ 

14 public WeightedGraph(int[] [] edges, int numberOfVerti ces) { constructor 

15 super (edges, numberOfVerti ces) ; 

16 createQueues(edges , numberOfVerti ces) ; 

17 } 
18 

19 /** Construct a WeightedGraph from vertices 0, 1, 2 and edge list */ 

20 public WeightedGraph(List<WeightedEdge> edges, List<V> vertices) { constructor 

21 super ((Li st)edges , vertices); 

22 createQueues(edges , vertices. size()) ; 

23 } 
24 

25 /** Construct a WeightedGraph from vertices 0, 1, and edge array */ 

26 public WeightedGraph(List<WeightedEdge> edges, constructor 

27 int numberOfVerti ces) { 

28 super ((Li st)edges , numberOfVerti ces) ; 

29 createQueues(edges , numberOfVerti ces) ; 

30 } 
31 

32 /** Create priority adjacency lists from edge arrays */ 

33 private void createQueues(int[] [] edges, int numberOfVerti ces) { create priority queues 

34 queues = new ArrayList<PriorityQueue<WeightedEdge»() ; 

35 for (int i =0; i < numberOfVerti ces ; i++) { 

36 queues . add(new PriorityQueue<WeightedEdge>()) ; // Create a queue createqueues 

37 } 
38 

39 for (int i =0; i < edges. length; i++) { 

40 int u = edges [i] [0] ; 

41 int v = edges[i][l]; 

42 int weight = edges[i][2]; 

43 // Insert an edge into the queue 

44 queues. get(u) .offer(new Wei ghtedEdge(u , v, weight)); fillqueues 

45 } 

46 } 
47 

48 /** Create priority adjacency lists from edge lists */ 

49 private void createQueues(List<WeightedEdge> edges, 

50 int numberOfVerti ces) { 

51 queues = new ArrayList<PriorityQueue<WeightedEdge»() ; create priority queues 
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create queues 



fill queues 



print edges 



minimum spanning tree 
start from vertex 



minimum spanning tree 
vertices in tree 

add to tree 

number of vertices 
parent array 



initialize parent 
total weight 



a copy of queues 



more vertices? 



every u in tree 



remove visited vertex 



queues. get (u) is empty 



52 
53 
54 
55 
56 
57 
58 
59 
60 
61 
62 
63 
64 
65 
66 
67 
68 
69 
70 
71 
72 
73 
74 
75 
76 
77 
78 
79 
80 
81 
82 
83 
84 
85 
86 
87 
88 
89 
90 
91 
92 
93 
94 
95 
96 
97 
98 
99 
100 
101 
102 
103 
104 
105 
106 
107 
108 
109 
110 
111 



for (int i = 0; i < numberOfVerti ces ; i++) { 

queues . add (new PriorityQueue<WeightedEdge>0) ; // Create a queue 

} 

for (WeightedEdge edge: edges) { 

queues. get(edge. u) .offer(edge) ; // Insert an edge into the queue 

} 



} 



/** Display edges with weights */ 
public void printWeightedEdgesO { 

for (int i = 0; i < queues . si ze() ; i++) { 
System. out. pri nt("Vertex " + i + ": ") ; 
for (WeightedEdge edge 
System. out. print("(" 
", " + edge.v + ", 

} 

System. out. pri ntln() ; 



queues . get(i )) { 
edge.u + 

+ edge. weight + ") ") ; 



} 

} 

/** Get a minimum spanning tree rooted at vertex */ 
public MST getMinimumSpanningTreeO { 
return getMi nimumSpanni ngTree(O) ; 

} 

/** Get a minimum spanning tree rooted at a specified vertex */ 
public MST getMinimumSpanningTree(int starti nglndex) { 

Li st<Integer> T = new ArrayLi st<Integer>() ; 

// T initially contains the starti ngVertex; 

T.add(starti nglndex) ; 

int numberOfVerti ces = verti ces . si ze() ; // Number of vertices 
int[] parent = new int [numberOfVerti ces] ; // Parent of a vertex 
// Initially set the parent of all vertices to -1 
for (int i =0; i < parent. length; i++) 

parent[i] = -1; 
int totalWeight = 0; // Total weight of the tree thus far 

// Clone the queue, so as to keep the original queue intact 
List<PriorityQueue<WeightedEdge» queues = deepClone(this. queues) ; 

// All vertices are found? 

while (T.sizeO < numberOfVerti ces) { 

// Search for the vertex with the smallest edge adjacent to 

// a vertex in T 

int v = -1; 

double small estWeight = Double. MAX_VALUE; 
for (int u : T) { 
while (! queues . get(u) . i sEmptyO && 
T.contains(queues.get(u) .peek() .v)) { 

// Remove the edge from queues . get(u) if the adjacent 
// vertex of u is already in T 
queues. get(u) . remove() ; 

} 

if (queues. get(u) .isEmptyO) { 

continue; // Consider the next vertex in T 

} 
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112 // Current smallest weight on an edge adjacent to u 

113 WeightedEdge edge = queues . get(u) . peek() ; smallest edge to u 

114 if (edge. weight < small estWei ght) { 

115 v = edge.v; 

116 small estWei ght = edge, weight; update small estWei ght 

117 // If v is added to the tree, u will be its parent 

118 parent[v] = u; 

119 } 

120 } // End of for 
121 

122 T.add(v); // Add a new vertex to the tree addtotree 

123 totalWeight += smal 1 estWei ght ; update total Wei ght 

124 } // End of while 
125 

126 return new MST(starti nglndex , parent, T, totalWeight); 

127 } 
128 

129 /** Clone an array of queues */ 

130 private List<PriorityQueue<WeightedEdge» deepClone( clonequeue 

131 List<PriorityQueue<WeightedEdge» queues) { 

132 List<PriorityQueue<WeightedEdge» copiedQueues = 

133 new ArrayLi st<Pri ori tyQueue<Wei ghtedEdge»() ; 
134 

135 for (int i = 0; i < queues . si ze() ; i++) { 

136 copiedQueues. add (new PriorityQueue<WeightedEdge>()) ; 

137 for (WeightedEdge e : queues . get(i )) { 

138 copi edQueues . get(i ) .add(e) ; clone every element 

139 } 

140 } 
141 

142 return copiedQueues; 

143 } 
144 

145 /** MST is an inner class in WeightedGraph */ 

146 public class MST extends Tree { MST inner class 

147 private int totalWeight; // Total weight of all edges in the tree total weight in tree 
148 

149 public MST(int root, int[] parent, Li st<Integer> searchOrder, 

150 int totalWeight) { 

151 super(root, parent, searchOrder); 

152 this. totalWeight = totalWeight; 

153 } 
154 

155 public int getTotalWeight() { 

156 return totalWeight; 

157 } 

158 } 
159 

160 /** Find single-source shortest paths */ 

161 public ShortestPathTree getShortestPath(int sourcelndex) { 

162 // T stores the vertices whose path found so far 

163 Li st<Integer> T = new ArrayLi st<Integer>() ; vertices found 

164 // T initially contains the sourceVertex ; 

165 T.add(sourcelndex) ; addsource 
166 

167 // vertices is defined in AbstractCraph 

168 int numberOfVerti ces = verti ces . si ze() ; number of vertices 
169 

170 // parent[v] stores the previous vertex of v in the path 

171 int[] parent = new int[number0fVertices] ; parentarray 
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parent of root 



costs array 



source cost 



a copy of queues 



more vertices left? 
determine one 



remove visited vertex 



queues . get (u) is empty 
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v now found 
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199 
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201 
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204 
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parent [sourcelndex] = -1; // The parent of source is set to -1 

// costs [v] stores the cost of the path from v to the source 
int[] costs = new int [numberOfVerti ces] ; 
for (int i = 0; i < costs . 1 ength ; i++) { 

costs [i] = Integer. MAX_VALUE; // Initial cost set to infinity 

} 

costs [sourcelndex] = 0; // Cost of source is 
// Get a copy of queues 

List<PriorityQueue<WeightedEdge» queues = deepClone(this. queues) ; 

// Expand verti cesFound 
while (T.sizeO < numberOfVerti ces) { 
int v = -1; // Vertex to be determined 

int small estCost = Integer . MAX_VALUE ; // Set to infinity 
for (int u : T) { 

while (! queues . get(u) . i sEmptyO && 
T.contains(queues.get(u) .peek() .v)) { 

queues .get(u) . remove() ; // Remove the vertex in verti cesFound 

} 

if (queues. get(u) .isEmptyO) { 

// All vertices adjacent to u are in verti cesFound 
continue; 

} 

WeightedEdge e = queues . get(u) . peek() ; 
if (costs[u] + e. weight < smal 1 estCost) { 
v = e . v; 

small estCost = costs [u] + e. weight; 

// If v is added to the tree, u will be its parent 
parent[v] = u; 

} 

} // End of for 

T.add(v); // Add a new vertex to T 
costs [v] = smal 1 estCost ; 
} // End of while 

// Create a ShortestPathTree 

return new ShortestPathTree(sourceIndex, parent, T, costs); 

} 

/** ShortestPathTree is an inner class in Wei ghtedGraph */ 
public class ShortestPathTree extends Tree { 

private int[] costs; // costs[v] is the cost from v to source 

/** Construct a path */ 

public ShortestPathTree(int source, int[] parent, 
Li st<Integer> searchOrder, int[] costs) { 
super (source , parent, searchOrder); 
this. costs = costs; 

} 

/** Return the cost for a path from the root to vertex v */ 
public int getCost(int v) { 
return costs [v] ; 

} 
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232 /** Print paths from all vertices to the source */ 

233 public void pri ntAll Paths () { print all paths 

234 System. out. println("All shortest paths from " + 

235 vertices. get(getRootO) + " are:"); 

236 for (int i = 0; i < costs . 1 ength ; i++) { 

237 printPath(i) ; // Print a path from i to the source 

238 System. out. pri ntln(" (cost: " + costs[i] + ")"); // Path cost 

239 } 

240 } 

241 } 
242 

243 public Li st<Pri ori tyQueue<Wei ghtedEdge» getWeightedEdgesO { returnedges 

244 return queues; 

245 } 



246 } 

When you construct a WeightedGraph, its superclass's constructor is invoked (lines 9, 15, 
21, 28) to initialize the properties vertices and neighbors in AbstractCraph. Addition- 
ally, priority queues are created for instances of WeightedGraph. 

Listing 28.3 gives a test program that creates a graph for the one in Figure 27. 1 and another 
graph for the one in Figure 28.1. 

Listing 28.3 TestWei ghtedC raph . j ava 

1 public class TestWei ghtedGraph { 



2 public static void main(String[] args) { 

3 String[] vertices = {"Seattle", "San Francisco", "Los Angeles", vertices 

4 "Denver", "Kansas City", "Chicago", "Boston", "New York", 

5 "Atlanta", "Miami", "Dallas", "Houston"}; 

6 

7 int[][] edges = { edges 

8 {0, 1, 807}, {0, 3, 1331}, {0, 5, 2097}, 

9 {1, 0, 807}, {1, 2, 381}, {1, 3, 1267}, 

10 {2, 1, 381}, {2, 3, 1015}, {2, 4, 1663}, {2, 10, 1435}, 

11 {3, 0, 1331}, {3, 1, 1267}, {3, 2, 1015}, {3, 4, 599}, 

12 {3, 5, 1003}, 

13 {4, 2, 1663}, {4, 3, 599}, {4, 5, 533}, {4, 7, 1260}, 

14 {4, 8, 864}, {4, 10, 496}, 

15 {5, 0, 2097}, {5, 3, 1003}, {5, 4, 533}, 

16 {5, 6, 983}, {5, 7, 787}, 

17 {6, 5, 983}, {6, 7, 214}, 

18 {7, 4, 1260}, {7, 5, 787}, {7, 6, 214}, {7, 8, 888}, 

19 {8, 4, 864}, {8, 7, 888}, {8, 9, 661}, 

20 {8, 10, 781}, {8, 11, 810}, 

21 {9, 8, 661}, {9, 11, 1187}, 

22 {10, 2, 1435}, {10, 4, 496}, {10, 8, 781}, {10, 11, 239}, 

23 {11, 8, 810}, {11, 9, 1187}, {11, 10, 239} 

24 }; 
25 

26 Wei ghtedGraph<Stri ng> graphl = 

27 new Wei ghtedGraph<Stri ng>(edges , vertices); creategraph 

28 System. out. println("The number of vertices in graphl: " 

29 + graphl. getSizeO) ; 

30 System. out. println("The vertex with index 1 is " 

31 + graphl. getVertex(l)) ; 

32 System. out. println("The index for Miami is " + 

33 graphl. getIndex("Miami ")) ; 

34 System. out. println ("The edges for graphl:"); 

35 graphl. pri ntWei ghtedEdges () ; printedges 
36 
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edges 



37 
38 
39 
40 
41 
42 
43 
44 
45 
46 
47 
48 



edges = new int[][]{ 
{0, 1, 2}, {0, 3, 8}, 
{1, 0, 2}, {1, 2, 7}, {1, 3, 3}, 
{2, 1, 7}, {2, 3, 4}, {2, 4, 5}, 
{3, 0, 8}, {3, 1, 3}, {3, 2, 4}, {3, 4, 6}, 
{4, 2, 5}, {4, 3, 6} 



}; 



create graph 



Wei ghtedGraph<Integer> graph2 = 

new Wei ghtedGraph<Integer> (edges, 5); 



print edges 



System. out. pri ntl n("\nThe edges for graph2:")l 
graph2.printWeightedEdgesQ ; 



} 



49 } 



The number of vertices in graphl: 12 
The vertex with index lis San Francisco 
The index for Miami is 9 
The edges for graphl: 

Vertex 0: (0, 1, 807) (0, 3, 1331) (0, 5, 2097) 

Vertex 1: (1, 2, 381) (1, 0, 807) (1, 3, 1267) 

Vertex 2: (2, 1, 381) (2, 3, 1015) (2, 4, 1663) (2, 10, 1435) 

Vertex 3: (3, 4, 599) (3, 5, 1003) (3, 1, 1267) 

(3, 0, 1331) (3, 2, 1015) 
Vertex 4: (4, 10, 496) (4, 8, 864) (4, 5, 533) (4, 2, 1663) 

(4, 7, 1260) (4, 3, 599) 
Vertex 5: (5, 4, 533) (5, 7, 787) (5, 3, 1003) 

(5, 0, 2097) (5, 6, 983) 
Vertex 6: (6, 7, 214) (6, 5, 983) 

Vertex 7: (7, 6, 214) (7, 8, 888) (7, 5, 787) (7, 4, 1260) 
Vertex 8: (8, 9, 661) (8, 10, 781) (8, 4, 864) 

(8, 7, 888) (8, 11, 810) 
Vertex 9: (9, 8, 661) (9, 11, 1187) 

Vertex 10: (10, 11, 239) (10, 4, 496) (10, 8, 781) (10, 2, 1435) 
Vertex 11: (11, 10, 239) (11, 9, 1187) (11, 8, 810) 

The edges for graph2: 

Vertex 0: (0, 1, 2) (0, 3, 8) 

Vertex 1: (1, 0, 2) (1, 2, 7) (1, 3, 3) 

Vertex 2: (2, 3, 4) (2, 1, 7) (2, 4, 5) 

Vertex 3: (3, 1, 3) (3, 4, 6) (3, 2, 4) (3, 0, 8) 

Vertex 4: (4, 2, 5) (4, 3, 6) 



The program creates graphl for the graph in Figure 27.1 in lines 3-27. The vertices for 
graphl are defined in lines 3-5. The edges for graphl are defined in lines 7-24. The 
edges are represented using a two-dimensional array. For each row i in the array, 
edges [i] [0] and edges [i] [1] indicate that there is an edge from vertex edges [i] [0] 
to vertex edges [i] [1] and the weight for the edge is edges [i] [2]. For example, the 
first row {0, 1, 807} represents the edge from vertex (edges [0] [0]) to vertex 1 
(edges[0] [1]) with weight 807 (edges[0] [2]). The row {0, 5, 2097} represents the 
edge from vertex (edges[2] [0]) to vertex 5 (edges[2] [1]) with weight 2097 
(edges[2] [2]). Line 35 invokes the printWeightedEdgesO method on graphl to 
display all edges in graphl. 

The program creates the edges for graph2 for the graph in Figure 28.1 in lines 37-45. 
Line 47 invokes the printWeightedEdgesO method on graph2 to display all edges in 
graph2. 
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§ Note 

The adjacent edges for each vertex are stored in a priority queue. When you remove an edge from Traversing priority queue 

the queue, the one with the smallest weight is always removed. However, if you traverse the 
edges in the queue, the edges are not necessarily in increasing order of weights. 

28.4 Minimum Spanning Trees 

A graph may have many spanning trees. Suppose that the edges are weighted. A minimum 
spanning tree has the minimum total weights. For example, the trees in Figures 28.3(b), 
28.3(c), 28.3(d) are spanning trees for the graph in Figure 28.3(a). The trees in Figures 28.3(c) 
and 28.3(d) are minimum spanning trees. 




The problem of finding a minimum spanning tree has many applications. Consider a com- 
pany with branches in many cities. The company wants to lease telephone lines to connect 
all branches together. The phone company charges different amounts of money to connect 
different pairs of cities. There are many ways to connect all branches together. The cheapest 
way is to find a spanning tree with the minimum total rates. 

28.4-1 Minimum Spanning Tree Algorithms 

How do you find a minimum spanning tree? There are several well-known algorithms for 

doing so. This section introduces Prim's algorithm. Prim's algorithm starts with a spanning Prim's algorithm 

tree T that contains an arbitrary vertex. The algorithm expands the tree by adding a vertex 

with the smallest edge incident to a vertex already in the tree. The algorithm is described in 

Listing 28.4. 
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Listing 28.4 Prim's Minimum Spanning Tree Algorithm 



add initial vertex 

more vertices? 
find a vertex 

add to tree 



1 

2 

3 

4 

5 

6 

7 

8 

9 
10 
11 } 



mi nimumSpanni ngTreeO { 

Let V denote the set of vertices in the graph; 
Let T be a set for the vertices in the spanning tree; 
Initially, add the starting vertex to T; 

while (size of T < n) { 

find u in T and v in V - T with the smallest weight 

on the edge (u, v) , as shown in Figure 28.4; 
add v to T; 

} 



The algorithm starts by adding the starting vertex into T. It then continuously adds a vertex 
(say v) from V - T into T. v is the vertex that is adjacent to a vertex in T with the smallest 
weight on the edge. For example, there are five edges connecting vertices in T and V - T, as 
shown in Figure 28.4, (u, v) is the one with the smallest weight. 




Figure 28.4 Find a vertex u in T that connects a vertex v in V - T with the smallest weight. 



example Consider the graph in Figure 28.5. The algorithm adds the vertices to T in this order: 

1 . Add vertex to T. 

2. Add vertex 5 to T, since Edge(5 ,0,5) has the smallest weight among all edges incident 
to a vertex in T, as shown in Figure 28.5(a). 

3. Add vertex 1 to T, since Edge(l ,0,6) has the smallest weight among all edges incident 
to a vertex T, as shown in Figure 28.5(b). 

4. Add vertex 6 to T, since Edge (6 ,1,7) has the smallest weight among all edges incident 
to a vertex T, as shown in Figure 28.5(c). 

5. Add vertex 2 to T, since Edge (2 ,6,5) has the smallest weight among all edges incident 
to a vertex T, as shown in Figure 28.5(d). 

6. Add vertex 4 to T, since Edge (4 ,6,7) has the smallest weight among all edges incident 
to a vertex T, as shown in Figure 28.5(e). 

7. Add vertex 3 to T, since Edge(3 ,2,8) has the smallest weight among all edges incident 
to a vertex T, as shown in Figure 28.5(f). 



||| Note 

unique tree? A minimum spanning tree is not unique. For example, both (c) and (d) in Figure 28.5 are mini- 

mum spanning trees for the graph in Figure 28.5(a). However, if the weights are distinct, the 
graph has a unique minimum spanning tree. 
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|g| Note 

Assume that the graph is connected and undirected. If a graph is not connected or directed, the connected and undirected 

algorithm will not work. You may modify the algorithm to find a spanning forest for any undi- 
rected graph. 



28.4-2 Implementation of the MST Algorithm 

The getMinimumSpanningTree(int v) method is defined in the Wei ghtedGraph class. getMinimumSpanning- 

It returns an instance of the MST class, as shown in Figure 28.2. The MST class is defined as TreeO 
an inner class in the Wei ghtedGraph class, which extends the Tree class, as shown in 
Figure 28.6. The Tree class was shown in Figure 27.10. The MST class was implemented in 
lines 146-158 in Listing 28.2. 
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AbstractCraph .Tree 



WeightedGraph.MST 

-totalWeight: int Total weight of the tree. 

+MST(root: int, parent: int[], searchOrder: Constructs an MST with the specified root, parent array, 

List<Integer> totalWeight: int) searchOrder , and total weight for the tree. 

+getTotalWei ght() : int Returns the totalWeight of the tree. 



Figure 28.6 The MST class extends the Tree class. 



The getMinimumSpanningTree method was implemented in lines 79-127 in Listing 
28.2. The getMinimumSpanningTree(int startingVertex) method first adds 
startingVertex to T (line 82). T is a list that stores the vertices added into the spanning 
tree (line 80). vertices is defined as a protected data field in the AbstractCraph class, 
which is an array that stores all vertices in the graph, vertices . size() returns the number 
of the vertices in the graph (line 84). 

A vertex is added to T if it is adjacent to one of the vertices in T with the smallest weight 
(line 122). Such a vertex is found using the following procedure: 

1. For each vertex u in T, find its neighbor with the smallest weight to u. All the neighbors 
of u are stored in queues. get(u). queues. get(u) .peek() (line 102) returns the 
adjacent edge with the smallest weight. If a neighbor is already in T, remove it (line 105). 
To keep the original queues intact, a copy is created in line 92. After lines 101-110, 
queues. get (u) .peek() (line 113) returns the vertex with the smallest weight to u. 

2. Compare all these neighbors and find the one with the smallest weight (lines 114-119). 
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Figure 28.7 The animation tool enables you to create a graph dynamically and displays 
its MST. 
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After a new vertex is added to T (line 122), total Weight is updated (line 123). Once all ver- 
tices are added to T, an instance of MST is created (line 126). Note that the method will not 
work if the graph is not connected. However, you can modify it to obtain a partial MST. 

The MST class extends the Tree class (line 146). To create an instance of MST, pass root, 
parent, T, and total Weight (lines 126). The data fields root, parent, and searchOrder 
are defined in the Tree class, which is an inner class defined in AbstractCraph. 

For each vertex, the program constructs a priority queue for its adjacent edges. It takes 
0(log| V | ) time to insert an edge into a priority queue and the same time to remove an edge 
from the priority queue. So the overall time complexity for the program is 0( | £" | log | V I ), 
where \E\ denotes the number of edges and |v| the number of vertices. time complexity 

Ijjl Pedagogical Note 

Follow the link www.cs.armstrong.edu/liang/animation/MSTflnimation.htm] to see how to create a 

weighted graph dynamically and display its MST, as shown in Figure 28.7. MST animation 

Listing 28.5 gives a test program that displays minimum spanning trees for the graph in 
Figure 27.1 and the graph in Figure 28.1, respectively. 

Listing 28.5 TestMi ni mumSpanni ngTree . j ava 

1 public class TestMi ni mumSpanni ngTree { 



2 public static void main(String[] args) { 

3 String[] vertices = {"Seattle", "San Francisco", "Los Angeles", create vertices 

4 "Denver", "Kansas City", "Chicago", "Boston", "New York", 

5 "Atlanta", "Miami", "Dallas", "Houston"}; 

6 

7 int[][] edges = { createedges 

8 {0, 1, 807}, {0, 3, 1331}, {0, 5, 2097}, 

9 {1, 0, 807}, {1, 2, 381}, {1, 3, 1267}, 

10 {2, 1, 381}, {2, 3, 1015}, {2, 4, 1663}, {2, 10, 1435}, 

11 {3, 0, 1331}, {3, 1, 1267}, {3, 2, 1015}, {3, 4, 599}, 

12 {3, 5, 1003}, 

13 {4, 2, 1663}, {4, 3, 599}, {4, 5, 533}, {4, 7, 1260}, 

14 {4, 8, 864}, {4, 10, 496}, 

15 {5, 0, 2097}, {5, 3, 1003}, {5, 4, 533}, 

16 {5, 6, 983}, {5, 7, 787}, 

17 {6, 5, 983}, {6, 7, 214}, 

18 {7, 4, 1260}, {7, 5, 787}, {7, 6, 214}, {7, 8, 888}, 

19 {8, 4, 864}, {8, 7, 888}, {8, 9, 661}, 

20 {8, 10, 781}, {8, 11, 810}, 

21 {9, 8, 661}, {9, 11, 1187}, 

22 {10, 2, 1435}, {10, 4, 496}, {10, 8, 781}, {10, 11, 239}, 

23 {11, 8, 810}, {11, 9, 1187}, {11, 10, 239} 

24 }; 
25 

26 Wei ghtedGraph<Stri ng> graphl = 

27 new Wei ghtedGraph<Stri ng>(edges , vertices); create graphl 

28 Wei ghtedGraph<Stri ng> . MST treel = graphl. getMi nimumSpanni ngTreeO ; MST for graphl 

29 System, out. println ("Total weight is " + treel. getTotalWei ght() ) ; total weight 

30 treel. pri ntTree () ; print tree 
31 

32 edges = new int[][]{ createedges 

33 {0, 1, 2}, {0, 3, 8}, 

34 {1, 0, 2}, {1, 2, 7}, {1, 3, 3}, 

35 {2, 1, 7}, {2, 3, 4}, {2, 4, 5}, 

36 {3, 0, 8}, {3, 1, 3}, {3, 2, 4}, {3, 4, 6}, 

37 {4, 2, 5}, {4, 3, 6} 

38 }; 



954 Chapter 28 Weighted Graphs and Applications 



create graph2 

MST for graph2 

total weight 
print tree 



39 
40 
41 
42 
43 
44 
45 
46 
47 



Wei ghtedGraph<Integer> graph2 = 
new Wei ghtedGraph<Integer> (edges , 

Wei ghtedGraph<Integer> . MST tree2 = 
graph2 . getMi nimumSpanni ngTree(l) ; 

System. out. println ("Total weight is 

tree2 . pri ntTreeQ ; 



) 



+ tree2 . getTotalWei ght () ) ; 



Total weight is 6513 
Root is: Seattle 

Edges: (Seattle, San Francisco) (San Francisco, Los Angeles) 

(Los Angeles, Denver) (Denver, Kansas City) (Kansas City, Chicago) 
(New York, Boston) (Chicago, New York) (Dallas, Atlanta) 
(Atlanta, Miami) (Kansas City, Dallas) (Dallas, Houston) 

Total weight is 14 
Root is: 1 

Edges: (1, 0) (3, 2) (1, 3) (2, 4) 



Seattle 



The program creates a weighted graph for Figure 27.1 in line 27. It then invokes 
getMi nimumSpanni ngTree() (line 28) to return an MST that represents a minimum span- 
ning tree for the graph. Invoking pri ntTreeO (line 30) on the MST object displays the edges 
in the tree. Note that MST is a subclass of Tree. The printTreeO method is defined in the 
Tree class. 
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Figure 28.8 The edges in the minimum spanning tree for the cities are highlighted. 
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The graphical illustration of the minimum spanning tree is shown in Figure 28.8. The ver- graphical illustration 
tices are added to the tree in this order: Seattle, San Francisco, Los Angeles, Denver, Kansas 
City, Dallas, Houston, Chicago, New York, Boston, Atlanta, and Miami. 



28.5 Finding Shortest Paths 



Section 27. 1 introduced the problem of finding the shortest distance between two cities for the 
graph in Figure 27.1. The answer to this problem is to find a shortest path between two ver- 
tices in the graph. 



28.5.1 Shortest-Path Algorithms 

Given a graph with nonnegative weights on the edges, a well-known algorithm for finding a 
single-source shortest path was discovered by Edsger Dijkstra, a Dutch computer scientist. 
Dijkstra's algorithm uses costs [v] to store the cost of the shortest path from vertex v to the 
source vertex s. So costs [s] is 0. Initially assign infinity to costs [v] to indicate that no 
path is found from v to s. Let V denote all vertices in the graph and T denote the set of the ver- 
tices whose costs have been found so far. Initially, the source vertex s is in T. The algorithm 
repeatedly finds a vertex u in T and a vertex v in V - T such that costs [u] + w(u , v) is the 
smallest, and moves v to T. Here w(u , v) denotes the weight on edge (u, v). 
The algorithm is described in Listing 28.6. 

Listing 28.6 Dijkstra's Single-Source Shortest-Path 
Al gori thm 

1 shortestPath(s) { 

2 Let V denote the set of vertices in the graph; 
Let T be a set that contains the vertices whose 

paths to s have been found; 
Initially T contains source vertex s with costs[s] = 0; 



3 

4 

5 

6 

7 

8 

9 
10 
11 

12 } 



while (size of T < n) { 

find v in V - T with the smallest costs [u] + w(u, v) value 

among all u in T; 
add v to T and costs [v] = costs [u] + w(u, v) ; 

} 



add initial vertex 

more vertex 
find next vertex 

add a vertex 



This algorithm is very similar to Prim's for finding a minimum spanning tree. Both algorithms 
divide the vertices into two sets T and V - T. In the case of Prim's algorithm, set T contains the 
vertices that are already added to the tree. In the case of Dijkstra's, set T contains the vertices 
whose shortest paths to the source have been found. Both algorithms repeatedly find a vertex 
from V - T and add it to T. In the case of Prim's algorithm, the vertex is adjacent to some ver- 
tex in the set with the minimum weight on the edge. In the case of Dijkstra's, the vertex is 
adjacent to some vertex in the set with the minimum total cost to the source. 

The algorithm starts by adding the source vertex s into T and sets costs [s] to (line 5) 
It then continuously adds a vertex (say v) from V - T into T. v is the vertex that is adjacent to 
a vertex in T with the smallest costs [u] + w(u , v) . For example, there are five edges con- 
necting vertices in T and V - T, as shown in Figure 28.9; (u , v) is the one with the small- 
est costs [u] + w(u, v). After v is added to T, set costs [v] to costs [u] + w(u, v) 
(line 10). 

Let us illustrate Dijkstra's algorithm using the graph in Figure 28.10(a). Suppose the 
source vertex is 1. So, costs [1] is and the costs for all other vertices are initially oo, as 
shown in Figure 28.10(b). We use the parent [i] to denote the parent of i in the path. For 
convenience, set the parent of the source node to - 1. 
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T contains vertices whose 

shortest path to s have been V- T contains vertices whose shortest 



found 




Figure 28.9 Find a vertex u in T that connects a vertex v in V - T with the smallest 
costs[u] + w(u, v). 
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(a) (b) 
Figure 28.10 The algorithm will find all shortest paths from source vertex 1. 



Initially set T contains the source vertex. Vertices 2, 0, 6, and 3 are adjacent to the vertices 
in T, and vertex 2 has the path of smallest cost to source vertex 1. So add 2 to T. costs [2] 
now becomes 5, as shown in Figure 28.11. 




Now T contains {1, 2}. Vertices 0, 6, and 3 are adjacent to the vertices in T, and vertex 
has a path of smallest cost to source vertex 1. So add 1 to T. costs [0] now becomes 6, as 
shown in Figure 28.12. 
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Figure 28.12 Now vertices { 1, 2, 0} are in the set T. 
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(b) 



Now T contains { 1, 2, 0}. Vertices 3, 6, and 5 are adjacent to the vertices in T, and vertex 
6 has the path of smallest cost to source vertex 1. So add 6 to T. costs [6] now becomes 9, 
as shown in Figure 28.13. 




(a) 

Figure 28.13 Now vertices {1, 2, 0, 6} are in the set T. 



(b) 
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Now T contains {1, 2, 0, 6}. Vertices 3 and 5 are adjacent to the vertices in T, and both 
vertices have a path of the same smallest cost to source vertex 1. You can choose either 3 or 5. 
Let us add 3 to T. costs [3] now becomes 10, as shown in Figure 28.14. 
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Now T contains { 1, 2, 0, 6, 3}. Vertices 4 and 5 are adjacent to the vertices in T, and ver- 
tex 5 has the path of smallest cost to source vertex 1. So add 5 to T. costs [5] now becomes 
10, as shown in Figure 28.15. 




(a) 

Figure 28.15 Now vertices {1, 2, 0, 6, 3, 5} are in the set T. 



(b) 
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Now T contains {1, 2, 0, 6, 3, 5}. The smallest cost for a path to connect 4 with 1 is 15, as 
shown in Figure 28.16. 
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Figure 28.16 Now vertices {1, 2, 6, 0, 3, 5, 4} are in setT. 
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28.5.2 Implementation of the Shortest-Paths Algorithm 

As you see, the algorithm essentially finds all shortest paths from a source vertex, which pro- 
duces a tree rooted at the source vertex. We call this tree a single-source all-shortest-path tree 
(or simply a shortest-path tree). To model this tree, define a class named ShortestPathTree 
that extends the Tree class, as shown in Figure 28.17. ShortestPathTree is defined as an 
inner class in WeightedGraph in lines 217-241 in Listing 28.2. 

The getShortestPath(int sourceVertex) method was implemented in lines 
161-214 in Listing 28.2. The method first adds sourceVertex to T (line 165). T is a list that 
stores the vertices whose path has been found (line 163). vertices is defined as a protected 
data field in the AbstractGraph class, which is an array that stores all vertices in the graph, 
vertices . size() returns the number of the vertices in the graph (line 168). 

Each vertex is assigned a cost. The cost of the source vertex is (line 179). The cost of all 
other vertices is initially assigned infinity (line 177). 

The method needs to remove the elements from the queues in order to find the one with the 
smallest total cost. To keep the original queues intact, queues are cloned in line 182. 
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AbstractCraph .Tree 



T 7 



WeightedGraph.ShortestPathTree 



-costs: int[] 



+ShortestPathTree(source : int, parent: int[], 
searchOrder: List<Integer>, costs: int[]) 

+getCost(v: int): int 

+pri ntAl 1 PathsQ : void 



costs [v] stores the cost for the path from the source to v. 

Constructs a shortest path tree with the specified source, 
parent array, and costs array. 

Returns the cost for the path from the source to vertex v. 

Displays all paths from the source. 



Figure 28.17 WeightedGraph.ShortestPathTree extends AbstractGraph.Tree. 



A vertex is added to T if it is adjacent to one of the vertices in T with the smallest cost 
(line 208). Such a vertex is found using the following procedure: 

1. For each vertex u in T, find its incident edge e with the smallest weight to u. All the 
incident edges to u are stored in queues. get(u). queues . get (u) . peek() (line 
190) returns the incident edge with the smallest weight. If e . v is already in T, remove e 
from queues. get(u) (line 194). After lines 189-197, queues. get (u) .peek() 
returns the edge e such that e has the smallest weight to u and e . v is not in T (line 199). 

2. Compare all these edges and find the one with the smallest value on costs [u] + 
e.getWeightO (line 202). 

After a new vertex is added to T (line 208), the cost of this vertex is updated (line 209). Once 
all vertices are added to T, an instance of ShortestPathTree is created (line 213). Note that 
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Shortest Path Animation by Y. Daniel Liang 




STarfimg City: Seattle | Ending Cliy: Mi ami | Display Snonesi PaiJi 



Figure 28.18 The animation tool enables you to create a graph dynamically and displays 
its MST. 
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the method will not work if the graph is not connected. However, you can modify it to obtain 
the shortest paths to all connected vertices. 
ShortestPathTree class The ShortestPathTree class extends the Tree class (line 217). To create an instance 

of ShortestPathTree, pass sourceVertex, parent, T, and costs (lines 213). 
sourceVertex becomes the root in the tree. The data fields root, parent, and 
searchOrder are defined in the Tree class, which is an inner class defined in 
AbstractGraph. 

Dijkstra's algorithm time Dijkstra's algorithm is implemented essentially in the same way as Prim's. So, the time 

complexity complexity for Dijkstra's algorithm is 0( \E\ log | V\ ), where | E | denotes the number of edges 

and | V| the number of vertices. 



|Bt Pedagogical Note 

Follow the link www.cs.armstrong.edu/liang/animation/ShortestPathflnimation.html to see how to find a 
Shortest-path animation shortest path between any two cities, as shown in Figure 28.18. 

Listing 28.7 gives a test program that displays all shortest paths from Chicago to all 
other cities in Figure 27.1 and all shortest paths from vertex 3 to all vertices for the graph in 
Figure 28.1, respectively. 



Listing 28.7 TestShortestPath . java 

1 public class TestShortestPath { 



2 public static void main(String[] args) { 

vertices 3 String[] vertices = {"Seattle", "San Francisco", "Los Angeles", 

4 "Denver", "Kansas City", "Chicago", "Boston", "New York", 

5 "Atlanta", "Miami", "Dallas", "Houston"}; 

6 

edges 7 int[][] edges = { 

8 {0, 1, 807}, {0, 3, 1331}, {0, 5, 2097}, 

9 {1, 0, 807}, {1, 2, 381}, {1, 3, 1267}, 

10 {2, 1, 381}, {2, 3, 1015}, {2, 4, 1663}, {2, 10, 1435}, 

11 {3, 0, 1331}, {3, 1, 1267}, {3, 2, 1015}, {3, 4, 599}, 

12 {3, 5, 1003}, 

13 {4, 2, 1663}, {4, 3, 599}, {4, 5, 533}, {4, 7, 1260}, 

14 {4, 8, 864}, {4, 10, 496}, 

15 {5, 0, 2097}, {5, 3, 1003}, {5, 4, 533}, 

16 {5, 6, 983}, {5, 7, 787}, 

17 {6, 5, 983}, {6, 7, 214}, 

18 {7, 4, 1260}, {7, 5, 787}, {7, 6, 214}, {7, 8, 888}, 

19 {8, 4, 864}, {8, 7, 888}, {8, 9, 661}, 

20 {8, 10, 781}, {8, 11, 810}, 

21 {9, 8, 661}, {9, 11, 1187}, 

22 {10, 2, 1435}, {10, 4, 496}, {10, 8, 781}, {10, 11, 239}, 

23 {11, 8, 810}, {11, 9, 1187}, {11, 10, 239} 

24 }; 
25 

26 Wei ghtedGraph<Stri ng> graphl = 

creategraphl 27 new Wei ghtedGraph<Stri ng>(edges , vertices); 

28 Wei ghtedGraph<Stri ng> . ShortestPathTree treel = 

shortestpath 29 graphl . getShortestPath (5) ; 

30 treel. pri ntAll PathsO ; 

31 

32 // Display shortest paths from Houston to Chicago 

33 System . out . pri nt("Shortest path from Houston to Chicago: ") ; 

34 java.util . Li st<Stri ng> path = treel. getPath(ll) ; 

35 for (String s: path) { 

36 System. out . pri nt(s + " ") ; 

37 } 
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38 

39 edges = new int [][]{ create edges 

40 {0, 1, 2}, {0, 3, 8}, 

41 {1, 0, 2}, {1, 2, 7}, {1, 3, 3}, 

42 {2, 1, 7}, {2, 3, 4}, {2, 4, 5}, 

43 {3, 0, 8}, {3, 1, 3}, {3, 2, 4}, {3, 4, 6}, 

44 {4, 2, 5}, {4, 3, 6} 

45 }; 

46 Wei ghtedGraph<Integer> graph2 = 

47 new Wei ghtedGraph<Integer> (edges, 5); creategraph2 

48 Wei ghtedGraph<Integer> . ShortestPathTree tree2 = 

49 graph2 .getShortestPath(3) ; 

50 tree2 . pri ntAl 1 Paths () ; print paths 

51 } 

52 } 



All shortest pat 
A path from Chic 
A path from Chic 

Chicago Denver 
A path from Chic 

Chicago Denver 
A path from Chic 
A path from Chic 
A path from Chic 
A path from Chic 
A path from Chic 
A path from Chic 

Chicago Kansas 
A path from Chic 

Chicago Kansas 
A path from Chic 

Chicago Kansas 
A path from Chic 

Chicago Kansas 



hs from Chicago are: 

ago to Seattle: Chicago Seattle (cost: 2097) 
ago to San Francisco: 

San Francisco (cost: 2270) 
ago to Los Angeles: 

Los Angeles (cost: 2018) 
ago to Denver: Chicago Denver (cost: 1003) 
ago to Kansas City: Chicago Kansas City (cost: 533) 
ago to Chicago: Chicago (cost: 0) 
ago to Boston: Chicago Boston (cost: 983) 
ago to New York: Chicago New York (cost: 787) 
ago to Atlanta: 

City Atlanta (cost: 1397) 
ago to Mi ami : 

City Atlanta Miami (cost: 2058) 
ago to Dallas: 

City Dallas (cost: 1029) 
ago to Houston: 

City Dallas Houston (cost: 1268) 



Shortest path from Chicago to Houston: 
Chicago Kansas City Dallas Houston 



All shortest paths from 3 are: 



path from 
path from 
path from 
path from 
path from 



to 



3 10 (cost: 5) 

3 1 (cost: 3) 

3 2 (cost: 4) 

3 (cost: 0) 

3 4 (cost: 6) 



The program creates a weighted graph for Figure 27.1 in line 27. It then invokes the 
getShortestPath(5) method to return a Path object that contains all shortest paths from 
vertex 5 (i.e., Chicago). Invoking printPathO on the ShortestPathTree object displays 
all the paths. 

The graphical illustration of all shortest paths from Chicago is shown in Figure 28.19. 
The shortest paths from Chicago to the cities are found in this order: Kansas City, New 
York, Boston, Denver, Dallas, Houston, Atlanta, Los Angeles, Miami, Seattle, 
and San Francisco. 
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Seattle go] 



807 



San Francisco 




Los Angeles 



Houston 



Miami 



Figure 28.1 9 The shortest paths from Chicago to all other cities are highlighted. 



28.6 Case Study: The Weighted Nine Tail Problem 

Section 27.9 presented the nine tail problem and solved it using the BFS algorithm. This sec- 
tion presents a variation of the problem and solves it using the shortest-path algorithm. 

The nine tail problem is to find the minimum number of the moves that lead to all coins 
face down. Each move flips a head coin and its neighbors. The weighted nine tail problem 
assigns the number of flips as a weight on each move. For example, you can move from the 
coins in Figure 28.20(a) to those in Figure 28.20(b) by flipping the first coin in the first row 
and its two neighbors. So the weight for this move is 3. 



H 


H 


H 


T 


T 


T 


H 


H 


H 



T 


T 


H 


H 


T 


T 


H 


H 


H 



(a) (b) 
Figure 28.20 The weight for each move is the number of flips for the move. 



The weighted nine tail problem is to find the minimum number of flips that lead to all 
coins face down. The problem can be reduced to finding the shortest path from a starting node 
to the target node in an edge- weighted graph. The graph has 512 nodes. Create an edge from 
node v to u if there is a move from node u to node v. Assign the number of flips to be the 
weight of the edge. 

Recall that in §27.9 we defined a class NineTail Model for modeling the nine tail prob- 
lem. We now define a new class named Wei ghtedNineTail Model that extends 
NineTail Model, as shown in Figure 28.21. 
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NineTailModel 



#tree : AbstractGraph<Integer>.Tree 



+Ni neTai 1 Model () 

+getShortestPath(nodeIndex: int) : 

Li st<Integer> 
-getEdges() : 

Li st<AbstractGraph . Edge> 

+getNode(i ndex : int): char[] 

+getIndex(node : char[]): int 

+getFl i ppedNode(node : char[], 
position: int): int 

+fl i pACell (node : char[], row: int, 
col umn : i nt) : voi d 

+pri ntNode(node : char[]): void 



WeightedNineTailModel 



+Wei ghtedNi neTai 1 Model () 

+getNumberOfFlips(u: int): int 
-getNumberOfFlips(u: int, v: int): int 
-getEdgesQ: List<WeightedEdge> 



A tree rooted at node 511. 

Constructs a model for the nine tail problem and obtains the 
tree. 

Returns a path from the specified node to the root. The path 

returned consists of the node labels in a list. 
Returns a list of Edge objects for the graph. 

Returns a node consisting of nine characters of H's and T's. 

Returns the index of the specified node. 

Flips the node at the specified position and returns the index 
of the flipped node. 

Flips the node at the specified row and column. 
Displays the node to the console. 



Constructs a model for the weighted nine tail problem 

and obtains a ShortestPathTree rooted from the target 
node. 

Returns the number of flips from node u to the target 
node 511. 

Returns the number of different cells between the two 
nodes. 

Gets the weighted edges for the weighted nine tail 
problem. 



Figure 28.21 WeightedNineTailModel extends NineTailModel. 



The NineTailModel class creates a Graph and obtains a Tree rooted at the target node 
511. WeightedNineTailModel is the same as NineTailModel except that it creates a 
WeightedGraph and obtains a ShortestPathTree rooted at the target node 511. 
WeightedNineTailModel extends NineTailModel. The method get Edges () finds all 
edges in the graph. The getNumberOf Fl ips(int u , int v) method returns the number of 
flips from node u to node v. The getNumberOf Fl i ps (i nt u) method returns the number of 
flips from node u to the target node. 

Listing 28.8 implements WeightedNineTailModel. 



Listing 28.8 Wei ghtedNi neTai 1 Model . j ava 



1 

2 
3 
4 
5 
6 
7 
8 
9 
10 
11 
12 



import java.util ."• ; 

public class WeightedNineTailModel extends NineTailModel { 

/** Construct a model */ 

public WeightedNi neTai IModel () { 

// Create edges 

List<WeightedEdge> edges = getEdgesQ; 



// Create a graph 
Wei ghtedGraph<Integer> graph 
edges, NUMBER_0F_N0DES) ; 



new WeightedGraph<Integer>( 



extends NineTailModel 



constructor 



get edges 



create a graph 
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get a tree 



get weighted edges 



get adjacent node 



add an edge 



number of flips 



total number of flips 



13 
14 
15 
16 
17 
18 
19 
20 
21 
22 
23 
24 
25 
26 
27 
28 
29 
30 
31 
32 
33 
34 
35 
36 
37 
38 
39 
40 
41 
42 
43 
44 
45 
46 
47 
48 
49 
50 
51 
52 

53 } 



// Obtain a BSF tree rooted at the target node 
tree = graph . getShortestPath(511) ; 

} 

/** Create all edges for the graph V 
private Li st<Wei ghtedEdge> getEdgesO { 

// Store edges 

Li st<WeightedEdge> edges = new ArrayLi st<Wei ghtedEdge>() ; 

for (int u = 0; u < NUMBER_0F_N0DES ; u++) { 
for (int k = 0; k < 9; k++) { 

char[] node = getNode(u); // Get the node for vertex u 
if (node[k] == 'H') { 

int v = getFlippedNode(node, k) ; 

int numberOf Fl i ps = getNumberOfFlips(u, v) ; 

// Add edge (v, u) for a legal move from node u to node v 
edges. add(new Wei ghtedEdge(v, u, numberOf Fl i ps)) ; 



return edges; 

} 

private static int getNumberOfFlips(int u, int v) { 
char[] nodel = getNode(u); 
char[] node2 = getNode(v); 

int count = 0; // Count the number of different cells 
for (int i = 0; i < nodel. length; i++) 
if (nodel[i] != node2[i]) count++; 

return count; 

} 

public int getNumberOf Fl i ps(int u) { 
return 

((Wei ghtedGraph<Integer> . ShortestPathTree)tree) . getCost (u) ; 

} 



Wei ghtedNineTail Model extends NineTail Model to build a WeightedCraph to model 
the weighted nine tail problem (lines 10-11). For each node u, the getEdgesO method finds 
a flipped node v and assigns the number of flips as the weight for edge (u, v) (line 30). The 
getNumberOf Fl ips (int u, int v) method returns the number of flips from node u to 
node v (lines 38-47). The number of flips is the number of the different cells between the two 
nodes (line 44). 

The Wei ghtedNineTail Model constructs a WeightedGraph (lines 10-11) and obtains 
a ShortestPathTree rooted at the target node 511 (line 14). Note that tree is a protected 
data field defined NineTail Model and ShortestPathTree is a subclass of Tree. The 
methods defined in NineTail Model use the tree property. 

The getNumberOf Fl i ps (i nt u) method (lines 49-52) returns the number of flips from 
node u to the target node, which is the cost of the path from node u to the target node. This 
cost can be obtained by invoking the getCost(u) method defined in the 
ShortestPathTree class (line 51). 

Listing 28.9 gives a program that prompts the user to enter an initial node and displays the 
minimum number of flips to reach the target node. 
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Listing 28.9 WeightedNineTail .java 

1 import java. util .Scanner; 
2 

3 public class WeightedNineTail { 

4 public static void main(String[] args) { 

5 // Prompt the user to enter nine coins H's and T's 

6 System . out . pri nt("Enter an initial nine coin H's and T's: ") ; 

7 Scanner input = new Scanner(System . i n) ; 

8 String s = input. nextLineO ; 

9 char[] initial Node = s . toCharArrayO ; initial node 
10 

11 WeightedNineTail Model model = new Wei ghtedNi neTai 1 Model () ; create model 

12 java. uti 1 . Li st<Integer> path = 

13 model . getShortestPath(Ni neTai 1 Model .getlndex(initialNode)) ; get shortest path 
14 

15 System. out. println("The steps to flip the coins are ") ; 

16 for (int i =0; i < path.sizeO; i++) 

17 Ni neTai 1 Model . pri ntNode( printnode 

18 NineTailModel .getNode(path.get(i) . i ntVal ue())) ; 
19 

20 System. out. println("The number of flips is " + 

21 model .getNumberOfFlips(NineTailModel .getlndex(initialNode))) ; number of flips 

22 } 

23 } 



Enter an initial nine coin H's and T's: HHHTTTHHH -Enter 




The steps to flip the coins are 

HHH 

TTT 

HHH 

HHH 
THT 
TTT 

TTT 
TTT 
TTT 

The number of flips is 8 



The program prompts the user to enter an initial node with nine letters, H's and T's, as a string 
in line 8, obtains an array of characters from the string (line 9), creates a model (line 11), 
obtains a shortest path from the initial node to the target node (lines 12-13), displays the 
nodes in the path (lines 16-18), and invokes getNumberOf Fl ips to get the number of flips 
needed to reach to the target node (line 21). 

Key Terms 



Dijkstra's algorithm 955 
edge-weighted graph 940 
minimum spanning tree 949 
Prim's algorithm 949 



shortest path 955 
single-source shortest path 955 
vertex-weighted graph 940 
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Chapter Summary 



1 . You can use adjacency matrices or priority queues to represent weighted edges. 

2 . A spanning tree of a graph is a subgraph that is a tree and connects all vertices in the graph. 
You learned how to implement Prim's algorithm for finding a minimum spanning tree. 

3. You learned how to implement Dijkstra's algorithm for finding shortest paths. 

Review Questions 

Section 28.4 

28. 1 Find a minimum spanning tree for the following graph. 



1 10 2 




5 2 4 



28.2 Is the minimum spanning tree unique if all edges have different weights? 

28.3 If you use an adjacency matrix to represent weighted edges, what will be the time 
complexity for Prim's algorithm? 

28.4 What happens to the getMinimumSpanningTreeO method in WeightedCraph 

if the graph is not connected? Verify your answer by writing a test program that cre- 
ates an unconnected graph and invokes the getMinimumSpanningTreeO 
method. How do you fix the problem by obtaining a partial MST? 

Section 28.5 

28.5 Trace Dijkstra's algorithm for finding the shortest paths from Boston to all other 
cities in Figure 27.1. 

28.6 Is the shortest path between two vertices unique if all edges have different weights? 

28.7 If you use an adjacency matrix to represent weighted edges, what would be the 
time complexity for Dijkstra's algorithm? 

28.8 What happens to the getShortestPathO method in WeightedGraph if the 

graph is not connected? Verify your answer by writing a test program that creates 
an unconnected graph and invoke the getShortestPathO method. 

Programming Exercises 

28.1* (Kruskal's algorithm) The text introduced Prim's algorithm for finding a mini- 
mum spanning tree. Kruskal's algorithm is another well-known algorithm for find- 
ing a minimum spanning tree. The algorithm repeatedly finds a minimum-weight 
edge and adds it to the tree if it does not cause a cycle. The process ends when all 
vertices are in the tree. Design and implement an algorithm for finding an MST 
using Kruskal's algorithm. 
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{Implementing Prim's algorithm using adjacency matrix) The text implements 
Prim's algorithm using priority queues on adjacent edges. Implement the algo- 
rithm using adjacency matrix for weighted graphs. 

{Implementing Dijkstra's algorithm using adjacency matrix) The text imple- 
ments Dijkstra's algorithm using priority queues on adjacent edges. Implement 
the algorithm using adjacency matrix for weighted graphs. 

{Modifying weight in the nine tail problem) In the text, we assign the number of 
the flips as the weight for each move. Assuming that the weight is three times of 
the number of flips, revise the program. 

{Prove or disprove) The conjecture is that both NineTail Model and 
Wei ghtedNineTail Model result in the same shortest path. Write a program to 
prove or disprove it. 

(Hint: Add a new method named depth (int v) in the AbstractCraph .Tree 
class to return the depth of the v in the tree. Let treel and tree2 denote the 
trees obtained from NineTail Model and WeightedNineTail Model , respec- 
tively. If the depth of a node u is the same in treel and in tree2, the length of 
the path from u to the target is the same.) 

{Weighted 4 X 4 16 tail model) The weighted nine tail problem in the text uses 
a 3 X 3 matrix. Assume that you have 16 coins placed in a 4 X 4 matrix. Cre- 
ate a new model class named Wei ghtedTail Model 16. Create an instance of 
the model and save the object into a file named Exercise28_6.dat. 

{Weighted 4 X 4 16 tail view) Listing 27.12, NineTailApp.java, presents a view for 
the nine tail problem. Revise this program for the weighted 4X416 tail problem. 
Your program should read the model object created from the preceding exercise. 

{Traveling salesman problem) The traveling salesman problem (TSP) is to find 
a shortest round-trip route that visits each city exactly once and then returns to 
the starting city. The problem is equivalent to finding a shortest Hamiltonian 
cycle. Add the following method in the WeightedGraph class: 

// Return a shortest cycle 
// Return null if no such cycle exists 
public Li st<Integer> getShortestHamiltonianCycleO 

28.9* {Finding a minimum spanning tree) Write a program that reads a connected graph 
from a file and displays its minimum spanning tree. The first line in the file contains 
a number that indicates the number of vertices (n). The vertices are labeled as 0, 1, 
. . . , n-1. Each subsequent line describes the edges in the form of ul, vl, wl | 
u2 , v2 , w2 | .... Each triplet describes an edge and its weight. Figure 28.22 
shows an example of the file for the corresponding graph. Note that we assume the 
graph is undirected. If the graph has an edge (u, v), it also has an edge (v, u). Only 
one edge is represented in the file. When you construct a graph, both edges need to 
be considered. 



File 
6 

0, 1, 100 | 0, 2, 3 

1, 3, 20 

2, 3, 40 | 2, 4, 2 

3, 4, 5 | 3, 5, 5 

4, 5, 9 

(b) 

Figure 28.22 The vertices and edges of a weighted graph can be stored in a file. 



28.2* 
28.3* 
28.4* 
28.5* 

28.6** 

28.7** 
28.8** 
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Your program should prompt the user to enter the name of the file, should read 
data from a file, create an instance g of WeightedCraph, invoke 
g . printWeightedEdgesO to display all edges, invoke getMinimumSpan- 
ningTreeO to obtain an instance tree of WeightedGraph.MST, invoke 
tree . getTotal Weight () to display the weight of the minimum spanning 
tree, and invoke tree.printTreeO to display the tree. Here is a sample run 
of the program: 



Enter a file name: c:\exercise\Exercise28_9.txt 
The number of vertices is 6 



Vertex 
Vertex 1 
Vertex 2 
Vertex 3 
Vertex 4 
Vertex 5 



(0, 2, 3) (0, 1, 100) 
CI, 3, 20) CI, 0, 100) 
C2, 4, 2) C2, 3, 40) C2, 0, 3) 
C3, 4, 5) C3, 5, 5) C3, 1, 20) C3, 2, 40) 
C4, 2, 2) C4, 3, 5) C4, 5, 9) 
9) 



C5, 3, 5) C5, 4 
Total weight is 35 
Root is: 

Edges: C3, 1) CO, 2) C4, 3) C2, 4) C3, 5) 



(Hint: Use new WeightedGraphO ist, numberOfVertices) to create a 
graph, where 1 i st contains a list of WeightedEdge objects. Use new Weight- 
edEdgeCu , v, w) to create an edge. Read the first line to get the number of ver- 
tices. Read each subsequent line into a string s and use s . spl it(" [\\ | ] ") to 
extract the triplets. For each triplet, triplet. split("[,]") to extract vertices 
and weight.) 

28. 1 0* (Creating a file for a graph) Modify Listing 28.3, TestWeightedGraph.java, to cre- 
ate a file for representing graphl. The file format is described in Exercise 28.9. 
Create the file from the array defined in lines 7-24 in Listing 28.3. The number of 
vertices for the graph is 12, which will be stored in the first line of the file. An 
edge (u, v) is stored if u < v. The contents of the file should be as follows: 



12 






0, 1, 807 | 


0, 3, 1331 | 


0, 5, 2097 


1, 2, 381 | 


1, 3, 1267 




2, 3, 1015 


2, 4, 1663 


| 2, 10, 1435 


3, 4, 599 | 


3, 5, 1003 




4, 5, 533 | 


4, 7, 1260 | 


4, 8, 864 | 4, 10, 496 


5, 6, 983 | 


5, 7, 787 




6, 7, 214 






7, 8, 888 






8, 9, 661 | 


8, 10, 781 | 


8, 11, 810 


9, 11, 1187 






10, 11, 239 







28.1 I * (Finding shortest paths) Write a program that reads a connected graph from a 
file. The graph is stored in a file using the same format specified in Exercise 
28.9. Your program should prompt the user to enter the name of the file, then 
two vertices, and should display the shortest path between the two vertices. For 
example, for the graph in Figure 28.21, a shortest path between and 1 may be 
displayed as 2 4 3 1. 
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Here is a sample run of the program: 



Enter a file name: Exercise28_ll.txt 


__ 

^ Enter 


Enter two vertices (integer indexes): 


1^ Enter 


The number of vertices is 6 




Vertex 


(0, 2, 3) (0, 1, 100) 




Vertex 1 


CI, 3, 20) CI, 0, 100) 




Vertex 2 


C2, 4, 2) C2, 3, 40) C2, 0, 


3) 


Vertex 3 


C3, 4, 5) C3, 5, 5) C3, 1, 


20) C3, 2, 40) 


Vertex 4 


C4, 2, 2) C4, 3, 5) C4, 5, 


9) 


Vertex 5 


C5, 3, 5) C5, 4, 9) 




A path from Otol: 02431 





28.1 2* (Displaying weighted graphs) Revise GraphVi ew in Listing 27.6 to display a 
weighted graph. Write a program that displays the graph in Figure 27.1 as 
shown in Figure 28.23(a). 




(a) (b) 
Figure 28.23 (a) Exercise 28.12 displays a weighted graph, (b) Exercise 28.14 displays an MST. 



28.13* (Displaying shortest paths) Revise GraphVi ew in Listing 27.6 to display a 
weighted graph and a shortest path between the two specified cities, as shown 
in Figure 28.18. You need to add a data field path in GraphView. If a path is 
set, the edges in the path are displayed in blue. If a city not in the map is 
entered, the program displays a dialog box to alert the user. 

28.14* (Displaying a minimum spanning tree) Revise GraphView in Listing 27.6 to 
display a weighted graph and a minimum spanning tree for the graph in Figure 
27.1, as shown in Figure 28.23(b). The edges in the MST are shown in blue. 

28.1 5*** (Dynamic graphs) Write a program that lets the users create a weighted graph 
dynamically. The user can create a vertex by entering its name and location, as 
shown in Figure 28.24. The user can also create an edge to connect two ver- 
tices. To make this program work, add the following two methods in the 
WeightedGraph class. 

public void addVertex(V vertex) 



public void addEdgeCint u, int v, int weight) 
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I Exercisers 15 




■"■ill a new vertex 
trtrtax name: 
x-UHinliiiftlp: 
^-coordinate: 



Acid 3 new cdjic 
k/flrtflx u (lnclBK|: 
VhiIhx v(iiiElHx): 
WekJlrl {iiiUe 



Find a shortest Dath 
Sriirliiiy wilt?x: 



!sl .■ i Pain 



Figure 28.24 The program can add vertices and edges and display a shortest path between 
two specified vertices. 



To simplify the program, assume that vertex names are the same as vertex 
indices. You have to add the vertex indices 0, 1, . . . , and n, in this order. The 
user may specify two vertices and let the program display their shortest path 
in blue. 

28. 1 6*** (Displaying a dynamic MST) Write a program that lets the user create a 
weighted graph dynamically. The user can create a vertex by entering its name 
and location, as shown in Figure 28.7. The user can also create an edge to con- 
nect two vertices. To make this program work, add the following two methods 
in the WeightedCraph class. 

public void addVertex(V vertex) 

public void addEdge(int u, int v, int weight) 

To simplify the program, assume that vertex names are the same as those of 
vertex indices. You have to add the vertex indices 0, 1, . . . , and n, in this 
order. The edges in the MST are displayed in blue. As new edges are added, 
the MST is redisplayed. 



Chapter 



Multithreading 

Objectives 

■ To get an overview of multithreading (§29.2). 

■ To develop task classes by implementing the Runnabl e interface (§29.3). 

■ To create threads to run tasks using the Thread class (§29.3). 

■ To control threads using the methods in the Thread class (§29.4). 

■ To control animations using threads (§§29.5, 29.7). 

■ To run code in the event dispatch thread (§29.6). 

■ To execute tasks in a thread pool (§29.8). 

■ To use synchronized methods or blocks to 
synchronize threads to avoid race conditions (§29.9). 

■ To synchronize threads using locks (§29.10). 

■ To facilitate thread communications using 
conditions on locks (§§29.11-29.12). 

■ To use blocking queues to synchronize access to an 
array queue, linked queue, and priority queue (§29.13). 

■ To restrict the number of accesses to a shared 
resource using semaphores (§29.14). 

■ To use the resource-ordering technique to avoid 
deadlocks (§29.15). 

■ To describe the life cycle of a thread (§29.16). 

■ To create synchronized collections using the static 
methods in the Collections class (§29.17). 

■ To run time-consuming tasks in a Swi ngWor ker 

rather than in the event dispatch thread (§29.18). 

■ To display the completion status of a task 
using JProgressBar (§29.19). 
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29.1 Introduction 

multithreading One of the powerful features of Java is its built-in support for multithreading — the concur- 

rent running of multiple tasks within a program. In many programming languages, you 
have to invoke system-dependent procedures and functions to implement multithreading. 
This chapter introduces the concepts of threads and how to develop multithreading pro- 
grams in Java. 

29.2 Thread Concepts 

thread A program may consist of many tasks that can run concurrently. A thread is the flow of exe- 

task cution, from beginning to end, of a task. It provides the mechanism for running a task. With 

Java, you can launch multiple threads from a program concurrently. These threads can be ex- 
ecuted simultaneously in multiprocessor systems, as shown in Figure 29.1(a). 



Thread 1 | -| 

Thread 2 [ — | 



Thread 1 1 -| 
Thread 2 I — 



Thread 3 \ -f 



Thread 3 



(a) 



■O — Q 

(b) 



Figure 29.1 (a) Here multiple threads are running on multiple CPUs, (b) Here multiple 
threads share a single CPU. 



time sharing 



task 

runnable object 
thread 



In single-processor systems, as shown in Figure 29.1(b), the multiple threads share CPU 
time known as time sharing, and the operating system is responsible for scheduling and allo- 
cating resources to them. This arrangement is practical, because most of the time the CPU is 
idle. It does nothing, for example, while waiting for the user to enter data. 

Multithreading can make your program more responsive and interactive, as well as en- 
hance performance. For example, a good word processor lets you print or save a file while you 
are typing. In some cases, multithreaded programs run faster than single-threaded programs 
even on single-processor systems. Java provides exceptionally good support for creating and 
running threads and for locking resources to prevent conflicts. 

When your program executes as an application, the Java interpreter starts a thread for the 
man n method. When your program executes as an applet, the Web browser starts a thread to 
run the applet. You can create additional threads to run concurrent tasks in the program. In 
Java, each task is an instance of the Runnabl e interface, also called a runnable object. A 
thread is essentially an object that facilitates the execution of a task. 



Thread class 
Runnabl e interface 
run() method 



29.3 Creating Tasks and Threads 



Tasks are objects. To create tasks, you have to first define a class for tasks. A task class must 
implement the Runnable interface. The Runnable interface is rather simple. All it contains 
is the run method. You need to implement this method to tell the system how your thread is 
going to run. A template for developing a task class is shown in Figure 29.2(a). 

Once you have defined a TaskCl ass, you can create a task using its constructor. For example, 



creating a task 



TaskCJass task = new TaskClass(. . . ) ; 
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java. Tang. Runnable TaskClass | 



// Custom task class 

public class TaskClass implements Runnable { 



public TaskClass(. . .) { 

} 

// Implement the run method in Runnable 
public void run() { 

// Tell system how to run custom thread 

} 



// Client class 
public class Client { 

public void someMethodQ { 



// Create an instance of TaskClass 
TaskClass task = new TaskCl ass( . . . ) ; 

// Create a thread 

Thread thread = new Thread(task) ; 



// Start a thread 
thread . startQ ; 



(a) 



(b) 



Figure 29.2 Define a task class by implementing the Runnabl e interface. 



A task must be executed in a thread. The Thread class contains the constructors for cre- 
ating threads and many useful methods for controlling threads. To create a thread for a 
task, use 

Thread thread = new Thread(task) ; creating a thread 

You can then invoke the start () method to tell the JVM that the thread is ready to run, as 
follows: 

thread . start() ; starting a thread 

The JVM will execute the task by invoking the task's run() method. Figure 29.2(b) outlines 
the major steps for creating a task, a thread, and starting the thread. 

Listing 29.1 gives a program that creates three tasks and three threads to run them: 

■ The first task prints the letter a 100 times. 

■ The second task prints the letter b 100 times. 

■ The third task prints the integers 1 through 100. 

When you run this program, the three threads will share the CPU and take turns printing letters 
and numbers on the console. Figure 29.3 shows a sample run of the program. 



■ command Prompt 




* 


C:\book>jaua TaskThreadDeiso 

aaaaaaaaaaaaaaaab lb 2b 3b lb 5b 6b 7b S 9 10 11 12 13 14 15 1G IT IS 13 20 21 2 
2 23 21 25 26bababababab3hababa 27 2S 23 30 31 32 33 31 35 36 37 38 39 13 t1 12 
13 11 45 16 17 13 13 53 51 52 53 51 55 56 57 53 53 63 61 atjababababababBbabbbbbbb 
bbbbbbbbbbbba 62a 63a 61b 65a 66b 67a 68a 69a 70 71 72 73 71 75 76 77 78 79 8C 8 
1 82 83 31 35 36 87 BSabababababababababbbbbbbbbbbbbbbbbbtaa 39a 30a 91a 92a 93a 
91a 95a 96a 97 93 99 1 QOaaaaaaaaaaaaaaaaaabbbbbbbbbbbbbbbbbbbbbbbbbbbbbaaaaaaaaa 
aaaaaaaaaaaa 
C:\bOOtO 


J 

13 



Figure 29.3 Tasks printA, printB, and printlOO are executed simultaneously to dis- 
play the letter a 100 times, the letter b 100 times, and the numbers from 1 to 100. 
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Listing 29.1 TaskThreadDemo. java 



create tasks 



create threads 



start threads 



task class 



task class 



1 public class TaskThreadDemo { 

2 public static void main(String[] args) { 

// Create tasks 

Runnable printA = new Pri ntChar( ' a' , 100); 
Runnable printB = new Pri ntChar( ' b' , 100); 
Runnable printlOO = new Pri ntNum(lOO) ; 



// Create threads 

Thread threadl = new Thread(pri ntA) ; 

new Thread(pri ntB) ; 
new Thread(pri ntlOO) ; 



Thread thread2 
Thread thread3 



// Start threads 
threadl. start() ; 
thread2 . start() ; 
thread3 . startQ ; 



3 
4 
5 
6 
7 
8 
9 
10 
11 
12 
13 
14 
15 
16 

17 } 

18 } 
19 

20 // The task for printing a character a specified number of times 

21 class PrintChar implements Runnable { 

22 private char charToPrint; // The character to print 

23 private int times; // The number of times to repeat 
24 

25 
26 
27 
28 
29 
30 
31 
32 
33 
34 
35 
36 
37 
38 
39 
40 
41 } 
42 

43 // The task class for printing numbers from 1 to n for a given n 

44 class PrintNum implements Runnable { 

45 private int lastNum; 
46 

47 /** Construct a task for printing 1, 2, ... , n */ 
48 
49 
50 
51 
52 
53 
54 
55 
56 
57 

58 } 



/** Construct a task with specified character and number of 
* times to print the character 

*/ 

public Pri ntChar(char c, int t) { 
charToPrint = c; 
times = t; 



Override the run() method to tell the system 
what task to perform 



*/ 

public void run() { 

for (int i =0; i < times; i++) { 
System. out. pri nt(charToPrint) ; 

} 

} 



/** Construct a task for printing 1, 2, 
public PrintNum(int n) { 
lastNum = n; 

} 

/** Tell the thread how to run */ 
public void run() { 

for (int i = 1; i <= lastNum; i++) { 
System. out . pri nt(" " + i); 

} 

} 
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The program creates three tasks (lines 4—6). To run them concurrently, three threads are created (lines 
9-11). The start () method (lines 14-16) is invoked to start a thread that causes the runO 
method in the task to be executed. When the run () method completes, the thread terminates. 

Because the first two tasks, printA and printB, have similar functionality, they can be 
defined in one task class PrintChar (lines 21-41). The PrintChar class implements 
Runnable and overrides the run() method (lines 36-40) with the print-character action. 
This class provides a framework for printing any single character a given number of times. 
The runnable objects printA and printB are instances of the PrintChar class. 

The PrintNum class (lines 44-58) implements Runnable and overrides the run() 
method (lines 53-57) with the print-number action. This class provides a framework for print- 
ing numbers from 1 to n, for any integer n. The runnable object printlOO is an instance of 
the class printNum class. 

Ijt Note 

If you don't see the effect of these three threads running concurrently, increase the number of effect of concurrency 

characters to be printed. For example, change line 4 to 

Runnable printA = new PrintChar('a' , 10000); 
^Sj^ Important Note 

The runO method in a task specifies how to perform the task. This method is automatically in- runO method 

voked by the JVM. You should not invoke it. Invoking runO directly merely executes this method 
in the same thread; no new thread is started. 



29.4 The Thread Class 

The Thread class contains the constructors for creating threads for tasks, and the methods for 
controlling threads, as shown in Figure 29.4. 



«i nterface» 
java. Tang. Runnable 



java.lang.Thread 



+Thread() 

+Thread(task: Runnable) 
+start(): void 
+isAlive(): boolean 
+setPrion'ty(p: int): void 
+join(): void 

+sleep(millis: long): void 

+yield(): void 

+i nterruptQ : void 



Creates an empty thread. 

Creates a thread for a specified task. 

Starts the thread that causes the run () method to be invoked by the JVM. 

Tests whether the thread is currently running. 

Sets priority p (ranging from 1 to 10) for this thread. 

Waits for this thread to finish. 

Puts a thread to sleep for a specified time in milliseconds. 

Causes a thread to pause temporarily and allow other threads to execute. 

Interrupts this thread. 



Figure 29.4 The Thread class contains the methods for controlling threads. 



Note 

Since the Thread class implements Runnabl e, you could define a class that extends Thread and separating task from thread 

implements the run method, as shown in Figure 29.5(a), and then create an object from the class 
and invoke its start method in a client program to start the thread, as shown in Figure 29.5(b). 
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java. 1 ang .Thread |^ 


CustomThread | 




// Client class 
public class Client { 

public void someMethod() { 

// Create a thread 


// Custom thread class 

public class CustomThread extends Thread { 
public CustomThread(. . .) { 










CustomThread threadl = new CustomThread( . . .) ; 


} 

// Override the run method in Runnable 
public void run() { 

// Tell system how to perform this task 






// btart a tnreaa 
threadl. start () ; 

// Create another thread 
CustomThread thread2 = new CustomThread(. . .) ; 


} 

} 






// Start a thread 
thread2. start (); 

} 

} 



(a) (b) 



Figure 29.5 Define a thread class by extending the Thread class. 



This approach is, however, not recommended, because it mixes the task and the mechanism of 
running the task. Separating the task from the thread is a preferred design. 



ij| Note 

The Thread class also contains the stop(), suspendO, and resumeO methods. As of Java 2, 
deprecated method these methods are deprecated (or outdated) because they are known to be inherently unsafe. In- 

stead of using the stopO method, you should assign null to a Thread variable to indicate 
that it is stopped. 

yieldO You can use the yiel d() method to temporarily release time for other threads. For example, 

suppose you modify the code in the run() method (lines 53-57 in PrintNum in TaskThread- 
Demo.java) in Listing 29.1 as follows: 

public void run() { 

for (int i = 1; i <= lastNum; i++) { 
System . out . pri nt(" " + i); 
Thread . yi el d() ; 

} 

} 

Every time a number is printed, the thread of the print 100 task is yielded. So each number 
is followed by some characters. 
sleep(long) The si eep(l ong millis) method puts the thread to sleep for the specified time in mil- 

liseconds to allow other threads to execute. For example, suppose you modify the code in 
lines 53-57 in TaskThreadDemo.java in Listing 29.1 as follows: 

public void run() { 
try { 

for (int i =1; i <= lastNum; i++) { 
System. out. print(" " + i); 
if (i >= 50) Thread. si eep(l) ; 

} 

} 

catch (InterruptedExcepti on ex) { 

} 

} 
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Every time a number (>= 50) is printed, the thread of the pri ntlOO task is put to sleep for 
1 millisecond. 

The si eep method may throw an InterruptedException, which is a checked exception. interruptedException 

Such an exception may occur when a sleeping thread's interrupt () method is called. The 
interruptO method is very rarely invoked on a thread, so an InterruptedException is 
unlikely to occur. But since Java forces you to catch checked exceptions, you have to put it in a 
try-catch block. If a si eep method is invoked in a loop, you should wrap the loop in a try-catch 
block, as shown in (a) below. If the loop is outside the try-catch block, as shown in (b), the 
thread may continue to execute even though it is being interrupted. 



public void run() { 
try { 

while (...) { 

Thread. sleep(lOOO) ; 

} 

} 

catch (InterruptedException ex) { 
ex . pri ntStackTrace() ; 

} 



(a) Correct 



public void run() { 
while (...) { 
try { 

Thread. sleep(sleepTime) ; 

} 

catch (InterruptedException ex) { 
ex.printStackTrace() ; 

} 

} 

} 



(b) Incorrect 



You can use the j oi n () method to force one thread to wait for another thread to finish. For ex- j oi n () 
ample, suppose you modify the code in lines 53-57 in TaskThreadDemo.java in Listing 29.1 as 
follows: 



public void run() { 

Thread thread4 = new Thread( 

new PrintChar('c' , 40)); 
thread4. start () ; 
try { 

for (int i =1; i <= lastNum; i++) { 
System. out. print (" " + i); 
if (i == 50) thread4.join() ; 

} 

} 

catch (InterruptedException ex) { 
} 



Thread 
printlOO 



Wait for thread4 
to finish 



Thread 
thread4 




thread4 finished 



A new thread4 is created. It prints character c 40 times. The numbers from 50 to 100 are 
printed after thread thread4 is finished. 

Java assigns every thread a priority. By default, a thread inherits the priority of the thread that 
spawned it. You can increase or decrease the priority of any thread by using the setPriority setPriority(int) 
method, and you can get the thread's priority by using the getPriori ty method. Priorities are 
numbers ranging from 1 to 10. The Thread class has the int constants MIN_PRI0RITY, 
N0RM_PRI0RITY, and MAX_PRI0RITY , representing 1, 5, and 10, respectively. The priority of 
the main thread is Thread . N0RM_PRI0RITY. 

The JVM always picks the currently runnable thread with the highest priority. A lower- 
priority thread can run only when no higher-priority threads are running. If all runnable 
threads have equal priorities, each is assigned an equal portion of the CPU time in a circular 

queue. This is called the round-robin scheduling. For example, suppose you insert the follow- round-robin scheduling 
ing code in line 16 in TaskThreadDemo.java in Listing 29.1: 

thread3 . setPri ori ty (Thread . MAX_PRI0RITY) ; 

The thread for the pri ntlOO task will be finished first. 
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tj| Tip 

The priority numbers may be changed in a future version of Java. To minimize the impact of any 
changes, use the constants in the Thread class to specify thread priorities. 

# Tip 

A thread may never get a chance to run if there is always a higher-priority thread running or a 
contention or starvation same-priority thread that never yields. This situation is known as contention or starvation. To 

avoid contention, the thread with high priority must periodically invoke the sleep or yield method 
to give a thread with a lower or the same priority a chance to run. 



29.5 Example: Flashing Text 

The use of a Timer object to control animations was introduced in §16.12, "Animation Using 
the Timer Class." You can also use a thread to control animation. Listing 29.2 gives an ex- 
ample that displays a flashing text on a label, as shown in Figure 29.6. 





Figure 29.6 The text Welcome blinks. 



implements Runnable 
create a label 



add a label 
start a thread 



how to run 



sleep 



main method omitted 



Listing 29.2 FlashingText. java 

1 import javax. swing.*; 

jblic class FlashingText extends JApplet implements Runnable { 
private JLabel jlblText = new J Label ("Welcome", J Label .CENTER) ; 



public Fl ashi ngText() { 
add (jlblText) ; 
new Thread(this) . start() ; 

} 

/** Set the text on/off every 200 milliseconds */ 
public void run() { 
try { 

while (true) { 

if (jlblText.getTextO == null) 

jlbl Text. setText ("Wei come") ; 
el se 

j 1 bl Text . setText (null); 
Thread. si eep(200) ; 

} 

} 

catch (InterruptedException ex) { 
} 



Fl ashi ngText implements Runnabl e (line 3), so it is a task class. Line 8 wraps the task in 
a thread and starts the thread. The run method dictates how to run the thread. It sets a text in 
the label if the label does not have a text (line 15), and sets its text null (line 18) if the label 
has a text. The text is set and unset to simulate a flashing effect. 
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You can use a timer or a thread to control animation. Which one is better? A timer is a thread vs. timer 
source component that fires an ActionEvent at a "fixed rate." When an action event occurs, 
the timer invokes the listener's actionPer formed method to handle the event. The timer 
and event handling run on the same event dispatch thread. If it takes a long time to handle the 
event, the actual delay time between two events will be longer than the requested delay time. 
In this case, you should ran event handling on a separate thread. The next section will give an 
example to illustrate the problem and fix it by running the event handling on a separate thread. 
In general, threads are more reliable and responsive than timers. If you need a precise delay 
time or a quick response, it is better to use a thread. Otherwise, using a timer is simpler and 
more efficient. Timers consume less system resource because they run on the GUI event dis- 
patch thread, so you don't need to spawn new threads for timers. 

29.6 GUI Event Dispatch Thread 

GUI event handling and painting code executes on a special thread called the event dispatch 
thread. This is necessary because most of Swing methods are not thread-safe. Invoking them 
from multiple threads may cause conflicts. 

In certain situations, you need to run the code in the event dispatch thread to avoid pos- 
sible conflicts. You can use the static methods, invokeLater and invokeAndWait in the 
javax. swi ng.SwingUtili ties class to run the code in the event dispatch thread. You 
must put this code in the run method of a Runnabl e object and specify the Runnabl e object 
as the argument to invokeLater and invokeAndWait. The invokeLater method returns 
immediately, without waiting for the event dispatch thread to execute the code. The 
invokeAndWait method is just like invokeLater, except that invokeAndWait doesn't re- 
turn until the event dispatching thread has executed the specified code. 

So far, you have launched your GUI application from the main method by creating a frame 
and making it visible. This works fine for most applications, but if it takes a long time to launch 
a GUI application, problems may occur. To avoid possible problems in this situation, you 
should launch GUI creation from the event dispatch thread, as follows: 

public static void mai n(Stri ng [] args) { 
SwingUti"lities.invokeLater(new RunnableO { 
public void run() { 

// The code for creating a frame and setting its properties 

} 

}); 

} 

For example, Listing 29.3 gives a simple program that launches the frame from the event dispatch 
thread. 

Listing 29.3 EventDi spatcherThreadDemo. java 

1 import javax. swing.*; 
2 

3 public class EventDi spatcherThreadDemo extends DApplet { 

4 public EventDi spatcherThreadDemo() { 

5 add(new ]Label("Hi, it runs from an event dispatch thread")); 

6 } 
7 

8 /** Main method */ 

9 public static void main(String[] args) { 

10 Swi ngLIti I i ti es . i nvokeLater(new RunnableO { 

11 public void run() { 

12 JFrame frame = new 3Frame("EventDispatcherThreadDemo") ; create frame 

13 frame. add(new EventDi spatcherThreadDemoQ) ; 



invokeLater 
invokeAndWait 
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14 frame. setSize(200, 200); 

15 frame . setDef aul tCl oseOpe rati on (J Frame . EXIT_0N_CL0SE) ; 

16 frame. setLocationRelativeTo(null) ; // Center the frame 

17 frame . setVi si bl e(true) ; 

18 } 

19 }); 

20 } 

21 } 

29.7 Case Study: Clock with Audio 

The example creates an applet that displays a running clock and announces the time at one- 
minute intervals. For example, if the current time is 6:30:00, the applet announces, "six o'- 
clock thirty minutes a.m." If the current time is 20:20:00, the applet announces, "eight o'clock 
twenty minutes p.m." Also add a label to display the digital time, as shown in Figure 29.7. 



1 Km " -Mi-*] 




Figure 29.7 The applet displays a clock and announces the time every minute. 



audio clips To announce the time, the applet plays three audio clips. The first clip announces the hour, 

audio files the second announces the minute, and the third announces a.m. or p.m. All of the audio files 

are stored in the directory audio, a subdirectory of the applet's class directory. The 12 audio 
files used to announce the hours are stored in the files hour0.au, hourl.au, and so on, to 
hourll.au. The 60 audio files used to announce the minutes are stored in the files 
minuteO.au, minutel.au, and so on, to minute59.au. The two audio files used to announce 
a.m. or p.m. are stored in the file am.au and pm.au. 

You need to play three audio clips on a separate thread to avoid animation delays. To illus- 
trate the problem, let us first write a program without playing the audio on a separate thread. 

In §15.10, the StillClock class was developed to draw a still clock to show the current 
time. Create an applet named ClockWithAudio (Listing 29.4) that contains an instance of 
StillClock to display an analog clock, and an instance of J Label to display the digit time. 
Override the init method to load the audio files. Use a Timer object to set and display the 
current time continuously at every second. When the second is zero, announce the current time. 



Listing 29.4 ClockWithAudio. java 

1 import java. applet.'-; 

2 import javax. swing.*; 

3 import java.awt. event.*; 

4 import java.awt.*; 

5 

6 public class ClockWithAudio extends J Applet { 
audioclips 7 protected AudioClip[] hourAudio = new AudioClip[12] ; 

8 protected AudioClip[] minuteAudio = new AudioClip[60] ; 
9 

10 // Create audio clips for pronouncing am and pm 
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11 protected AudioClip amAudio = am clip 

12 Applet . newAudi oCli p (this. getCl ass () . getResource("audio/am.au")) ; 

13 protected AudioClip pmAudio = pmclip 

14 Applet. newAudioClip(this.getClass() .getResource("audio/pm.au ")) ; 
15 

16 // Create a clock 

17 private Still Clock clock = new StillClockO; still clock 
18 

19 // Create a timer 

20 private Timer timer = new Timer(1000, new TimerLi stenerO) ; timer 
21 

22 // Create a label to display time 

23 private JLabel jlblDigitTime = new ]Label("", J Label .CENTER) ; label 
24 

2 5 /** Initialize the applet */ 

26 public void init() { 

27 // Create audio clips for pronouncing hours 

28 for (int i =0; i < 12 ; i++) 

29 hourAudio[i] = Applet. newAudioClip( create audio clips 

30 this.getClassO . getResource("audio/hour" + i + ".au" )); 
31 

32 // Create audio clips for pronouncing minutes 

33 for (int i =0; i < 60; i++) 

34 minuteAudio[i] = Appl et . newAudi oCl i p( 

35 this.getClassO .getResource("audio/minute" + i + ".au" )); 

36 

37 // Add clock and time label to the content pane of the applet 

38 add(clock, BorderLayout. CENTER) ; 

39 add (jlblDigitTime, BorderLayout . SOUTH) ; 

40 } 
41 

42 /** Override the applet's start method */ 

43 public void start() { 

44 timer. start() ; // Resume clock starttimer 

45 } 
46 

47 /** Override the applet's stop method */ 

48 public void stop() { 

49 timer. stop(); // Suspend clock stoptimer 

50 } 
51 

52 private class Ti merLi stener implements Acti onLi stener { timer listener 

53 public void acti onPerformed(Acti onEvent e) { 

54 clock. setCurrentTime() ; setnewtime 

55 clock. repaint() ; 

56 jlblDigitTime. setText(clock.getHour() + ":" + clock. getMinute() 

57 + ":" + clock. getSecondO) ; 

58 if (clock. getSecondO == 0) 

59 announceTime(clock.getHour() , clock. getMinuteO) ; announce time 

60 } 

61 } 
62 

63 /** Announce the current time at every minute */ 

64 public void announceTime(int hour, int minute) { 

65 // Announce hour 

66 hourAudio[hour % 12]. pi ay O; announce hour 
67 

68 try { 

69 // Time delay to allow hourAudio play to finish 
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70 Thread. si eep(1500) ; 
71 

72 // Announce minute 

73 mi nuteAudio [minute] .play () ; 
74 

75 // Time delay to allow minuteAudio play to finish 

76 Thread. sleep(1500) ; 

77 } 

78 catch(InterruptedException ex) { 

79 } 
80 

81 // Announce am or pm 

82 if (hour < 12) 

83 amAudio.playO ; 

84 el se 

85 pmAudio.playQ ; 



86 } 

87 } 

The hour Audio is an array of twelve audio clips that are used to announce the 12 hours of the 
day (line 7); the minuteAudio is an audio clip that is used to announce the minutes in an 
hour (line 8). The amAudio announces a.m. (line 11); the pmAudio announces p.m. (line 13). 

The init() method creates hour audio clips (lines 29-30) and minute audio clips (lines 
34-35), and places a clock and a label in the applet (lines 38-39). 

An ActionEvent is fired by the timer every second. In the listener's actionPerformed 
method (lines 53-60), the clock is repainted with the new current time, and the digital time is 
displayed in the label. 

In the announceTime method (lines 64-86), the sleepO method (lines 70, 76) is pur- 
posely invoked to ensure that one clip finishes before the next clip starts, so that the clips do 
not interfere with each other. 

The applet's startO and stopO methods (lines 43-50) are overridden to ensure that the 
timer starts or stops when the applet is restarted or stopped. 

When you run the preceding program, you will notice that the second hand does not dis- 
play at the first, second, and third seconds of the minute. This is because si eep(1500) is in- 
voked twice in the announceTimeO method, which takes three seconds to announce the 
time at the beginning of each minute. Thus, the next action event is delayed for three seconds 
during the first three seconds of each minute. As a result of this delay, the time is not updated 
and the clock was not repainted for these three seconds. To fix this problem, you should an- 
nounce the time on a separate thread. This can be accomplished by modifying the 
announceTime method. Listing 29.5 gives the new program. 

Listing 29.5 CI ockWi thAudi oOnSeparateTh read . j ava 

1 // same import statements as in Listing 29.4, so omitted 
2 

3 public class CI ockWi thAudi oOnSeparateTh read extends J Applet { 



4 // same as in lines 7-61 in Listing 29.4, so omitted 
5 

6 /** Announce the current time at every minute */ 

7 public void announceTime(int h, int m) { 

8 new Thread(new AnnounceTimeOnSeparateThread(h , m)).start(); 

9 } 
10 

11 /** Inner class for announcing time */ 

12 class AnnounceTi meOnSeparateThread implements Runnable { 

13 private int hour, minute; 
14 
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15 /** Get Audio clips */ 

16 public AnnounceTimeOnSeparateThread(int hour, int minute) { 

17 this. hour = hour; 

18 this. minute = minute; 

19 } 
20 

21 public void run() { run thread 

22 // Announce hour 

23 hourAudio[hour % 12].play(); 
24 

25 try { 

26 // Time delay to allow hourAudio play to finish 

27 Thread. sleep(1500) ; 
28 

29 // Announce minute 

30 minuteAudio[minute] .play() ; 
31 

32 // Time delay to allow minuteAudio play to finish 

33 Thread. sleep(1500) ; 

34 } 

35 catch (InterruptedException ex) { 

36 } 
37 

38 // Announce am or pm 

39 if (hour < 12) 

40 amAudi o . pi ay () ; 

41 else 

42 pmAudio.playO ; 

43 } 

44 } 

45 } main method omitted 



The new class CI ockWi thAudioOnSeparateThread is the same as CI ockWithAudio ex- 
cept that the announceTime method is new. The new announceTime method creates a 
thread (line 8) for the task of announcing time. The task class is defined as an inner class 
(lines 12^44). The run method (line 21) announces the time on a separate thread. 

When running this program, you will discover that the audio does not interfere with the 
clock animation because an instance of AnnounceTimeOnSeparateThread starts on a sep- 
arate thread to announce the current time. This thread is independent of the thread on which 
the act ion Per formed method runs. 

29.8 Thread Pools 

In §29.3, "Creating Tasks and Threads," you learned how to define a task class by implement- 
ing java . 1 ang . Runnabl e, and how to create a thread to run a task like this: 

Runnable task = new TaskCl ass (task) ; 
new Thread(task) . start() ; 

This approach is convenient for a single task execution, but it is not efficient for a large num- 
ber of tasks, because you have to create a thread for each task. Starting a new thread for each 
task could limit throughput and cause poor performance. A thread pool is ideal to manage the 
number of tasks executing concurrently. Java provides the Executor interface for executing 
tasks in a thread pool and the ExecutorService interface for managing and controlling 
tasks. ExecutorService is a subinterface of Executor, as shown in Figure 29.8. 

To create an Executor object, use the static methods in the Executors class, as shown in 
Figure 29.9. The newFixedThreadPool (int) method creates a fixed number of threads in 
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«interface» 
java.util.concurrent.Executor 



hexecute(Runnable object): void 
^ 




«interface» 
java. util. concurrent.ExecutorService 



+shutdown(): void 

+shutdownNow() : List<Runnable> 

+isShutdown() : boolean 
+ i sTermi nated() : boolean 



Executes the runnable task. 



Shuts down the executor, but allows the tasks in the executor 
to complete. Once shut down, it cannot accept new tasks. 

Shuts down the executor immediately even though there are 
unfinished threads in the pool. Returns a list of unfinished tasks. 

Returns true if the executor has been shut down. 

Returns true if all tasks in the pool are terminated. 



Figure 29.8 Executor executes threads, and ExecutorService manages threads. 



java.util.concurrent.Executors 



+newFi xedThreadPool (numberOfTh reads : 
i nt) : ExecutorServi ce 

+newCachedThreadPool () : 
ExecutorServi ce 



Creates a thread pool with a fixed number of threads executing 
concurrently. A thread may be reused to execute another task 
after its current task is finished. 

Creates a thread pool that creates new threads as needed, but 
will reuse previously constructed threads when they are 
available. 



Figure 29.9 The Executors class provides static methods for creating Executor objects. 



a pool. If a thread completes executing a task, it can be reused to execute another task. If a 
thread terminates due to a failure prior to shutdown, a new thread will be created to replace it 
if all the threads in the pool are not idle and there are tasks waiting for execution. The 
newCachedThreadPool () method creates a new thread if all the threads in the pool are not 
idle and there are tasks waiting for execution. A thread in a cached pool will be terminated if 
it has not been used for 60 seconds. A cached pool is efficient for many short tasks. 

Listing 29.6 shows how to rewrite Listing 29.1, TaskThreadDemo.java, using a thread pool. 

Listing 29.6 ExecutorDemo. java 

1 import java. util .concurrent.*; 





2 
3 


public class ExecutorDemo { 




4 


public static void main(String[] args) { 




5 


// Create a fixed thread pool with maximum three threads 


create executor 


6 


ExecutorService executor = Executors . newFi xedThreadPool (3) ; 




7 
8 


// Submit runnable tasks to the executor 


submit task 


9 


executor . execute(new PrintChar('a' , 100)); 




10 


executor. execute(new PrintChar('b' , 100)); 




11 


executor. execute(new Pri ntNum(lOO) ) ; 




12 






13 


// Shut down the executor 


shut down executor 


14 


executor. shutdown() ; 




15 


} 




16 


} 
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Line 6 creates a thread pool executor with three threads maximum. Classes PrintChar and 
PrintNum were defined in TaskThreadDemo.java in Listing 29.1. Line 9 creates a task new 
Pri ntChar ( ' a ' , 100) and adds it to the pool. Another two runnable tasks are created and 
added to the same pool in lines 10-11 similarly. The executor creates three threads to execute 
three tasks concurrently. Suppose that you replace line 6 by 

ExecutorServi ce executor = Executors. newFi xedTh readPool (1) ; 

What will happen? The three runnable tasks will be executed sequentially, because there is 
only one thread in the pool. 
Suppose you replace line 6 by 

ExecutorServi ce executor = Executors . newCachedThreadPool () ; 

What will happen? New threads will be created for each waiting task, so all the tasks will be 
executed concurrently. 

The shutdown () method in line 14 tells the executor to shut down. No new tasks can be 
accepted, but the existing task will continue to finish. 

§ Tip 

[f you need to create a thread for one task, use the Thread class. If you need to create threads for 
multiple tasks, it is better to use a thread pool. 



29.9 Thread Synchronization 

A shared resource may be corrupted if it is accessed simultaneously by multiple threads. The 
following example demonstrates the problem. 

Suppose that you create and launch 100 threads, each of which adds a penny to an account. 
Define a class named Account to model the account, a class named AddAPennyTask to add 
a penny to the account, and a main class that creates and launches threads. The relationships 
of these classes are shown in Figure 29.10. The program is given in Listing 29.7. 

Listing 29.7 AccountWi thoutSync. java 

1 import java. util .concurrent.*; 

2 

3 public class AccountWi thoutSync { 

4 private static Account account = new AccountO; 
5 

6 public static void main(String[] args) { 

7 ExecutorServi ce executor = Executors . newCachedThreadPool () ; create executor 
8 

9 // Create and launch 100 threads 

10 for (int i = 0; i < 100; i++) { 

11 executor. execute(new AddAPennyTaskO) ; submittask 

12 } 
13 

14 executor. shutdown() ; shut down executor 

15 

16 // Wait until all tasks are finished 

17 while (!executor.isTerminated() ) { wait for all tasks to terminate 

18 } 
19 

20 System. out. pri ntl n("What is balance? " + account . getBal anceO) ; 

21 } 
22 
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23 
24 
25 
26 
27 
28 
29 
30 
31 
32 
33 
34 
35 
36 
37 
38 
39 
40 
41 
42 
43 
44 
45 
46 
47 
48 
49 
50 
51 

52 } 



// A thread for adding a penny to the account 
private static class AddAPennyTask implements Runnable { 
public void run() { 
account. deposit(l) ; 

} 

} 

// An inner class for account 
private static class Account { 
private int balance = 0; 

public int getBalanceO { 
return balance; 

} 

public void deposit(int amount) { 
int newBalance = balance + amount; 

// This delay is deliberately added to magnify the 
// data-corruption problem and make it easy to see. 
try { 

Thread . si eep( ) ; 

} 

catch (InterruptedException ex) { 
} 

balance = newBalance; 



«i nterface» 
java. Tang. Runnable 





AddAPennyTask 


100 1 ^ 


AccountWithoutSync 




+run() : void 


-account: Account 






+main(args: String[]): void 







1 1 


Account 




-balance: int 


+getBal ance() : int 

+deposi t(amount : int): void 



Figure 29.10 AccountWithoutSync contains an instance of Account and 100 threads of AddAPennyTask. 



The classes AddAPennyTask and Account in lines 24-51 are inner classes. Line 4 creates an 
Account with initial balance 0. Line 1 1 creates a task to add a penny to the account and sub- 
mit the task to the executor. Line 11 is repeated 100 times in lines 10-12. The program re- 
peatedly checks whether all tasks are completed in lines 17-18. The account balance is 
displayed in line 20 after all tasks are completed. 

The program creates 100 threads executed in a thread pool executor (lines 10-12). The 
isTerminatedO method (line 17) is used to test whether the thread is terminated. 

The balance of the account is initially (line 32). When all the threads are finished, the 
balance should be 100, but the output is unpredictable. As can be seen in Figure 29. 1 1, the an- 
swers are wrong in the sample run. This demonstrates the data-corruption problem that occurs 
when all the threads have access to the same data source simultaneously. 
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Figure 29.1 1 The AccountWi thoutSync program causes data inconsistency. 



Lines 39^19 could be replaced by one statement: 

balance = balance + amount; 

However, it is highly unlikely, although plausible, that the problem can be replicated using 
this single statement. The statements in lines 39-49 are deliberately designed to magnify the 
data-corruption problem and make it easy to see. If you run the program several times but still 
do not see the problem, increase the sleep time in line 44. This will increase the chances for 
showing the problem of data inconsistency. 

What, then, caused the error in this program? Here is a possible scenario, as shown in 
Figure 29.12. 



Step Balance Task 1 Task 2 

1 newBalance = balance + 1; 

2 newBalance = balance + 1; 

3 1 balance = newBalance; 

4 1 balance = newBalance; 
Figure 29.12 Task 1 and Task 2 both add 1 to the same balance. 



In Step 1, Task 1 gets the balance from the account. In Step 2, Task 2 gets the same balance 
from the account. In Step 3, Task 1 writes a new balance to the account. In Step 4, Task 2 writes 
a new balance to the account. 

The effect of this scenario is that Task 1 does nothing, because in Step 4 Task 2 overrides 
Task 1 's result. Obviously, the problem is that Task 1 and Task 2 are accessing a common re- 
source in a way that causes conflict. This is a common problem, known as a race condition, in race condition 
multithreaded programs. A class is said to be thread-safe if an object of the class does not thread-safe 
cause a race condition in the presence of multiple threads. As demonstrated in the preceding 
example, the Account class is not thread-safe. 



29.9.1 The synchronized Keyword 

To avoid race conditions, it is necessary to prevent more than one thread from simultaneous- 
ly entering a certain part of the program, known as the critical region. The critical region in critical region 
Listing 29.7 is the entire deposit method. You can use the keyword synchronized to 
synchronize the method so that only one thread can access the method at a time. There are 
several ways to correct the problem in Listing 29.7. One approach is to make Account 
thread-safe by adding the keyword synchronized in the deposit method in line 38, as 
follows: 

public synchronized void deposit (double amount) 
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A synchronized method acquires a lock before it executes. In the case of an instance 
method, the lock is on the object for which the method was invoked. In the case of a static 
method, the lock is on the class. If one thread invokes a synchronized instance method (re- 
spectively, static method) on an object, the lock of that object (respectively, class) is ac- 
quired first, then the method is executed, and finally the lock is released. Another thread 
invoking the same method of that object (respectively, class) is blocked until the lock is 
released. 

With the deposit method synchronized, the preceding scenario cannot happen. If 
Task 1 enters the method, Task 2 is blocked until Task 1 finishes the method, as shown in 
Figure 29.13. 



Task 1 Task 2 

Acquire a lock on the object account I 



Execute the deposit method 

J Wait to acquire the lock 

Release the lock | 

Acquire a lock on the object account 



Execute the deposit method 



Release the lock 



Figure 29.13 Task 1 and Task 2 are synchronized. 



29.9.2 Synchronizing Statements 

Invoking a synchronized instance method of an object acquires a lock on the object, and in- 
voking a synchronized static method of a class acquires a lock on the class. A synchronized 
statement can be used to acquire a lock on any object, not just this object, when executing a 
synchronized block block of the code in a method. This block is referred to as a synchronized block. The general 

form of a synchronized statement is as follows: 

synchronized (expr) { 
statements ; 

} 

The expression expr must evaluate to an object reference. If the object is already locked 
by another thread, the thread is blocked until the lock is released. When a lock is obtained 
on the object, the statements in the synchronized block are executed, and then the lock is 
released. 

Synchronized statements enable you to synchronize part of the code in a method instead of 
the entire method. This increases concurrency. You can make Listing 29.7 thread-safe by 
placing the statement in line 26 inside a synchronized block: 

synchronized (account) { 
account . deposi t(l) ; 

} 
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§ Note 

Any synchronized instance method can be converted into a synchronized statement. For exam- 
ple, the following synchronized instance method in (a) is equivalent to (b): 



public synchronized void xMethodO { 

// method body 

} 



(a) 



public void xMethodO 
synchronized (this) 

// method body 

} 

} 

(b) 



29.10 Synchronization Using Locks 

In Listing 29.7, 100 tasks deposit a penny to the same account concurrently, which causes 
conflict. To avoid it, you can simply use the synchronized keyword in the deposit 
method, as follows: 

public synchronized void deposi t(doubl e amount) 

A synchronized instance method implicitly acquires a lock on the instance before it executes 
the method. 

Java enables you to acquire locks explicitly, which gives you more control for coordinat- 
ing threads. A lock is an instance of the Lock interface, which defines the methods for ac- 
quiring and releasing locks, as shown in Figure 29.14. A lock may also use the 
newConditionO method to create any number of Condition objects, which can be used 
for thread communications. 



«interface» 
java. util. concurrent. locks.Lock 



+ lock(): void 
+unlock(): void 
+newCondition() : Condition 



java.util.concurrent.locks.ReentrantLock 



+Reent rant Lock () 
+Reentrantl_ock(fai r : boolean) 



Acquires the lock. 
Releases the lock. 

Returns a new Condi ti on instance that is bound to this 
Lock instance. 



Same as ReentrantLock(fal se). 

Creates a lock with the given fairness policy. When the 
fairness is true, the longest-waiting thread will get the 
lock. Otherwise, there is no particular access order. 



Figure 29.14 The ReentrantLock class implements the Lock interface to represent a lock. 



ReentrantLock is a concrete implementation of Lock for creating mutually exclu- 
sive locks. You can create a lock with the specified fairness policy. True fairness policies fairness policy 
guarantee that the longest-wait thread will obtain the lock first. False fairness policies 
grant a lock to a waiting thread arbitrarily. Programs using fair locks accessed by many 
threads may have poorer overall performance than those using the default setting, but 
have smaller variances in times to obtain locks and prevent starvation. 
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Listing 29.8 revises AccountWithoutSync.java in Listing 29.7 to synchronize the account 
modification using explicit locks. 

Listing 29.8 AccountWithSyncUsingLock. java 



package for locks 



create a lock 



acquire the lock 



1 
2 
3 
4 
5 
6 
7 
8 
9 
10 
11 
12 
13 
14 
15 
16 
17 
18 
19 
20 
21 
22 
23 
24 
25 
26 
27 
28 
29 
30 
31 
32 
33 
34 
35 
36 
37 
38 
39 
40 
41 
42 
43 
44 
45 
46 
47 
48 
49 
50 
51 
52 
53 
54 



import java. uti 1 . concurrent . * ; 
import java. uti 1 . concurrent . 1 ocks . * ; 

public class AccountWithSyncUsingLock { 

private static Account account = new AccountO; 

public static void main(String[] args) { 

ExecutorServi ce executor = Executors . newCachedThreadPool () ; 

// Create and launch 100 threads 
for (int i = 0; i < 100; i++) { 

executor. execute(new AddAPennyTaskO) ; 

} 

executor. shutdown() ; 

// Wait until all tasks are finished 
while (!executor.isTerminated()) { 
} 

System. out. println ("What is balance ? " + account. getBalanceO) ; 

} 

// A thread for adding a penny to the account 
public static class AddAPennyTask implements Runnable { 
public void run() { 
account . deposi t(l) ; 

} 

} 

// An inner class for account 
public static class Account { 

private static Lock lock = new ReentrantLockO ; // Create a lock 

private int balance = 0; 

public int getBalanceO { 
return balance; 

} 

public void deposit (int amount) { 
lock.lock(); // Acquire the lock 

try { 

int newBalance = balance + amount; 

// This delay is deliberately added to magnify the 
// data-corruption problem and make it easy to see. 
Thread . si eep(5) ; 

balance = newBalance; 

} 

catch (InterruptedException ex) { 
} 

finally { 
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55 lock.unlockO ; // Release the lock release the lock 

56 } 

57 } 

58 } 

59 } 

Line 33 creates a lock, line 41 acquires the lock, and line 55 releases the lock. 

W Ti P 

It is a good practice to always immediately follow a call to "lockO with a try-catch block and 
release the lock in the finally clause, as shown in lines 41-57, to ensure that the lock is always 
released. 

The example in Listing 29.7 using the synchronized method is simpler than the one in List- 
ing 29.8 using a lock. In general, using synchronized methods or statements is simpler than 
using explicit locks for mutual exclusion. However, using explicit locks is more intuitive and 
flexible to synchronize threads with conditions, as you will see in the next section. 



29. 1 1 Cooperation among Threads 

Thread synchronization suffices to avoid race conditions by ensuring the mutual exclusion of 
multiple threads in the critical region, but sometimes you also need a way for threads to coop- 
erate. Conditions can be used to facilitate communications among threads. A thread can spec- 
ify what to do under a certain condition. Conditions are objects created by invoking the 
newConditionO method on a Lock object. Once a condition is created, you can use its condition 
await O, signal (), and signal All () methods for thread communications, as shown in 
Figure 29.15. The await () method causes the current thread to wait until the condition is sig- 
naled. The signal () method wakes up one waiting thread, and the signal Al 1 () method wakes 
all waiting threads. 



«interface» 
java. util. concurrent. Condition 



+await(): void 
+signal(): void 
+signalAn(): Condition 



Causes the current thread to wait until the condition is signaled. 
Wakes up one waiting thread. 
Wakes up all waiting threads. 



Figure 29.1 5 The Condi tion interface defines the methods for performing synchronization. 



Let us use an example to demonstrate thread communications. Suppose that you create and thread cooperation example 
launch two tasks, one that deposits to an account, and one that withdraws from the same ac- 
count. The withdraw task has to wait if the amount to be withdrawn is more than the current 
balance. Whenever new funds are deposited to the account, the deposit task notifies the with- 
draw thread to resume. If the amount is still not enough for a withdrawal, the withdraw thread 
has to continue to wait for a new deposit. 

To synchronize the operations, use a lock with a condition: newDeposi t (i.e., new deposit 
added to the account). If the balance is less than the amount to be withdrawn, the withdraw 
task will wait for the newDeposi t condition. When the deposit task adds money to the ac- 
count, the task signals the waiting withdraw task to try again. The interaction between the two 
tasks is shown in Figure 29.16. 

You create a condition from a Lock object. To use a condition, you have to first obtain a 
lock. The awai t () method causes the thread to wait and automatically releases the lock on the 
condition. Once the condition is right, the thread reacquires the lock and continues executing. 
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Withdraw Task 

* 1 


Deposit Task 
i 

1 1 


lock.lockQ; 


lock.lockQ; 


1 


while (balance < withdraw/Amount) 1 
newDeposit.awaitO ; — i 


balance += depositAmount 




\ 


1 


newDeposi t . si gnal Al 1 () ; 


balance -= withdrawAmount 



t lock.unlockO ; 
lock.unlock() ; 



Figure 29. 1 6 The condition newDepos i t is used for communications between the two threads. 

Assume that the initial balance is and the amounts to deposit and withdraw are randomly 
generated. Listing 29.9 gives the program. A sample run of the program is shown in Figure 29. 17. 





jJi'iMiMilWj'iUE 




— igg* 


~r 


ic : ^boohXiftva T hi-e adConperat ion 








'[Thread] 1 


Thr*Atl 2 




Balance 




Deposit & 






& 




Withdraw 
Withdraw 


i 


i 

El 






Wait for 


a deposit 
a deposit 






Deposit 5 


Wa it f oi- 






Deposit b 






10 






Withdraw 


11 


a 






U ., , i for 


a deposit 






Depocit b 






b 




Withdraw 


b 


t 




■ 




1 







Figure 29.1 7 The withdraw task waits if there are not sufficient funds to withdraw. 



Listing 29.9 ThreadCooperation. java 

1 import java. uti 1 . concurrent .* ; 

2 import java. uti 1 . concurrent . locks .* ; 
3 

4 public class ThreadCooperation { 

5 private static Account account = new AccountO; 
6 

7 public static void main(String[] args) { 

8 // Create a thread pool with two threads 

create two threads 9 ExecutorServi ce executor = Executors . newFi xedThreadPool (2) ; 

10 executor. execute(new DepositTaskO) ; 

11 executor . execute(new Wi thdrawTaskO) ; 

12 executor. shutdown() ; 
13 

14 System. out. println ("Thread l\t\tThread 2\t\tBalance") ; 

15 } 
16 

17 // A task for adding an amount to the account 

18 public static class DepositTask implements Runnable { 

19 public void run() { 

20 try { // Purposely delay it to let the withdraw method proceed 

21 while (true) { 

22 account. deposi t((int) (Math . random() * 10) + 1); 

23 Thread. si eep(1000) ; 

24 } 

25 } 

26 catch (InterruptedException ex) { 

27 ex.printStackTrace() ; 

28 } 

29 } 



29.11 Cooperation among Threads 993 



30 } 
31 

32 // A task for subtracting an amount from the account 

33 public static class Withdraw/Task implements Runnable { 

34 public void run() { 

35 while (true) { 

36 account .wi thdraw((int) (Math . random() * 10) + 1); 

37 } 

38 } 

39 } 
40 

41 // An inner class for account 

42 private static class Account { 

43 // Create a new lock 

44 private static Lock lock = new ReentrantLockO ; createalock 

45 

46 // Create a condition 

47 private static Condition newDeposit = lock.newCondition() ; create a condition 
48 

49 private int balance = 0; 
50 

51 public int getBalance() { 

52 return balance; 

53 } 
54 

55 public void withdraw(int amount) { 

56 lock.lock(); // Acquire the lock acquire the lock 

57 try { 

58 while (balance < amount) { 

59 System. out. println("\t\t\tWait for a deposit") 

60 newDeposi t . awai t () ; wait on the condition 

61 } 
62 

63 balance -= amount; 

64 System . out . pri ntl n("\t\t\tWithdraw " + amount + 

65 "\t\t" + getBalanceO) ; 

66 } 

67 catch (InterruptedException ex) { 

68 ex.printStackTrace() ; 

69 } 

70 finally { 

71 lock.unlock() ; // Release the lock release the lock 

72 } 

73 } 
74 

75 public void deposit(int amount) { 

76 lock.lock(); // Acquire the lock acquire the lock 

77 try { 

78 balance += amount; 

79 System. out. pri ntl n ("Deposit " + amount + 

80 "\t\t\t\t\t" + getBalanceO); 
81 

82 // Signal thread waiting on the condition 

83 newDeposi t . si gnal All () ; signal threads 

84 } 

85 finally I 

86 lock.unlockO ; // Release the lock release the lock 

87 } 

88 } 

89 } 



90 } 
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The example creates a new inner class named Account to model the account with two meth- 
ods, deposit (int) and withdraw(int), a class named DepositTask to add an amount 
to the balance, a class named Wi thdrawTask to withdraw an amount from the balance, and a 
main class that creates and launches two threads. 

The program creates and submits the deposit task (line 10) and the withdraw task (line 11). 
The deposit task is purposely put to sleep (line 23) to let the withdraw task run. When there 
are not enough funds to withdraw, the withdraw task waits (line 59) for notification of the bal- 
ance change from the deposit task (line 82). 

A lock is created in line 44. A condition named newDeposi t on the lock is created in line 
47. A condition is bound to a lock. Before waiting or signaling the condition, a thread must 
first acquire the lock for the condition. The withdraw task acquires the lock in line 56, waits 
for the newDeposi t condition (line 60) when there is not a sufficient amount to withdraw, 
and releases the lock in line 70. The deposit task acquires the lock in line 75, and signals all 
waiting threads (line 82) for the newDeposi t condition after a new deposit is made. 

What will happen if you replace the while loop in lines 59-60 with the following if 
statement? 

if (balance < amount) { 

System. out. pri ntl n("\t\t\twait for a deposit"); 
newDeposi t . awai t() ; 

} 

The deposit task will notify the withdraw task whenever the balance changes, (bal ance < 
amount) may still be true when the withdraw task is awakened. Using the i f statement, the 
withdraw task may wait forever. Using the loop statement, the withdraw task will have a 
chance to recheck the condition. Thus you should always test the condition in a loop. 

tj|f Caution 

ever-waiting threads Once a thread invokes await() on a condition, the thread is put to wait for a signal to resume. 

If you forget to call signal () or signalAll () on the condition, the thread will wait forever. 

Ill Caution 

A condition is created from a Lock object. To invoke its method (e.g., await(), signal (), 
Illegal MonitorState- ar| d signalAll ()), you must first own the lock. If you invoke these methods without acquir- 

Exception ing the lock, an IllegalMonitorStateException will be thrown. 

29.1 I.I Java's Built-in Monitor 

Locks and conditions are new in Java 5. Prior to Java 5, thread communications were pro- 
grammed using the object's built-in monitors. Locks and conditions are more powerful and flex- 
ible than the built-in monitor, and in consequence, this section can be completely ignored. 
However, if you are working with legacy Java code, you may encounter Java's built-in monitor. 

A monitor is an object with mutual exclusion and synchronization capabilities. Only one 
thread at a time can execute a method in the monitor. A thread enters the monitor by acquir- 
ing a lock on it and exits by releasing the lock. Any object can be a monitor. An object be- 
comes a monitor once a thread locks it. Locking is implemented using the synchronized 
keyword on a method or a block. A thread must acquire a lock before executing a synchro- 
nized method or block. A thread can wait in a monitor if the condition is not right for it to con- 
tinue executing in the monitor. You can invoke the wait() method on the monitor object to 
release the lock so that some other thread can get in the monitor and perhaps change the mon- 
itor's state. When the condition is right, the other thread can invoke the notifyO or 
noti f yAl 1 () method to signal one or all waiting threads to regain the lock and resume exe- 
cution. The template for invoking these methods is shown in Figure 29.18. 
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Task 1 



Task 2 



synchronized (anObject) { 
try { 

// Wait for the condition to become true 
while ((condition) 
anObject.waitQ ; 



resume 



} 



// Do something when condition is true 

} 

catch (InterruptedException ex) { 
ex . pri ntStackTraceQ ; 



synchronized (anObject) { 

// When condition becomes true 
anObject . noti fy() ; or anObject. noti f yAl 1 () ; 




Figure 29. 1 8 The wai t () , noti f y () , and noti f yAl 1 () methods coordinate thread communication. 



The wait(), notifyO, and notifyAllO methods must be called in a synchro- 
nized method or a synchronized block on the receiving object of these methods. Other- 
wise, an IllegalMonitorStateException will occur. 

When wait() is invoked, it pauses the thread and simultaneously releases the lock on the 
object. When the thread is restarted after being notified, the lock is automatically reacquired. 

The wait(), notifyO, and notifyAll () methods on an object are analogous to the 
await O, signal (), and signal All () methods on a condition. 

29.12 Case Study: Producer/Consumer 

Consider the classic Consumer/Producer example. Suppose you use a buffer to store integers. 
The buffer size is limited. The buffer provides the method write(int) to add an int value 
to the buffer and the method read () to read and delete an i nt value from the buffer. To syn- 
chronize the operations, use a lock with two conditions: notEmpty (i.e., buffer is not empty) 
and notFull (i.e., buffer is not full). When a task adds an int to the buffer, if the buffer is 
full, the task will wait for the notFul 1 condition. When a task deletes an i nt from the buffer, 
if the buffer is empty, the task will wait for the notEmpty condition. The interaction between 
the two tasks is shown in Figure 29.19. 



Task for adding an i nt Task for deleting an i nt 



while (count == CAPACITY) 1 
notFull .await() ; ■ — | , 






while (count == 0) 
— notEmpty. await () ; 


.1 , 


1 


Add an n nt to the buffer 






Delete an i nt from the buffer | 


1 


1 


notEmpty. signal () ; — | 






notFul 1 . si gnal () ; 



Figure 29.19 The conditions notFul 1 and notEmpty are used to coordinate task interactions. 



Listing 29.10 presents the complete program. The program contains the Buffer class 
(lines 48-95) and two tasks for repeatedly producing and consuming numbers to and from the 
buffer (lines 16-45). The write(int) method (line 60) adds an integer to the buffer. The 
readQ method (line 77) deletes and returns an integer from the buffer. 
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create a buffer 



create two threads 



producer task 



consumer task 



The buffer is actually a first-in first-out queue (lines 50-51). The conditions notEmpty 
and notFul 1 on the lock are created in lines 57-58. The conditions are bound to a lock. A 
lock must be acquired before a condition can be applied. If you use the waitO and 
notifyC) methods to rewrite this example, you have to designate two objects as monitors. 

Listing 29.10 ConsumerProducer . java 



1 

2 
3 
4 
5 
6 
7 
8 
9 
10 
11 
12 
13 
14 
15 
16 
17 
18 
19 
20 
21 
22 
23 
24 
25 
26 
27 
28 
29 
30 
31 
32 
33 
34 
35 
36 
37 
38 
39 
40 
41 
42 
43 
44 
45 
46 
47 
48 
49 
50 
51 
52 



import java. uti 1 . concurrent . * ; 
import java.util .concurrent. locks.*; 

public class ConsumerProducer { 

private static Buffer buffer = new BufferO; 

public static void main(String[] args) { 

// Create a thread pool with two threads 

ExecutorServi ce executor = Executors . newFi xedThreadPool (2) ; 
executor . execute(new ProducerTaskO) ; 
executor. execute(new ConsumerTaskO) ; 
executor. shutdown() ; 

} 

// A task for adding an int to the buffer 
private static class ProducerTask implements Runnable { 
public void run() { 
try { 

int i=l; 
while (true) { 

System. out. println("Producer writes " + i); 
buffer. write(i++) ; // Add a value to the buffer 
// Put the thread to sleep 
Thread. si eep((int) (Math . random() * 10000)); 

} 

} catch (InterruptedExcepti on ex) { 
ex.printStackTraceQ ; 



} 

} 

// A task for reading and deleting an int from the buffer 
private static class ConsumerTask implements Runnable { 
public void run() { 
try { 

while (true) { 

System. out. println("\t\t\tConsumer reads " + buffer . read()) ; 

// Put the thread into sleep 

Thread. si eep((int) (Math . random() * 10000)); 

} 

} catch (InterruptedExcepti on ex) { 
ex.printStackTraceQ ; 



} 

} 

// An inner class for buffer 

private static class Buffer { 

private static final int CAPACITY = 1 
private java. uti 1 . Li nkedLi st<Integer> 
new java. uti 1 . Li nkedLi st<Integer>() 



// buffer 
queue = 
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53 // Create a new lock 

54 private static Lock lock = new ReentrantLockO ; createalock 

55 

56 // Create two conditions 

57 private static Condition notEmpty = lock.newConditionO ; create a condition 

58 private static Condition notFull = lock.newConditionO; create a condition 
59 

60 public void write(int value) { 

61 lock.lockO; // Acquire the lock acquire the lock 

62 try { 

63 while (queue . si ze() == CAPACITY) { 

64 System. out. pri ntl n("Wait for notFull condition"); 

65 notFul 1 . awai t() ; wait on notFull 

66 } 
67 

68 queue. offer(value) ; 

69 notEmpty. si gnal () ; // Signal notEmpty condition signal notEmpty 

70 } catch (InterruptedExcepti on ex) { 

71 ex.printStackTraceO ; 

72 } finally { 

73 lock.unlock() ; // Release the lock release the lock 

74 } 

75 } 
76 

77 public int read() { 

78 int value = 0; 

79 lock.lockO; // Acquire the lock acquire the lock 

80 try { 

81 while (queue . i sEmptyO) { 

82 System. out. pri ntl n("\t\t\tWait for notEmpty condition"); 

83 notEmpty. awai t() ; wait on notEmpty 

84 } 
85 

86 value = queue . remove() ; 

87 notFull . signal () ; // Signal notFull condition signal notFull 

88 } catch (InterruptedExcepti on ex) { 

89 ex.printStackTraceO; 

90 } finally { 

91 lock.unlockO ; // Release the lock release the lock 

92 return value; 

93 } 

94 } 



95 } 

96 } 

A sample run of the program is shown in Figure 29.20. 





_|n| 


x 


C : \book> jaua ConsumerProducer 






Producer writes 1 






Coneuner reads 1 






Producer writes 2 






Consuner reads 2 






Wait for notEmpty condit 


on 




Producer writes 3 






Consumer reads 3 






Producer writes 1 






Producer writes 5 






Wait for notFull condition 






Consumer reads H 






<\ i 







Figure 29.20 Locks and conditions are used for communications between the Producer and 
Consumer threads. 
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29.13 Blocking Queues 

blocking queue Queues and priority queues were introduced in §22.10. A blocking queue causes a thread to 

block when you try to add an element to a full queue or to remove an element from an empty 
queue. The BlockingQueue interface extends java.util .Queue and provides the syn- 
chronized put and take methods for adding an element to the head of the queue and for re- 
moving an element from the tail of the queue, as shown in Figure 29.21. 




interface» 
java. util. Collection<E> 





«interface» 
java. util. Queue<E> 




«interface» 
java. util. concurrent.BlockingQueue<E> 



+put (element: E) : void 
+take(): E 



Inserts an element to the tail of the queue. 
Waits if the queue is full. 

Retrieves and removes the head of this 
queue. Waits if the queue is empty. 



Figure 29.21 BlockingQueue is a subinterface of Queue. 



Three concrete blocking queues ArrayBlockingQueue, LinkedBlockingQueue, and 
Priori tyBlockingQueue are provided in Java, as shown in Figure 29.22. All are in the 
java.util .concurrent package. ArrayBlockingQueue implements a blocking queue 
using an array. You have to specify a capacity or an optional fairness to construct an 
Ar rayBl ocki ngQueue. Li nkedBl ocki ngQueue implements a blocking queue using a linked 
list. You may create an unbounded or bounded LinkedBlockingQueue. Priori tyBlock- 
i ngQueue is a priority queue. You may create an unbounded or bounded priority queue. 



«interface» 
java.util.concurrent.BlockingQueue<E> 



^ ^ 



ArrayBlockingQueue<E> 



+Ar rayBl ocki ngQueue (capaci ty : i nt) 

+Ar rayBl ocki ngQueue (capaci ty : i nt , 
fair: boolean) 



LinkedBlockingQueue<E> 



i-Li nkedBl ocki ngQueueO 
i-Li nkedBl ocki ngQueue (capaci ty : i nt) 



PriorityBlockingQueue<E> 



+PriorityBl ocki ngQueueO 

+Pri ori tyBl ocki ngQueue(capaci ty : i nt) 



Figure 29.22 ArrayBlockingQueue, LinkedBlockingQueue, and Priori tyBl ocki ngQueue are concrete blocking 
queues. 



unbounded queue 



Note 

You may create an unbounded LinkedBlockingQueue or Priori tyBl ocki ngQueue. For 

an unbounded queue, the put method will never block. 
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Listing 29.11 gives an example of using an ArrayBlockingQueue to simplify the Con- 
sumer/Producer example in Listing 29.10. Line 5 creates an ArrayBlockingQueue to store 
integers. The Producer thread puts an integer to the queue (line 22), and the Consumer thread 
takes an integer from the queue (line 37). 

Listing 29.1 1 ConsumerProducerUsi ngBl ocki ngQueue . java 

1 import java. util .concurrent.*; 

2 

3 public class ConsumerProducerUsi ngBl ocki ngQueue { 



4 private static ArrayBl ocki ngQueue<Integer> buffer = 

5 new ArrayBlocki ngQueue<Integer>(2) ; create a buffer 
6 

7 public static void main(String[] args) { 

8 // Create a thread pool with two threads 

9 ExecutorService executor = Executors . newFi xedThreadPool (2) ; create two threads 

10 executor. execute(new ProducerTaskO) ; 

11 executor. execute (new ConsumerTaskO) ; 

12 executor. shutdown() ; 

13 } 
14 

15 // A task for adding an int to the buffer 

16 private static class ProducerTask implements Runnable { producer task 

17 public void run() { 

18 try { 

19 int i = 1; 

20 while (true) { 

21 System. out. pri ntl n("Producer writes " + i); 

22 buffer . put(i++) ; // Add any value to the buffer, say, 1 put 

23 // Put the thread to sleep 

24 Thread. si eep((int) (Math . random() * 10000)); 

25 } 

26 } catch (InterruptedExcepti on ex) { 

27 ex.printStackTrace() ; 

28 } 

29 } 

30 } 
31 

32 // A task for reading and deleting an int from the buffer 

33 private static class ConsumerTask implements Runnable { consumertask 

34 public void run() { 

35 try { 

36 while (true) { 

37 System. out. pri ntl n("\t\t\tConsumer reads " + buffer . take() ) ; take 

38 // Put the thread to sleep 

39 Thread. si eep((int) (Math . random() * 10000)); 

40 } 

41 } catch (InterruptedExcepti on ex) { 

42 ex.printStackTrace() ; 

43 } 

44 } 

45 } 



46 } 

In Listing 29.10, you used locks and conditions to synchronize the Producer and Consumer 
threads. In this program, hand coding is not necessary, because synchronization is already im- 
plemented in ArrayBl ocki ngQueue. 
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29.14 Semaphores 

Semaphores can be used to restrict the number of threads that access a shared resource. Be- 
fore accessing the resource, a thread must acquire a permit from the semaphore. After finish- 
ing with the resource, the thread must return the permit back to the semaphore, as shown in 
Figure 29.23. 

A thread accessing a shared resource 
t 

Acquire a permit from a semaphore. semaphore . acqui re() ; 
Wait if the permit is not available. 

I 

Access the resource 



Release the permit to the semaphore semaphore. releaseQ ; | 

Figure 29.23 A limited number of threads can access a shared resource controlled by a 
semaphore. 



To create a semaphore, you have to specify the number of permits with an optional fairness 
policy, as shown in Figure 29.24. A task acquires a permit by invoking the semaphore's 
acqui re() method and releases the permit by invoking the semaphore's releaseO 
method. Once a permit is acquired, the total number of available permits in a semaphore is re- 
duced by 1, Once a permit is released, the total number of available permits in a semaphore is 
increased by 1. 

A semaphore with just one permit can be used to simulate a mutually exclusive lock. List- 
ing 29.12 revises the Account inner class in Listing 29.10 using a semaphore to ensure that 
only one thread at a time can access the deposi t method. 



Listing 29.12 New Account Inner Class 



create a semaphore 



acquire a permit 



1 
2 
3 
4 
5 
6 
7 
8 
9 
10 
11 
12 
13 
14 
15 
16 
17 
18 
19 
20 
21 



new Semaphore(l) ; 



// An inner class for account 
private static class Account { 

// Create a semaphore 

private static Semaphore semaphore 

private int balance = 0; 

public int getBalanceO { 
return balance; 

} 



public void deposit(int amount) { 
try { 

semaphore. acqui re() ; // Acquire a permit 
int newBalance = balance + amount; 

// This delay is deliberately added to magnify the 
// data-corruption problem and make it easy to see 
Thread . si eep(5) ; 

balance = newBalance; 
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22 
23 
24 
25 
26 
27 

28 } 



catch (InterruptedException ex) { 
} 

final lv I 

semaphore. releasee); // Release a permit 

} 



release a permit 



java.util.concurrent.Semaphore 



+Semaphore(numberOfPermits : int) 

+Semaphore(numberOfPermits : int, fair: 
boolean) 

+acquire(): void 
+ release(): void 



Creates a semaphore with the specified number of permits. The 
fairness policy is false. 

Creates a semaphore with the specified number of permits and 
the fairness policy. 

Acquires a permit from this semaphore. If no permit is 
available, the thread is blocked until one is available. 

Releases a permit back to the semaphore. 



Figure 29.24 The Semaphore class contains the methods for accessing a semaphore. 



A semaphore with one permit is created in line 4. A thread first acquires a permit when exe- 
cuting the deposit method in line 13. After the balance is updated, the thread releases the per- 
mit in line 25. It is a good practice to always place the releaseO method in the finally 
clause to ensure that the permit is finally released even in the case of exceptions. 
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Sometimes two or more threads need to acquire the locks on several shared objects. This 
could cause a deadlock, in which each thread has the lock on one of the objects and is waiting 
for the lock on the other object. Consider the scenario with two threads and two objects, as 
shown in Figure 29.25. Thread 1 has acquired a lock on objectl, and Thread 2 has acquired 
a lock on object2. Now Thread 1 is waiting for the lock on object2, and Thread 2 for the 
lock on objectl. Each thread waits for the other to release the lock it needs, and until that 
happens, neither can continue to run. 



deadlock 



Step 

1 

2 
3 
4 
5 
6 



Thread 1 



Thread 2 



synchronized (objectl) { 

// do something here 
synchronized (object2) { 

// do something here 



} 



} 



Wait for Thread 2 to 
release the lock on ob j ect2 



synchronized (object2) { 

// do something here 

- synchronized (objectl) { 

// do something here 

} 



Wait for Thread 1 to 
release the lock on objectl 



Figure 29.25 Thread 1 and Thread 2 are deadlocked. 



Deadlock is easily avoided by using a simple technique known as resource ordering. With resource ordering 
this technique, you assign an order to all the objects whose locks must be acquired and ensure 
that each thread acquires the locks in that order. For the example in Figure 29.25, suppose that 
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the objects are ordered as objectl and object2. Using the resource ordering technique, 
Thread 2 must acquire a lock on objectl first, then on object2. Once Thread 1 acquires a 
lock on objectl, Thread 2 has to wait for a lock on objectl. So Thread 1 will be able to ac- 
quire a lock on object2 and no deadlock will occur. 

29.16 Thread States 

Tasks are executed in threads. Threads can be in one of five states: New, Ready, Running, 
Blocked, or Finished (see Figure 29.26). 



Thread created 
• K 



start() 
New | >~ Ready 




completed 
Finished 



Wait for target I Wait for time I Wait to be 
to finish out notified 



Time out 



Signaled 



Blocked 



Figure 29.26 A thread can be in one of five states: New, Ready, Running, Blocked, or Finished. 



When a thread is newly created, it enters the New state. After a thread is started by calling 
its start () method, it enters the Ready state. A ready thread is runnable but may not be run- 
ning yet. The operating system has to allocate CPU time to it. 

When a ready thread begins executing, it enters the Running state. A running thread may 
enter the Ready state if its given CPU time expires or its yiel d() method is called. 

A thread can enter the Blocked state (i.e., become inactive) for several reasons. It may have 
invoked the join(), sleepO, or waitO method, or some other thread may have invoked 
these methods. It may be waiting for an I/O operation to finish. A blocked thread may be re- 
activated when the action inactivating it is reversed. For example, if a thread has been put to 
sleep and the sleep time has expired, the thread is reactivated and enters the Ready state. 

Finally, a thread is finished if it completes the execution of its run() method. 

The i sAl i ve() method is used to find out the state of a thread. It returns true if a thread 
is in the Ready, Blocked, or Running state; it returns f al se if a thread is new and has not 
started or if it is finished. 

The i interrupt () method interrupts a thread in the following way: If a thread is current- 
ly in the Ready or Running state, its interrupted flag is set; if a thread is currently blocked, it 
is awakened and enters the Ready state, and an j ava . 1 ang . Inter ruptedExcepti on is 
thrown. 

29.17 Synchronized Collections 

The classes in the Java Collections Framework are not thread-safe; that is, their contents may 
be corrupted if they are accessed and updated concurrently by multiple threads. You can pro- 
synchronized collection tect the data in a collection by locking the collection or by using synchronized collections. 
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The Col 1 ections class provides six static methods for wrapping a collection into a syn- 
chronized version, as shown in Figure 29.27. The collections created using these methods are 

called synchronization wrappers. synchronization wrapper 



java.util.Collections 



+synch roni zedCol 1 ecti on (c 


Collection) 


: Collection 


+synchroni zedLi st(l i st : List): List 




+synchronizedMap(m: Map): 


Map 




+synchroni zedSet(s : Set): 


Set 




+synchroni zedSortedMap(s : 


SortedMap) : 


SortedMap 


+synchroni zedSortedSet(s : 


SortedSet) : 


SortedSet 



Returns a synchronized collection. 
Returns a synchronized list from the specified list. 
Returns a synchronized map from the specified map. 
Returns a synchronized set from the specified set. 

Returns a synchronized sorted map from the specified 

sorted map. 
Returns a synchronized sorted set. 



Figure 29.27 You can obtain synchronized collections using the methods in the Col 1 ections class. 



Invoking synchronizedCollection(Collection c) returns a new Collection ob- 
ject, in which all the methods that access and update the original collection c are synchronized. 
These methods are implemented using the synchronized keyword. For example, the add 
method is implemented like this: 

public boolean add(E o) { 

synchronized (this) { return c.add(o); } 

} 

Synchronized collections can be safely accessed and modified by multiple threads concurrently. 



|§| Note 

The methods in java.util .Vector, java.util .Stack, and java.util .Hashtable 

are already synchronized. These are old classes introduced in Java. In Java, you should use 
java.util .ArrayList to replace Vector, java.util . LinkedList to replace Stack, 
and java.util .Map to replace Hashtable. If synchronization is needed, use a synchroniza- 
tion wrapper. 

The synchronization wrapper classes are thread-safe, but the iterator is fail-fast. This means that fail-fast 
if you are using an iterator to traverse a collection while the underlying collection is being modi- 
fied by another thread, then the iterator will immediately fail by throwing java.util .Concu- 
rrentModificationException, which is a subclass of RuntimeException. To avoid this 
error, you need to create a synchronized collection object and acquire a lock on the object 
when traversing it. For example, suppose you want to traverse a set; you have to write the 
code like this: 

Set hashSet = Coll ections. synch roni zedSet (new HashSetO); 

synchronized (hashSet) { // Must synchronize it 
Iterator iterator = hashSet . iteratorO ; 

while (iterator. hasNextO) { 

System . out . pri ntl n(i terator . next()) ; 

} 

} 

Failure to do so may result in nondeterministic behavior, such as ConcurrentModi f icat- 
ionException. 
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29.18 SwingWorker 

event dispatch thread As discussed in §29.6, all Swing GUI events are processed in a single event dispatch thread. 

If an event requires a long time to process, the thread cannot attend to other tasks in the queue. 
To solve this problem, you should run the time-consuming task for processing the event in a 
separate thread. Java 6 introduced SwingWorker. SwingWorker is an abstract class that im- 
plements Runnable. You can define a task class that extends SwingWorker, run the time- 
consuming task and update the GUI using the results produced from the task. Figure 29.28 
defines SwingWorker. 



«i nterface» 
java. Tang .Runnable 



javax.swing.SwingWorker<T, V> 



#doInBackground() : T 
#done(): void 

+execute(): void 
+get(): T 

+isDone(): boolean 
+cancel () : bool ean 
#publ i sh(data V...): void 



#process(data: java.util .List<V>) : void 

#setProgress(progress: int): void 
#getProgress() : void 



Performs the task and returns a result of type T. 

Executed on the event dispatch thread after doInBackground is 
finished. 

Schedules this Swi ngWorker for execution on a worker thread. 

Waits if necessary for the computation to complete, and then retrieves 
its result (i.e., the result returned doInBackground). 

Returns true if this task is completed. 

Attempts to cancel this task. 

Sends data for processing by the process method. This method is to be 
used from inside doInBackground to deliver intermediate results 
for processing on the event dispatch thread inside the process 
method. Note that V . . . denotes variant arguments. 

Receives data from the publish method asynchronously on the event 
dispatch thread. 

Sets the progress bound property. The value should be from to 100. 
Returns the progress bound property. 



Figure 29.28 The Swi ngWorker class can be used to process time-consuming tasks. 



This section demonstrates basic use of SwingWorker. The next section gives an example 
involving advanced features of SwingWorker. 
doInBackgroundO To use SwingWorker, your task class should override doInBackground O to perform a 

time-consuming task and override the done() method to update GUI components if neces- 

doneO 

sary. Listing 29.13 gives an example that lets the user specify a number and displays the num- 
ber of prime numbers less than or equal to the specified number, as shown in Figure 29.29. 



S SwlngWorkerDemo 


_ |n| x 




Using SwingWorker 

The number of prime numbers <= |l00000| is |S592| 


Without Using SwingWorker 

The number of prime numbers <- |l 00000| is |9592| 




Compute 


Compute 







Figure 29.29 You can compare the effect of using versus not using Swi ngWorker. 



29.18 SwingWorker 1005 



Listing 29. 1 3 Swi ngWo rke rDemo . j ava 

1 import javax. swing.*; 

2 import java.awt.*; 

3 import java.awt. event.*; 
4 

5 public class Swi ngWorkerDemo extends JApplet { 



6 private JButton jbtComputeWi thSwi ngworker = new J Button ("Compute") ; GUI components 

7 private JTextField jtfLimitl = new JTextFi el d(8) ; 

8 private JTextField jtfResultl = new JTextFi el d(6) ; 

9 private JButton jbtCompute = new JButton("Compute") ; 

10 private JTextField jtfLimit2 = new JTextField(8) ; 

11 private JTextField jtfResult2 = new JTextField(6) ; 
12 

13 public Swi ngWorkerDemo () { create UI 

14 JPanel panell = new JPanel(new GridLayout(2, 1)); leftpanel 

15 panel 1. setBorder (Border Facto ry. createTi tl edBorder( 

16 "Using SwingWorker")); 

17 JPanel panel 11 = new JPanelO; 

18 panelll.add(new JLabel("The number of prime numbers <= ")); 

19 panelll.add(jtfLimitl) ; 

20 panelll.add(new JLabel ("is")) ; 

21 panelll.add(jtfResultl) ; 

22 JPanel panel 12 = new JPanelO; 

23 panel 12 . add (jbtComputeWi thSwi ngWorker) ; 

24 panel 1. add (panel 11) ; 

25 panell. add(pane!12) ; 
26 

27 JPanel panel2 = new JPanel (new CridLayout(2, 1)); rightpanel 

28 panel 2 . setBorder (Border Factory. createTi tl edBorder( 

29 "Without Using SwingWorker")); 

30 JPanel panel21 = new JPanelO; 

31 panel21.add(new JLabel ("The number of prime numbers <= ")); 

32 panel21.add(jtfLimit2) ; 

33 panel21.add(new JLabel ("is")) ; 

34 panel21.add(jtfResult2) ; 

35 JPanel panel22 = new JPanelO; 

36 panel 22 . add(jbtCompute) ; 

37 panel 2 . add(panel 21) ; 

38 panel 2 . add(panel 22) ; 
39 

40 setLayout(new Gri dLayout(l , 2)); 

41 add (panell); 

42 add(pane!2); 
43 

44 jbtComputeWithSwingWorker.addActionListener(new Acti onLi stener() { addlistener 

45 public void acti onPerformed (Acti onEvent e) { 

46 new ComputePrime(Integer.parseInt(jtfLimitl.getText()) , createtask 

47 jtfResultl) .execute() ; // Execute SwingWorker createtask 

48 } 

49 }); 
50 

51 jbtCompute . addActionLi stener(new ActionLi stener() { addlistener 

52 public void actionPerformed(ActionEvent e) { 

53 int count = ComputePrime.getNumberOfPrimes( 

54 Integer . parselnt (jtf Li mi t2 . getText())) ; 

55 jtfResult2.setText(count + "") ; 

56 } 

57 }); 
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constructor 



override 

doInBac kg round () 



override doneQ 



getNumberOf Primes 



main method omitted 
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116 } 



} 

/** Task class for SwingWorker */ 

static class ComputePrime extends Swi ngWorker<Integer , Object> { 
private int limit; 

private JTextField result; // Text field in the UI 
/** Construct a runnable Task */ 

public ComputePrime(int limit, JTextField result) { 
this. limit = limit; 
this. result = result; 

} 

/** Code run on a background thread */ 
protected Integer doInBackgroundO { 
return getNumberOf Primes (limit) ; 

} 

/** Code executed after the background thread finishes */ 
protected void done() { 
try { 

result. setText(get() .toStringO) ; // Display in text field 

} 

catch (Exception ex) { 

result . setText(ex. getMessageO) ; 

} 

} 

/** Return the number of primes <= limit */ 
public static int getNumberOfPrimes(int limit) { 

int count = 0; // Count the number of prime numbers 
int number =2; //A number to be tested for primeness 

// Repeatedly find prime numbers 
while (number <= limit) { 

// Print the prime number and increase the count 

if (isPrime(number)) { 

count++; // Increase the count 

} 

// Check if the next number is prime 
number++; 



return count; 

} 

/** Check whether number is prime */ 
private static boolean isPrime(int number) { 

for (int divisor = 2; divisor <= number / 2; divisor++) { 
if (number % divisor == 0) { // If true, number is not prime 
return false; // number is not a prime 

} 

} 

return true; // number is prime 
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The UI consists of two panels. The left panel demonstrates how to compute the number of 
prime numbers using a SwingWorker. The right panel demonstrates how to compute the 
number of prime numbers without using a Swi ngWorker. You enter a number (e.g., 100000) 
in the first text field in the panel and click the Compute button to display the number of primes 
in the second text field. When you click the Compute button in the left panel, a Swi ngWorker 
task is created and executed (lines 46^-7). Since the task is run on a separate thread, you can 
continue to use the GUI. However, when you click the Compute button in the right panel, the 
GUI is frozen, because the getNumberOfPrimes method is executed on the event dispatch 
thread (lines 53-54). 

The inner class ComputePrime is a SwingWorker (line 61). It overrides the doInBack- 
ground method to run getNumberOfPrimes in a background thread (lines 72-74). It also 
overrides the done method to display the result in a text field, once the background thread fin- 
ishes (lines 77-84). 

The ComputePrime class defines the static getNumberOfPrimes method for computing 
the number of primes (lines 87-103). When you click the Compute button in the left panel, 
this method is executed on a background thread (lines 46-47). When you click the Compute 
button in the right panel, this method is executed in the event dispatch thread (lines 53-54). 



using or not using 
Swi ngWorker 



override doInBackground 



override done 



static getNumberOfPrimes 



Tip 

Two things to remember when writing Swing GUI programs: 

■ Time-consuming tasks should be run in SwingWorker. 

■ Swing components should be accessed from the event dispatch thread only. 



GUI and SwingWorker 



29.19 Displaying Progress Using JProgressBar 

In the preceding example, it may take a long time to finish the computation in the background 
thread. It is better to inform the user the progress of the computation. You can use the 
JProgressBar to display the progress. 

JProgressBar is a component that displays a value graphically within a bounded inter- 
val. A progress bar is typically used to show the percentage of completion of a lengthy opera- 
tion; it comprises a rectangular bar that is "filled in" from left to right horizontally or from 
bottom to top vertically as the operation is performed. It provides the user with feedback on 
the progress of the operation. For example, when a file is being read, it alerts the user to the 
progress of the operation, thereby keeping the user attentive. 

JProgressBar is often implemented using a thread to monitor the completion status of 
other threads. The progress bar can be displayed horizontally or vertically, as determined by 
its orientation property. The minimum, value, and maximum properties determine the 
minimum, current, and maximum lengths on the progress bar, as shown in Figure 29.30. 
Figure 29.31 lists frequently used features of JProgressBar. 

minimum value maximum 

T 



Figure 29.30 JProgressBar displays the progress of a task. 



percentCompl ete = — — 

maximum 



Listing 29.14 gives an example that lets the user specify the number of primes, say n, and 
displays the first n primes starting from 2, as shown in Figure 29.32. The program displays the 
primes in the text area and updates the completion status in a progress bar. 
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javax. swi ng . J Component 



javax.swingJProgressBar 



+DProgressBar() 

+DProgressBar(mi n : int, max: int) 

+DProgressBar(orient: int) 

+DProgressBar(orient: int, min: int, 
max: int) 

+getMaximum() : int 

+setMaximum(n : int): void 

+getMi nimum() : int 

+setMi nimum(n : int): void 

+getOrientation() : int 

+setOrientation(orient: int): void 

+getPercentCompl ete() : double 

+getValue(): int 

+setValue(n: int): void 

+getString(): String 

+setStri ng(s : String): void 

+i sStri ngPai nted() : boolean 

+setStringPainted(b: boolean): void 



Creates a horizontal progress bar with min and max 100. 

Creates a horizontal progress bar with specified min and max. 

Creates a progress bar with min and max 100 and a specified orientation. 

Creates a progress bar with a specified orientation, min, and max. 

Gets the maximum value (default: 100). 
Sets a new maximum value. 
Gets the minimum value (default: 0). 
Sets a new minimum value. 

Gets the orientation value (default: HORIZONTAL). 
Sets a new minimum value. 

Returns the percent complete for the progress bar. 

Returns the progress bar's current value. 

Sets the progress bar's current value. 

Returns the current value of the progress string. 

Sets the value of the progress string. 

Returns the value of the stri ngPai nted property. 

Sets the value of the stri ngPai nted property, which determines whether the 
progress bar should render a progress percentage string (default: false). 



Figure 29.3 1 JProgressBar is a Swing component with many properties that enable you to customize a progress bar. 



| Progress Bar Demo 



progress bar 



JProgressBar properties UI 



47% 



370 87 37067 
37273 37277 
3/4/3 3/441 
37561 37567 
37693 37699 
37699 37867 
38069 33083 



37117 
37307 
3/44/ 
37571 
37717 
37607 
38113 



Jtja4f W,i'J 
37123 37136 
3730S 37313 
37183174*] 
37573 37579 
37747 37701 
37651 37957 
31119 



371 59 371 71 
37321 37337 
37489 374B3 
375B9 37591 
377D3 3779S 
37663 37967 



37131 371 66 
37339 37357 
3/51)1 37S07 
37607 3761 S 
37011 37013 
37637 37961 



37199 37201 
37361 37363 
3/511 3/51/ 

3~?:-s >";■;: 
r::i :r;j- 

37993 37667 



37217 37223 
37366 37379 
3/529 3/53/ 
37646 37657 
37053 37061 
33011 30039 



J7U1/371M1 

37243 37253 

:";;<" na 

3/54/3/549 
37663 37691 
37071 37079 
33047 30 053 



EirtQr the prime number count 10COQ | | Displ^Pnnifr | 



Figure 29.32 The user enters the number of prime numbers and clicks the Display Prime 
button to display the primes starting from 2 to the text area. 

Listing 29.14 ProgressBarDemo . java 



1 

2 
3 
4 
5 
6 
7 
8 
9 
10 
11 
12 
13 
14 
15 
16 



import javax. swi ng . * ; 
import java.awt.*; 
import java. awt . event ; 
import java. beans .* ; 

public class ProgressBarDemo extends DApplet { 
private JProgressBar jpb = new JProgressBarO ; 
private JTextArea jtaResult = new JTextAreaO; 
private JTextField jtf Pri meCount = new JTextFi el d(8) ; 
private JButton jbtDisplayPrime = new JButton("Display Prime"); 



public ProqressBarDemoO I 
jpb . setStri ngPai nted (true) 

jpb.setValue(O) ; 
jpb.setMaximum(lOO) ; 



// Paint the percent in a string 
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17 jtaResult.setWrapStyleWord(true) ; wrapword 

18 jtaResul t . setLi neWrap(true) ; wrap line 
19 

20 J Panel panel = new JPanelO; 

21 panel . add(new J Label ("Enter the prime number count")); 

22 panel .add(jtfPrimeCount) ; 

23 panel .add(jbtDisplayPrime) ; 
24 

25 add(jpb, BorderLayout . NORTH) ; 

26 add(new DScrollPane(jtaResult) , BorderLayout . CENTER) ; 

27 add(panel, BorderLayout . SOUTH) ; 
28 

29 jbtDisplayPrime.addActionListener(new Acti onLi stener() { add button listener 

30 public void actionPerformed(ActionEvent e) { 

31 ComputePrime task = new ComputePrime( createtask 

32 Integer. parseInt(jtfPrimeCount. getTextO) , jtaResult); 
33 

34 task.addPropertyChangeListener(new PropertyChangeLi stener() { add property listener 

35 public void propertyChange(PropertyChangeEvent e) { 

36 if ("progress" . equal s(e . getPropertyName())) { 

37 jpb.setValue((Integer)e.getNewValue()) ; get property value 

38 } 

39 } 

40 }); 
41 

42 task.executeO ; // Execute SwingWorker executetask 

43 } 

44 }); 

45 } 
46 

47 /** Task class for SwingWorker */ 

48 static class ComputePrime extends Swi ngWorker<Integer , Integer> { taskclass 

49 private int count; 

50 private JTextArea result; // Textarea in the UI 
51 

52 /** Construct a runnable Task */ 

53 public ComputePrime(int count, DTextArea result) { 

54 this. count = count; 

55 this. result = result; 

56 } 
57 

58 /** Code run on a background thread */ 

59 protected Integer doInBackgroundO { override doInBackground 

60 publ i shPrimeNumbers(count) ; 
61 

62 return 0; // doInBackground must return a value 

63 } 
64 

65 /** Override process to display published prime values */ 

66 protected void process(java. uti 1 . Li st<Integer> list) { override process 

67 for (int i =0; i < list. size () ; i++) 

68 result. append(list.get(i) + " ") ; 

69 } 
70 

jl /** Publish the first n prime number */ 

72 private void publishPrimeNumbers(int n) { compute primes 

73 int count = 0; // Count the number of prime numbers 

74 int number =2; // A number to be tested for primeness 
75 
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set progress property 
publish a prime 



main method omitted 



76 

77 

78 

79 

80 

81 

82 

83 

84 

85 

86 

87 

88 

89 

90 

91 

92 

93 

94 

95 

96 

97 

98 

99 
100 
101 } 



// Repeatedly find prime numbers 
while (count <= n) { 

// Print the prime number and increase the count 

if (isPrime(number)) { 

count++: // Increase the count 

setProgress(100 * count / n) ; // Update progress 
publish(number) ; // Publish the prime number 

} 

// Check if the next number is prime 
number++ ; 

} 

} 

/** Check whether number is prime */ 
private static boolean isPrime(int number) { 

for (int divisor = 2; divisor <= number / 2; divisor++) { 
if (number % divisor == 0) { // If true, number is not prime 
return false; // number is not a prime 

} 

} 

return true; // number is prime 



override doInBackground 



override process 



The SwingWorker class generates a PropertyChangeEvent whenever the setProgress 

method is invoked. The setProgress method (line 81) sets a new progress value between 
and 100. This value is wrapped in the PropertyChangeEvent. The listener of this event can 
obtain the progress value using the getNewVal ue() method (line 37). The progress bar is 
updated using this new progress value (line 37). 

The program creates a JProgressBar (line 7) and sets its properties (lines 13-15). 

The inner class ComputePrime is a SwingWorker (line 48). It overrides the do- 
InBackground method to run pub! ishPrimeNumbers in a background thread (line 60). 
The publ ishPrimeNumbers method finds the specified number of primes starting from 2. 
When a prime is found, the setProgress method is invoked to set a new progress value (line 
81). This causes a PropertyChangeEvent to be fired, which is notified to the listener. 

When a prime is found, the publ i sh method is invoked to send the data to the process 
method (line 82). The process method is overridden (lines 66-69) to display the primes sent 
from the publ ish method. The primes are displayed in the text area (line 68). 

Key Terms 



condition 991 

deadlock 1001 

event dispatch thread 1004 

fail-fast 1003 

fairness policy 989 

lock 988 

monitor 994 



multithreading 972 
race condition 987 
synchronization wrapper 
synchronized 988 
thread 972 
thread-safe 987 



1003 



Chapter Summary 



1 . Each task is an instance of the Runnabl e interface. A thread is an object that facilitates 
the execution of a task. You can define a task class by implementing the Runnabl e in- 
terface and create a thread by wrapping a task using a Thread constructor. 



Review Questions 
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2. After a thread object is created, use the start () method to start a thread, and the 
si eep (1 ong) method to put a thread to sleep so that other threads get a chance to run. 

3. A thread object never directly invokes the run method. The JVM invokes the run 
method when it is time to execute the thread. Your class must override the run method 
to tell the system what the thread will do when it runs. 

4. To prevent threads from corrupting a shared resource, use synchronized methods or 
blocks. A synchronized method acquires a lock before it executes. In the case of an in- 
stance method, the lock is on the object for which the method was invoked. In the case 
of a static (class) method, the lock is on the class. 

5 . A synchronized statement can be used to acquire a lock on any object, not just this ob- 
ject, when executing a block of the code in a method. This block is referred to as a 
synchronized block. 

6. You can use explicit locks and conditions to facilitate communications among threads, 
as well as using the built-in monitor for objects. 

7. Deadlock occurs when two or more threads acquire locks on multiple objects and each 
has a lock on one object and is waiting for the lock on the other object. The resource 
ordering technique can be used to avoid deadlock. 

8. You can define a task class that extends Swi ngWorker, run the time-consuming task, 
and update the GUI using the results produced from the task. 

9. You can use a JProgressBar to track the progress of a thread. 

Review Questions 



Sections 29.1-29.4 



29.1 

29.2 
29.3 



Why do you need multithreading? How can multiple threads run simultaneously in 
a single-processor system? 

How do you define a task class? How do you create a thread for a task? 

What would happen if you replaced the start () method by the run() method in 
lines 14-16 in Listing 29.1? 



printlOO.startO ; 
pri ntA. startO ; 
printB.startO ; 


Replaced by 


printlOO. run() ; 
pri ntA. run() ; 
pri ntB . run() ; 





29.4 What is wrong in the following two programs? Correct the errors. 



public class Test implements Runnable { 
public static void main(String[] args) { 
new Test() ; 

} 

public TestO { 

Test task = new TestO; 
new Thread(task) . startO ; 

} 

public void run(){ 

System. out. pn'ntln("test") ; 

} 



(a) 



public class Test implements Runnable { 
public static void main(Stn'ng[] args) { 
new Test() I 

} 

public TestO { 

Thread t = new Thread(this) ; 
t. startO ; 
t. startO ; 

} 

public void run() { 

System. out. pri ntln("test") ; 



(b) 
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29.5 Which of the following methods are instance methods in java.lang. Thread? 
Which method may throw an InterruptedException? Which of them are dep- 
recated in Java? 

run, start, stop, suspend, resume, sleep, interrupt, yield, join 

29.6 If a loop contains a method that throws an InterruptedException, why should 
the loop be placed inside a try-catch block? 

29.7 How do you set a priority for a thread? What is the default priority? 
Sections 29.5-29.7 

29.8 When should you use a timer or a thread to control animation? What are the ad- 
vantages and disadvantages of using a thread and a timer? 

29.9 What is the event dispatch thread? How do you let a task run from the event dis- 
patch thread? 

Section 29.8 

29. 1 What are the benefits of using a thread pool? 

29. 1 I How do you create a thread pool with three fixed threads? How do you submit a 
task to a thread pool? How do you know that all the tasks are finished? 

Sections 29.9-29.12 

29.12 Give some examples of possible resource corruption when running multiple 
threads. How do you synchronize conflicting threads? 

29. 1 3 Suppose you place the statement in line 26 of Listing 29.7 AccountWithoutSync.java 
inside a synchronized block to avoid race conditions, as follows: 

synchronized (this) { 
account. deposit(l) ; 

} 

Does it work? 

29.14 How do you create a lock object? How do you acquire a lock and release a lock? 

29. 1 5 How do you create a condition on a lock? What are the awai t () , si gnal () , and 
signal All () methods for? 

29. 1 6 What would happen if the whil e loop in line 58 of Listing 29.9 ThreadCoopera- 
tion.java were changed to an i f statement? 



while (balance < amount) 


Replaced by 


if (balance < amount) 





29.1 7 Why does the following class have a syntax error? 

1 import javax . swi ng . * ; 
2 

3 public class Test extends JApplet implements Runnable { 

4 public void init() throws InterruptedException { 

5 Thread thread = new Thread(this) ; 

6 thread. si eep(1000) ; 

7 } 
8 

9 public synchronized void run() { 

10 } 

11 } 
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What is the possible cause for Illegal MonitorStateException? 

Can the wait(), notifyO, and notifyAllO be invoked from any object? 
What is the purpose of these methods? 

What is wrong in the following code? 

synchronized (objectl) { 
try { 

while ( ! condi ti on) object2 .wait() ; 

} 

catch (InterruptedException ex) { 
} 

} 

Section 29.13 

29.2 I What blocking queues are supported in Java? 

29.22 What method do you use to add an element to an ArrayBlockingQueue? What 
happens if the queue is full? 

29.23 What method do you use to retrieve an element from an Ar rayBl ocki ngQueue? 
What happens if the queue is empty? 

Section 29.14 

29.24 What are the similarities and differences between a lock and a semaphore? 

29.25 How do you create a semaphore that allows three concurrent threads? How do you 
acquire a semaphore? How do you release a semaphore? 

Section 29.15 

29.26 What is deadlock? How can you avoid deadlock? 
Section 29.17 

29.27 What is a synchronized collection? Is ArrayList synchronized? How do you 
make it synchronized? 

29.28 Explain why an iterator is fail-fast. 
Section 29.19 

29.29 For a JProgressBar, what is the property that displays the percentage of work 
completed? How do you set its orientation? 

Programming Exercises 

Sections 29.1-29.5 

29.1 * (Revising Listing 29.1) Rewrite Listing 29. 1 to display the output in a text area, as 
shown in Figure 29.33. 



^Exerdse29_l | T 
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Figure 29.33 The output from three threads is displayed in a text area. 
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29.2 (Racing cars) Rewrite Exercise 18.17 using a thread to control car racing. 
Compare the program with Exercise 18.17 by setting the delay time to 10 in 
both programs. Which one runs animation faster? 

29.3 (Raising flags) Rewrite Exercise 18.23 using a thread to animate flag rising. 
Compare the program with Exercise 18.23 by setting the delay time to 10 in 
both programs. Which one runs animation faster? 

Sections 29.8-29.12 

29.4 (Synchronizing threads) Write a program that launches 1000 threads. Each 
thread adds 1 to a variable sum that initially is 0. You need to pass sum by ref- 
erence to each thread. In order to pass it by reference, define an Integer 
wrapper object to hold sum. Run the program with and without synchroniza- 
tion to see its effect. 

29.5 (Running fans) Rewrite Exercise 18.11 using a thread to control fan animation. 

29.6 (Bouncing balls) Rewrite Exercise 18.19 using a thread to control car racing. 

29.7 (Controlling a group of clocks) Rewrite Exercise 18. 14 using a thread to con- 
trol clock animation. 

29.8 (Account synchronization) Rewrite Listing 29.9, ThreadCooperation.java, 
using object's wait() and notifyAll () methods. 

29.9 (Demonstrating ConcurrentModificationException) The iterator is 
fail-fast. Write a program to demonstrate it by creating two threads that con- 
currently access and modify a set. The first thread creates a hash set filled 
with numbers, and adds a new number to the set every second. The second 
thread obtains an iterator for the set and traverses the set back and forth 
through the iterator every second. You will receive a Concurrent- 
Modif neat ion Except ion because the underlying set is being modified in 
the first thread while the set in the second thread is being traversed. 

29.10* (Using synchronized sets) Using synchronization, correct the problem in the 
preceding exercise so that the second thread does not throw Concurrent- 
Modi fi cat ion Except ion. 

Section 29.15 

29. 1 I * (Demonstrating deadlock) Write a program that demonstrates deadlock. 
Section 29.18 

29.12* (Using JProgressBar) Create a program that displays an instance of 
JProgressBar and sets its value property randomly every 500 millisec- 
onds infinitely. 

Comprehensive 

29.13*** (Sorting animation) Write an animation applet for selection sort, insertion 
sort, and bubble sort, as shown in Figure 29.34. Create an array of integers 1, 
2, . . . , 50. Shuffle it randomly. Create a panel to display the array. You 
should invoke each sort method in a separate thread. 
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(a) Sorting in progress 

Selection Sort Insertion Sorl Bubble Sort 




(b) Sorted 



Figure 29.34 Three sorting algorithms are illustrated in the animation. 



29.1 4** (Copying files) Write a GUI application that copies files. A progress bar is used 
to display the progress of the copying operation, as shown in Figure 29.35(a). 



Frorft 



I Excrcisc29_15: Spit a Fic 



JSjiiJ 



IT you spJlt a Til e named te mp .txt into 3 srnal ler Jlles, trie 
three si rial lei files aieteiruj.kLI. and Lmiip.tit.S. 



Biter or choose a file: temp txt 



Specify Ihc number of smaller files: 



(a) (b) 

Figure 29.35 (a) The user enters the files in the text fields and clicks the Copy button to 
start copying files, (b) The program split a file into several smaller files. 



29.15** (Splitting a file) Modify Exercise 19.11 to display the percentage of work 
done in a progress bar, as shown in Figure 29.35(b). 

29.1 6*** (Sudoku search simulation) Modify Exercise 18.25 to display the intermedi- 
ate results of the search. As shown in Figure 29.36(a), number 2 is placed in 
the first row and last column. This number is invalid, so, the next value 3 is 
placed in Figure 29.36(b). This number is still invalid, so, the next value 4 is 
placed in Figure 29.36(c). The simulation displays all the search steps. 
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(a) (b) (c) 

Figure 29.36 The intermediate search steps are displayed in the simulation. 
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Networking 

Objectives 

■ To explain terms: TCP, IP, domain name, domain name server, stream-based communica- 
tion, and packet-based communications (§30.1). 

■ To create servers using server sockets (§30.2.1) and create clients using client sockets 
(§30.2.2). 

■ To implement Java networking programs using stream sockets (§30.2.3). 

■ To obtain Internet addresses using the InetAddress class (§30.3). 

■ To develop servers for multiple clients (§30.4). 

■ To develop applets that communicate with the 
server (§30.5). 

■ To send and receive objects on a network (§30.6). 

■ To create applications or applets to retrieve files 
from a network (§30.7). 

■ To render HTML files using the JEdi torPane 

class (§30.8). 
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30.1 Introduction 

To browse the Web or send email, your computer must be connected to the Internet. The In- 
ternet is the global network of millions of computers. Your computer may connect to the In- 
ternet through an Internet Service Provider (ISP) using dialup, DSL, or cable modem, or 
through a local area network (LAN). 

When a computer needs to communicate with another computer, it needs to know the 
other computer's address. An Internet Protocol (IP) address uniquely identifies the comput- 
er on the Internet. An IP address consists of four dotted decimal numbers between and 
255, such as 130.254. 204 . 36. Since it is not easy to remember so many numbers, they are 
often mapped to meaningful names called domain names, such as drake . armstrong . edu. 
Special servers called Domain Name Servers (DNS) on the Internet translate host names into 
IP addresses. When a computer contacts drake.armstrong.edu, it first asks the DNS to 
translate this domain name into a numeric IP address and then sends the request using the IP 
address. 

The Internet Protocol is a low-level protocol for delivering data from one computer to an- 
other across the Internet in packets. Two higher-level protocols used in conjunction with the 
IP are the Transmission Control Protocol (TCP) and the User Datagram Protocol (UDP). 
TCP enables two hosts to establish a connection and exchange streams of data. TCP guaran- 
tees delivery of data and also guarantees that packets will be delivered in the same order in 
which they were sent. UDP is a standard, low-overhead, connectionless, host-to-host protocol 
that is used over the IP. UDP allows an application program on one computer to send a data- 
gram to an application program on another computer. 

Java supports both stream-based and packet-based communications. Stream-based 
communications use TCP (Transmission Control Protocol) for data transmission, where- 
as packet-based communications use UDP (User Datagram Protocol). Since TCP can de- 
tect lost transmissions and resubmit them, transmissions are lossless and reliable. UDP, 
in contrast, cannot guarantee lossless transmission. Stream-based communications are 
used in most areas of Java programming and are the focus of this chapter. Packet-based 
communications are introduced in Supplement III.T, "Networking Using Datagram 
Protocol." 

30.2 Client/Server Computing 

Networking is tightly integrated in Java. Java API provides the classes for creating sockets to 
socket facilitate program communications over the Internet. Sockets are the endpoints of logical con- 

nections between two hosts and can be used to send and receive data. Java treats socket com- 
munications much as it treats I/O operations; thus programs can read from or write to sockets 
as easily as they can read from or write to files. 

Network programming usually involves a server and one or more clients. The client sends 
requests to the server, and the server responds. The client begins by attempting to establish a 
connection to the server. The server can accept or deny the connection. Once a connection is 
established, the client and the server communicate through sockets. 

The server must be running when a client attempts to connect to the server. The server 
waits for a connection request from a client. The statements needed to create sockets on a 
server and a client are shown in Figure 30. 1 . 

30.2.1 Server Sockets 

To establish a server, you need to create a server socket and attach it to a port, which is where 
the server listens for connections. The port identifies the TCP service on the socket. Port num- 
bers range from to 65536, but port numbers to 1024 are reserved for privileged services. 
For instance, the email server runs on port 25, and the Web server usually runs on port 80. 



IP address 

domain name 
domain name server 

TCP 

stream-based 
packet-based 
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Server Host 



Step 1: Create a server socket on a port, e.g., 
8000, using the following statement: 

ServerSocket serverSocket = new 
ServerSocket(8000) ; 

Step 2: Create a socket to connect to a client, 
using the following statement: 



Socket socket = 

serverSocket. accept() ; 



Network 



I/O Stream 



Client Host 



Step 3: A client program uses the following 
statement to connect to the server: 



Socket socket = new 

Socket(serverHost, 8000); 



Figure 30.1 The server creates a server socket and, once a connection to a client is established, 
connects to the client with a client socket. 



You can choose any port number that is not currently used by any other process. The follow- 
ing statement creates a server socket serverSocket: 

ServerSocket serverSocket = new ServerSocket(port) ; serversocket 
§ Note 

Attempting to create a server socket on a port already in use would cause the 

j ava . net . Bi ndExcept i on. Bi ndExcept i on 

30.2.2 Client Sockets 

After a server socket is created, the server can use the following statement to listen for con- 
nections: 

Socket socket = serverSocket . acceptO ; 

This statement waits until a client connects to the server socket. The client issues the follow- 
ing statement to request a connection to a server: 

Socket socket = new Socket QserverName, port) ; 

This statement opens a socket so that the client program can communicate with the server. 
serverName is the server's Internet host name or IP address. The following statement creates 
a socket at port 8000 on the client machine to connect to the host 130.254.204.36: 

Socket socket = new Socket("130. 254. 204. 36" , 8000) 

Alternatively, you can use the domain name to create a socket, as follows: 

Socket socket = new Socket ("drake. armstrong.edu", 8000); 

When you create a socket with a host name, the JVM asks the DNS to translate the host name 
into the IP address. 

# Note 

A program can use the host name local host or the IP address 127.0.0.1 to refer to the localhost 
machine on which a client is running. 

§ Note 

The Socket constructor throws a java.net.UnknownHostException if the host cannot UnknownHostException 

be found. 



connect to client 



client socket 



use IP address 



use domain name 



1020 Chapter 30 Networking 



30.2.3 Data Transmission through Sockets 

After the server accepts the connection, communication between server and client is conduct- 
ed the same as for I/O streams. The statements needed to create the streams and to exchange 
data between them are shown in Figure 30.2. 



int port = 8000; 
DatalnputStream in; 
DataOutputStream out; 
ServerSocket server; 
Socket socket; 

server = new ServerSocket(port) ; 
socket = server .accept () ; -< 
in = new DatalnputStream 

(socket . getlnputStreamO) ; 
out = new DataOutStream 

(socket . getOutputStreamO) ; 
System. out. print! n (in. readDoubleO) ; 
out .writeDouble(aNumber) ; 



Connection 
Request 



I/O 
Streams 



int port = 8000; 
String host = "localhost" 
DatalnputStream in; 
DataOutputStream out; 
Socket socket; 



socket = new Socket (host, port); 

in = new DatalnputStream 
(socket. getlnputStreamO) ; 

out = new DataOutputStream 
(socket . getOutputStreamO) ; 

out.writeDouble(aNumber) ; 

System, out .print! n (in. readDoubleO) ; 



Figure 30.2 The server and client exchange data through I/O streams on top of the socket. 



To get an input stream and an output stream, use the getlnputStreamO and 
getOutputStreamO methods on a socket object. For example, the following statements 
create an InputStream stream called input and an OutputStream stream called output 
from a socket: 

InputStream input = socket . getlnputStreamO ; 
OutputStream output = socket . getOutputStreamO ; 

The InputStream and OutputStream streams are used to read or write bytes. You can use 
DatalnputStream, DataOutputStream, Buf feredReader, and PrintWriter to wrap 
on the InputStream and OutputStream to read or write data, such as int, double, or 
String. The following statements, for instance, create a DatalnputStream stream, i nput, 
and a DataOutput stream, output, to read and write primitive data values: 

DatalnputStream input = new DatalnputStream 

(socket . getlnputStreamO) ; 
DataOutputStream output = new DataOutputStream 

(socket. getOutputStreamO) ; 

The server can use input . readDoubl e() to receive a double value from the client, and 
output. writeDouble(d) to send double value d to the client. 

Tip 

Recall that binary I/O is more efficient than text I/O because text I/O requires encoding and 
decoding. Therefore it is better to use binary I/O for transmitting data between a server and a 
client to improve performance. 




30.2.3 A Client/Server Example 

This example presents a client program and a server program. The client sends data to a server. 
The server receives the data, uses it to produce a result, and then sends the result back to the 
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client. The client displays the result on the console. In this example, the data sent from the 
client comprise the radius of a circle, and the result produced by the server is the area of the 
circle (see Figure 30.3). 

compute area 

r radius 

Server I > Client 
' area 1 

Figure 30.3 The client sends the radius to the server; the server computes the area and 
sends it to the client. 



The client sends the radius through a DataOutputStream on the output stream socket, 
and the server receives the radius through the DatalnputStream on the input stream socket, 
as shown in Figure 30.4(a). The server computes the area and sends it to the client through a 
DataOutputStream on the output stream socket, and the client receives the area through a 
DatalnputStream on the input stream socket, as shown in Figure 30.4(b). The server and 
client programs are given in Listings 30.1 and 30.2. Figure 30.5 contains a sample run of the 
server and the client. 
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socket 



Network 



(b) 



Figure 30.4 (a) The client sends the radius to the server, (b) The server sends the area to the client. 



Server started at Mori Dec 08 09:02:22 EST 201 
Radius received from client: 2.3 
Area round: 1 6.61 90251 37490002 
Radius received from client: 3430.0 
Area found: 3.696052341 021 856E7 
Radius received from client: 34.5 
Area found: 3739.2S0655935251 



in 



Enter radius 



34.5 



Radius is 2.3 

Area received from the server is 1 6.61 90251 37490002 
Radius is 3430.0 

Area received from the server is 3.696052341 021 856E7 
Radius is 34.5 

Area received from the server is 3739.230655935251 l== 



Figure 30.5 The client sends the radius to the server. The server receives it, computes the 
area, and sends the area to the client. 



Listing 30.1 Server, java 

1 i mport j ava . i o . * ; 

2 import java.net.'-; 

3 import java.util .* ; 

4 import java.awt.*; 

5 import javax. swing.*; 
6 
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launch server 



server socket 

connect client 

input from client 
output to client 

read radius 



7 
8 
9 
10 
11 
12 
13 
14 
15 
16 
17 
18 
19 
20 
21 
22 
23 
24 
25 
26 
27 
28 
29 
30 
31 
32 
33 
34 
35 
36 
37 
38 
39 
40 
41 
42 
43 
44 
45 
46 
47 
48 
49 
50 
51 
52 
53 
54 
55 
56 
57 



public class Server extends JFrame { 

// Text area for displaying contents 
private JTextArea jta = new JTextAreaO ; 

public static void main(String[] args) { 
new Serve r () ; 

} 

public ServerO { 

// Place text area on the frame 

setLayout(new BorderLayoutO) ; 

add(new JScroll Pane(jta) , BorderLayout . CENTER) ; 

setTitle("Server") ; 
setSize(500, 300); 

setDef aul tCl oseOpe rati on (J Frame . EXIT_0N_CL0SE) ; 

setVi si bl e(true) ; // It is necessary to show the frame here! 

try { 

// Create a server socket 

ServerSocket serverSocket = new ServerSocket(8000) ; 
jta.append("Server started at " + new Date() + '\n'); 

// Listen for a connection request 
Socket socket = serverSocket . acceptO ; 

// Create data input and output streams 
DatalnputStream i nputFromCl i ent = new DataInputStream( 

socket. getlnputStreamO) ; 
DataOutputStream outputToCl i ent = new Data0utputStream( 

socket . getOutputStreamO) ; 

while (true) { 

// Receive radius from the client 

double radius = i nputFromCl i ent . readDoubl e() ; 



// Compute area 
double area = radius 



radius * Math. PI; 



// Send area back to the client 
outputToCl i ent .wri teDoubl e(area) ; 

jta. append("Radius received from client: ' 
jta. append ("Area found: " + area + '\n'); 

} 

} 

catch(I0Exception ex) { 
System. err. println(ex) ; 

} 



+ radius + '\n'); 



Listing 30.2 Client.java 

1 import java.io.*; 

2 import java.net.'-; 

3 import java.awt.*; 

4 import java.awt. event.*; 

5 import javax. swing.*; 
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6 

7 public class Client extends J Frame { 

8 // Text field for receiving radius 

9 private JTextField jtf = new JTextFieldO ; 
10 

11 // Text area to display contents 

12 private JTextArea jta = new JTextAreaO ; 
13 

14 // 10 streams 

15 private DataOutputStream toServer; 

16 private DatalnputStream fromServer; 
17 

18 public static void main(String[] args) { 

19 new ClientO; launch client 

20 } 
21 

22 public ClientO { 

23 // Panel p to hold the label and text field 

24 1 Panel p = new JPanelO; 

25 p . setLayout(new BorderLayoutO) ; 

26 p.add(new JLabel ("Enter radius"), BorderLayout .WEST) ; 

27 p.add(jtf, BorderLayout . CENTER) ; 

28 jtf . setHori zontal Al i gnment (ITextFi el d . RIGHT) ; 



29 
30 
31 
32 
33 
34 
35 
36 
37 
38 
39 
40 
41 
42 
43 
44 
45 
46 
47 
48 
49 
50 
51 
52 
53 
54 
55 
56 
57 
58 
59 
60 
61 
62 
63 
64 



private class TextFi el dLi stener implements Acti onLi stener { 
public void acti onPerformed(Acti onEvent e) { 
try { 

// Get the radius from the text field 

double radius = Double. parseDouble(jtf .getTextQ .trimO) ; 



} 



} 

catch (IOException ex) { 



try { 

// Create a socket to connect to the server 
Socket socket = new Socket("local host" , 8000); 

// Socket socket = new Socket ("130 . 254 . 204 . 36" , 8000); 

// Socket socket = new Socket("drake .Armstrong . edu" , 8000); 



setLayout(new BorderLayoutO); 
add(p, BorderLayout. NORTH) ; 

add(new IScroll Pane(jta) , BorderLayout . CENTER) ; 



jtf . addActi on Li stener (new TextFi el dLi stener () ) ; 



setTitle("Client") ; 
setSize(500, 300); 

setDef aul tCl oseOpe rati on (1 Frame . EXIT_0N_CL0SE) ; 

setVi si bl e(true) ; // It is necessary to show the frame here! 



jta.append(ex.toString() + '\n'); 

} 



// Create an input stream to receive data from the server 
fromServer = new DataInputStream( 
socket. getlnputStreamQ) ; 



// Create an output stream to send data to the server 
toServer = 

new DataOutputStream(socket.getOutputStreamO) ; 



input from server 



register listener 



request connection 



output to server 
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read radius 



write radius 



65 
66 
67 
68 
69 
70 
71 
72 
73 



// Get area from the server 

double area = fromSe rver . readDoubl e() ; 



// Send the radius to the server 
toServer .wri teDoubl e(radi us) ; 
toServer.flushQ ; 



// Display to the text area 

jta. append("Radius is " + radius + "\n") ; 

jta. append("Area received from the server is 



74 
75 
76 
77 
78 
79 
80 
81 
82 

83 } 



} 



} 



} 

catch (IOException ex) { 



System. err. println(ex) ; 

} 



+ area + '\n') ; 



■I 



You start the server program first, then start the client program. In the client program, enter a 
radius in the text field and press Enter to send the radius to the server. The server computes 
the area and sends it back to the client. This process is repeated until one of the two programs 



The networking classes are in the package java . net. This should be imported when writ- 
ing Java network programs. 

The Server class creates a ServerSocket serverSocket and attaches it to port 8000, 
using this statement (line 27 in Server.java): 

ServerSocket serverSocket = new ServerSocket(8000) ; 

The server then starts to listen for connection requests, using the following statement (line 3 1 
in Server.java): 

Socket socket = serverSocket . accept() ; 

The server waits until a client requests a connection. After it is connected, the server reads the 
radius from the client through an input stream, computes the area, and sends the result to the 
client through an output stream. 

The CI ient class uses the following statement to create a socket that will request a con- 
nection to the server on the same machine (localhost) at port 8000 (line 43 in Client.java). 

Socket socket = new Socket("localhost", 8000); 

If you run the server and the client on different machines, replace 1 ocal host with the server 
machine's host name or IP address. In this example, the server and the client are running on 
the same machine. 

If the server is not running, the client program terminates with a 
java.net.ConnectException. After it is connected, the client gets input and output 
streams — wrapped by data input and output streams — in order to receive and send data to the 
server. 

If you receive a java . net . Bi ndException when you start the server, the server port is 
currently in use. You need to terminate the process that is using the server port and then restart 
the server. 

What happens if the setVi sibl e(true) statement in line 23 in Server.java is moved 
after the try-catch block in line 56 in Server.java? The frame will not be displayed, because 
the whil e loop in the try-catch block will not finish until the program terminates. 



terminates. 
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Note 

When you create a server socket, you have to specify a port (e.g., 8000) for the socket. When a client socket port 

client connects to the server (line 43 in Client.java), a socket is created on the client. This socket 
has its own local port. This port number (e.g., 2047) is automatically chosen by the JVM, as 
shown in Figure 30.6. 



port number 



Server 







1 




socket 8000- 








Figure 30.6 The JVM automatically chooses an available port to create a socket for the 
client. 



To see the local port on the client, insert the following statement in line 46 in Client.java. 
System. out. println ("local port: " + socket . getLocal PortO ) ; 



30.3 The InetAddress Class 

Occasionally, you would like to know who is connecting to the server. You can use the 
InetAddress class to find the client's host name and IP address. The InetAddress class 
models an IP address. You can use the statement shown below in the server program to get an 
instance of InetAddress on a socket that connects to the client. 

InetAddress "inetAddress = socket. getlnetAddressO ; 

Next, you can display the client's host name and IP address, as follows: 

System. out. print~ln("Client's host name is " + 

i netAddress . getHostNameO) ; 
System. out. print~ln("Client's IP Address is " + 

inetAddress .getHostAddressO) ; 

You can also create an instance of InetAddress from a host name or IP address using the 
static getByName method. For example, the following statement creates an InetAddress 
for the host 1 i ang . armstrong . edu. 

InetAddress address = InetAddress.getByName("liang.armstrong.edu"); 

Listing 30.3 gives a program that identifies the host name and IP address of the arguments you 
pass in from the command line. Line 7 creates an InetAddress using the getByName 
method. Lines 8-9 use the getHostName and getHostAddress methods to get the host 
name and IP address. Figure 30.7 shows a sample run of the program. 

Listing 30.3 IdentifyHostNamelP. java 

1 import java.net.*; 
2 

3 public class IdentifyHostNamelP { 

4 public static void main(String[] args) { 
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5 for (int i = 0; i < args. length; i++) { 

6 try { 

get an InetAddress 7 InetAddress address = InetAddress . getByName(args [i ] ) ; 

gethostname 8 System . out . pri nt ("Host name: " + address . getHostName() + ""); 

gethostIP 9 System. out. println("IP address: " + address .getHostAddressO) : 

10 } 

11 catch (UnknownHostException ex) { 

12 System. err. pri ntl n ("Unknown host or IP address " + args[i]); 

13 } 

14 } 

15 } 

16 } 



:\book>jaua I dent if yHostNamelP uuu. white house .go u 130.254.204.34 Z| 
lost name: Mwu.uhitenouse .gou IP address: 96 .7.106 .135 
lost name: panda.Arnstr0n9.EDU IP address: 130.254.204.34 

:\book> 



Figure 30.7 The program identifies host names and IP addresses. 



30.4 Serving Multiple Clients 

Multiple clients are quite often connected to a single server at the same time. Typically, a 
server runs continuously on a server computer, and clients from all over the Internet can con- 
nect to it. You can use threads to handle the server's multiple clients simultaneously. Simply 
create a thread for each connection. Here is how the server handles the establishment of a 
connection: 

while (true) { 

Socket socket = serverSocket . accept() ; // Connect to a client 
Thread thread = new ThreadClass(socket) ; 
thread . startO ; 

} 

The server socket can have many connections. Each iteration of the whil e loop creates a new 
connection. Whenever a connection is established, a new thread is created to handle commu- 
nication between the server and the new client; and this allows multiple connections to run at 
the same time. 

Listing 30.4 creates a server class that serves multiple clients simultaneously. For each 
connection, the server starts a new thread. This thread continuously receives input (the radius 
of a circle) from clients and sends the results (the area of the circle) back to them (see 
Figure 30.8). The client program is the same as in Listing 30.2. A sample run of the server 
with two clients is shown in Figure 30.9. 

Listing 30.4 MultiThreadServer. java 

1 i mport j ava . i o . * ; 

2 import java.net.'-; 

3 import java.util ; 

4 import java.awt.*; 

5 import javax. swing.*; 
6 

7 public class MultiThreadServer extends JFrame { 

8 // Text area for displaying contents 
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9 private JTextArea jta = new JTextAreaO ; 
10 

11 public static void main(String[] args) { 

12 new MultiThreadServerO ; 

13 } 
14 

15 public MultiThreadServerO { 

16 // Place text area on the frame 

17 setLayout(new BorderLayoutO) ; 

18 add(new JScroll Pane(jta) , BorderLayout . CENTER) ; 
19 

20 setTitle("MultiThreadServer") ; 

21 setSize(500, 300); 

22 setDef aul tCl oseOpe rati on (1 Frame . EXIT_0N_CL0SE) ; 

23 setVi si bl e(true) ; // It is necessary to show the frame here! 
24 

25 try { 

26 // Create a server socket 

27 ServerSocket serverSocket = new ServerSocket(8000) ; serversocket 

28 jta.append("MultiThreadServer started at " + new DateO + '\n'); 
29 

30 // Number a client 

31 int clientNo = 1; 
32 

33 while (true) { 

34 // Listen for a new connection request 

35 Socket socket = serverSocket . acceptO ; connect client 
36 

37 // Display the client number 

38 jta. append("Starting thread for client " + clientNo + 

39 " at " + new Date() + '\n'); 
40 

41 // Find the client's host name, and IP address 

42 InetAddress inetAddress = socket. getlnetAddressO ; network information 

43 jta. append("Cl ient " + clientNo + "'s host name is " 

44 + inetAddress. getHostName() + "\n") ; 

45 jta. append("Cl ient " + clientNo + "'s'lP Address is " 

46 + inetAddress. getHostAddress () + "\n") ; 
47 

48 // Create a new thread for the connection 

49 Handl eACl i ent task = new Handl eACl i ent(socket) ; create task 
50 

51 // Start the new thread 

52 new Thread(task) . start() ; startthread 
53 

54 // Increment clientNo 

55 clientNo++; 

56 } 

57 } 

58 catch(I0Exception ex) { 

59 System. err. println(ex) ; 

60 } 

61 } 
62 

63 // Inner class 

64 // Define the thread class for handling new connection 

65 class Handl eACl i ent implements Runnable { task class 

66 private Socket socket; // A connected socket 
67 

68 /** Construct a thread */ 
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69 


it" ii _i ~i * / — i" i ■ i ._ "\ r 

public Hand! eACl i ent(Socket socket) { 




70 


this. socket = socket; 




/ 1 


} 




72 






73 


/** Run a thread */ 




74 


public void run() { 




75 


try { 




76 


// Create data input and output streams 


I/O 


77 


DatalnputStream i nputFromCl i ent = new DataInputStream( 




78 


socket . getlnputStreamO) ; 




79 


DataOutputStream outputToCl i ent = new Data0utputStream( 




80 


socket. getOutputStreamO) ; 




81 






82 


// Continuously serve the client 




83 


while (true) { 




84 


// Receive radius from the client 




85 


double radius = i nputFromCl i ent . readDoubl e() ; 




86 






O 1 

87 


// Compute area 




88 


■ | -I | ■ ■ 1 ■ i ft a .1 i—. -w- 

double area = radius •• radius •• Math. PI; 




89 






90 


// Send area back to the client 




91 


outputToCl i ent . wri teDoubl e(area) ; 




92 





93 jta. append("radius received from client: " + 

94 radius + '\n') ; 

95 jta. append ("Area found: " + area + '\n'); 

96 } 

97 } 

98 catch(I0Exception e) { 

99 System. err. println(e) ; 

100 } 

101 } 

102 } 

103 } 

The server creates a server socket at port 8000 (line 27) and waits for a connection (line 35). 
When a connection with a client is established, the server creates a new thread to handle the 
communication (line 49). It then waits for another connection in an infinite whil e loop (lines 
33-56). 

The threads, which run independently of one another, communicate with designated 
clients. Each thread creates data input and output streams that receive and send data to a 
client. 



A socket for a 
client 




Server 

A server socket 
on a port 

i r 




A socket for a 
client 



Client 1 



Client n 



Figure 30.8 Multithreading enables a server to handle multiple independent clients. 
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MultiThreadServer started atThu Aug 06 09:22:09 EDT2009 
Starting thread for client 1 atThu Aug 06 09:22:26 EDT2009 
Client 1 s hostname is 127.0.0.1 
Client Vs IP Address is 127.0.0.1 
radius received from client: 4.5 
Area found: 63.61725123519331 

Starting thread for clients atThu Aug 06 09:22:48 EDT2009 
Client2s hostname is 127.0.0.1 
Client 2's IP Address is 127.0.0.1 
radius received from client: 5.4 
Area found: 91.60804177867838 



Radius is 4.5 

Area received from the server is 63.61725123519331 



Radius is 5.4 

Area received from the server is 91.60884177867838 



Figure 30.9 The server spawns a thread in order to serve a client. 



30.5 Applet Clients 

Because of security constraints, applets can connect only to the host from which they were 
loaded. Therefore, the HTML file must be located on the machine on which the server is run- 
ning. You can obtain the server's host name by invoking getCodeBaseO . getHostO on an 
applet, so you can write the applet without the host name fixed. Below is an example of how 
to use an applet to connect to a server. 

The applet shows the number of visits made to a Web page. The count should be stored 
in a file on the server side. Every time the page is visited or reloaded, the applet sends a re- 
quest to the server, and the server increases the count and sends it to the applet. The applet 
then displays the new count in a message, such as You are visitor number 11, as shown in 
Figure 30.10. The server and client programs are given in Listings 30.5 and 30.6. 



t£ Applet Viewer: AppletClient.cl 



Applet 

You are visitor number 1 1 

Applet started. 



Figure 30.10 The applet displays the access count on a Web page. 



Listing 30.5 CountServer. java 



6 
7 
8 
9 
10 
11 
12 
13 
14 
15 
16 
17 
18 
19 
20 



1 import java.io.*; 

2 import java.net.'-; 
3 

4 public class CountServer { 

5 private RandomAccessFi 1 e raf; 
private int count; // Count the access to the server 



public static void main(String[] args) { 
new CountServerO ; 

} 

public CountServerO { 
try { 

// Create a server socket 

ServerSocket serverSocket = new ServerSocket(8000) ; 
System. out . pri ntl n("Server started ") ; 

// Create or open the count file 

raf = new RandomAccessFileCcount.dat", "rw"); 



launch server 



server socket 



random access file 



1030 Chapter 30 Networking 



21 
22 
23 
24 
25 
26 
27 
28 
29 
30 
31 
32 
33 
34 
35 
36 
37 
38 
39 
40 
41 
42 
43 
44 
45 
46 
47 

48 } 



// Get the count 

if (raf.lengthQ == 0) 



new file 



count = 0; 
el se 



get count 



count = raf . readlnt() ; 



connect client 



while (true) { 

// Listen for a new connection request 
Socket socket = serverSocket . acceptQ ; 



send to client 



// Create a DataOutputStream for the socket 
DataOutputStream outputToCl i ent = 

new DataOutputStream(socket . getOutputStreamQ) ; 



update count 



// Increase count and send the count to the client 
count++; 

outputToCl i ent .wri telnt (count) ; 



// Write new count back to the file 

raf . seek(0) ; 

raf .writelnt(count) ; 



} 

} 

catch(I0Exception ex) { 



ex . pri ntStackTrace() ; 

} 



} 



The server creates a ServerSocket in line 15 and creates or opens a file using 
RandomAccessFile in line 19. It reads the count from the file in lines 22-31. The server 
then waits for a connection request from a client (line 29). After a connection with a client is 
established, the server creates an output stream to the client (lines 32-33), increases the count 
(line 36), sends the count to the client (line 37), and writes the new count back to the file. This 
process continues in an infinite while loop to handle all clients. 

Listing 30.6 AppletClient. java 

1 import java.io.*; 

2 import java. net.*; 

3 import javax. swing.*; 
4 

5 public class AppletClient extends 1 Applet { 

6 // Label for displaying the visit count 

7 private J Label jlbl Count = new JLabelO; 
8 

9 // Indicate if it runs as application 
10 private boolean isStandAlone = false; 
11 

12 // Host name or ip 

13 private String host = "local host"; 
14 

15 /** Initialize the applet */ 

16 public void init() { 

17 add (jlbl Count) ; 
18 

19 try { 

20 // Create a socket to connect to the server 

21 Socket socket; 

22 if (isStandAlone) 
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23 socket = new Socket(host, 8000); for standalone 

24 else 

2 5 socket = new Socket (getCodeBase (). getHostO , 8000); for applet 

26 

27 // Create an input stream to receive data from the server 

28 DatalnputStream i nputFromServer = 

29 new DataInputStream(socket . getlnputStreamO) ; 
30 

31 // Receive the count from the server and display it on label 

32 int count = i nputFromServer . readlntO ; receive count 

33 jlblCount.setText("You are visitor number " + count); 
34 

35 // Close the stream 

36 inputFromServer.closeO ; 

37 } 

38 catch (IOException ex) { 

39 ex . pri ntStackTrace() ; 

40 } 

41 } 
42 

43 /** Run the applet as an application */ 

44 public static void main(String[] args) { 

45 // Create a frame 

46 JFrame frame = new J Frame ("Applet Client"); 

47 

48 // Create an instance of the applet 

49 AppletClient applet = new Appl etCl i ent() ; 

50 appl et.isStandAl one = true; 
51 

52 // Get host 

53 if (args. length == 1) applet. host = args[0]; 
54 

55 // Add the applet instance to the frame 

56 frame . getContentPane() .add(applet, java.awt.BorderLayout. CENTER) ; 
57 

58 // Invoke init() and start() 

59 applet.init() ; 

60 applet. start() ; 
61 

62 // Display the frame 

63 frame . pack() ; 

64 frame.setVisible(true) ; 

65 } 



66 } 

The client is an applet. When it runs as an applet, it uses getCodeBase () . getHost () (line 
25) to return the IP address for the server. When it runs as an application, it passes the URL 
from the command line (line 53). If the URL is not passed from the command line, by default 
"localhost" is used for the URL (line 13). 

The client creates a socket to connect to the server (lines 21-25), creates an input stream 
from the socket (lines 28-29), receives the count from the server (line 32), and displays it in 
the text field (line 33). 

30.6 Sending and Receiving Objects 

In the preceding examples, you learned how to send and receive data of primitive types. You 
can also send and receive objects using ObjectOutputStream and ObjectlnputStream 
on socket streams. To enable passing, the objects must be serializable. The following example 
demonstrates how to send and receive objects. 
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The example consists of three classes: StudentAddress.java (Listing 30.7), 
StudentClient.java (Listing 30.8), and StudentServer.java (Listing 30.9). The client program 
collects student information from a client and sends it to a server, as shown in Figure 30.11. 

The StudentAddress class contains the student information: name, street, state, and zip. 
The StudentAddress class implements the Serial izable interface. Therefore, it can be 
sent and received using the object output and input streams. 



1^-., Register Student Client 








-ln| x| 














Name 


John Smith 


Street 


100 Main Street 


City 


Savannah 


State 


GA 


Zip 


31411 


Register to the Server 



Figure 30.1 1 The client sends the student information in an object to the server. 

Listing 30.7 StudentAddress.java 

serialized 1 public class StudentAddress implements java.io.Serializable { 

2 private String name; 

3 private String street; 

4 private String city; 

5 private String state; 

6 private String zip; 
7 

8 public StudentAddress(String name, String street, String city, 

9 String state, String zip) { 

10 this. name = name; 

11 this. street = street; 

12 this. city = city; 

13 this. state = state; 

14 this. zip = zip; 

15 } 
16 

17 public String getNameO { 

18 return name; 

19 } 
20 

21 public String getStreetO { 

22 return street; 

23 } 
24 

25 public String getCityO { 

26 return city; 

27 } 
28 

29 public String getStateO { 

30 return state; 

31 } 
32 

33 public String getZipO { 

34 return zip; 

35 } 

36 } 

The client sends a StudentAddress object through an ObjectOutputStream on the output 
stream socket, and the server receives the Student object through the ObjectlnputStream 
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on the input stream socket, as shown in Figure 30.12. The client uses the writeObject 
method in the ObjectOutputStream class to send a student to the server, and the server re- 
ceives the student using the readObject method in the ObjectlnputStream class. The 
server and client programs are given in Listings 30.8 and 30.9. 
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student object 
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student object 


i n . readObjectO 




out.writeObject(Object) | 
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in: ObjectlnputStream | 




out: ObjectOutputStream | 


I 
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socket. getlnputStreamO | 
1 




socket. getOutputStreamO | 
t 


socket 




socket 


I 
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Figure 30.12 The client sends a StudentAddress object to the server. 



Listing 30.8 StudentClient .java 

1 import java.io.*; 

2 import java.net.*; 

3 import java.awt.*; 

4 import java.awt. event.*; 

5 import javax. swi ng . * ; 

6 import javax. swing. border.*; 
7 

8 public class StudentClient extends JApplet { 

9 private JTextField jtfName = new JTextField(32) ; 

10 private JTextField jtf Street = new JTextFi el d(32) ; 

11 private JTextField jtfCity = new JTextField(20) ; 

12 private JTextField jtfState = new JTextField(2) ; 

13 private JTextField jtfZip = new JTextFi el d(5) ; 
14 

15 // Button for sending a student to the server 

16 private JButton jbtRegister = new JButton("Register to the Server"); 
17 

18 // Indicate if it runs as application 

19 private boolean isStandAlone = false; 
20 

21 // Host name or ip 

22 String host = "local host"; 
23 

24 public void init() { 

2 5 // Panel pi for holding labels Name, Street, and City 

26 JPanel pi = new JPanelO; create UI 

27 pi. setLayout(new Gri dLayout(3 , 1)); 

28 pl.add(new JLabel ("Name")) ; 

29 pi. add (new JLabel ("Street")) ; 

30 pl.add(new JLabel ("City")) ; 
31 

32 // Panel jpState for holding state 

33 JPanel jpState = new JPanelO; 
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get server name 



server socket 



output stream 



34 
35 
36 
37 
38 
39 
40 
41 
42 
43 
44 
45 
46 
47 
48 
49 
50 
51 
52 
53 
54 
55 
56 
57 
58 
59 
60 
61 
62 
63 
64 
65 
66 
67 
68 
69 
70 
71 
72 
73 
74 
75 
76 
77 
78 
79 
80 
81 
82 
83 
84 
85 
86 
87 
88 
89 
90 
91 
92 
93 



jpState.setLayout(new BorderLayoutO) ; 
jpState.add(new JLabel ("State") , BorderLayout.WEST) ; 
jpState. add (jtf State, BorderLayout .CENTER) ; 

// Panel jpZip for holding zip 

J Panel jpZip = new JPanelO; 

jpZi p. setLayout(new BorderLayoutO) ; 

jpZip.add(new JLabel ("Zip") , BorderLayout.WEST); 

jpZip.add(jtfZip, BorderLayout. CENTER) ; 

// Panel p2 for holding jpState and jpZip 

J Panel p2 = new JPanelO; 

p2 . setLayout(new BorderLayoutO) ; 

p2. add (jpState, BorderLayout.WEST) ; 

p2 .add(jpZip, BorderLayout . CENTER) ; 

// Panel p3 for holding jtfCity and p2 
J Panel p3 = new JPanelO; 
p3 . setLayout(new BorderLayoutO) ; 
p3. add (jtf City, BorderLayout .CENTER) ; 
p3.add(p2, BorderLayout . EAST) ; 

// Panel p4 for holding jtfName, jtfStreet, and p3 

J Panel p4 = new JPanelO; 

p4 . setLayout(new Gri dLayout(3 , 1)); 

p4. add (jtf Name) ; 

p4. add (jtfStreet) ; 

p4.add(p3) ; 

// Place pi and p4 into StudentPanel 

JPanel StudentPanel = new JPanel(new BorderLayoutO); 

StudentPanel . setBorder(new Bevel Border(Bevel Border . RAISED)) ; 

StudentPanel .add(pl, BorderLayout.WEST) ; 

StudentPanel .add(p4, BorderLayout . CENTER) ; 

// Add the student panel and button to the applet 
add(studentPanel , BorderLayout. CENTER) ; 
add(jbtRegister, BorderLayout . SOUTH) ; 

// Register listener 

jbtRegi ster . addActi on Li stener(new Button Li stenerO) ; 

// Find the IP address of the Web server 
if (lisStandAlone) 

host = getCodeBase() .getHost() ; 



Handle button action */ 
rivate class ButtonLi stener implements Acti onLi stener { 
public void acti on Performed (Acti onEvent e) { 
try { 

// Establish connection with the server 
Socket socket = new Socket(host, 8000); 

// Create an output stream to the server 
ObjectOutputStream toServer = 

new ObjectOutputStream(socket.getOutputStreamO) ; 

// Get text field 

String name = jtfName . getText() . tri m() ; 
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94 String street = jtf Street . getTextO .trim() ; 

95 String city = jtfCity. getTextO .trim() ; 

96 String state = jtf State . getTextO . tri m() ; 

97 String zip = jtfZip. getTextO .trim() ; 
98 

99 // Create a StudentAddress object and send to the server 

100 StudentAddress s = 

101 new StudentAddress (name , street, city, state, zip); 

102 toServer.writeObject(s) ; send to server 

103 } 

104 catch (IOException ex) { 

105 System. err. println(ex) ; 

106 } 

107 } 

108 } 
109 

110 /** Run the applet as an application */ 

111 public static void main(String[] args) { 

112 // Create a frame 

113 JFrame frame = new JFrame("Register Student Client"); 
114 

115 // Create an instance of the applet 

116 StudentClient applet = new StudentClientO ; 

117 appl et . i sStandAl one = true; 
118 

119 // Get host 

120 if (args. length == 1) applet. host = args[0]; 
121 

122 // Add the applet instance to the frame 

123 frame. add(applet, BorderLayout .CENTER) ; 
124 

125 // Invoke init() and start() 

126 applet. init() ; 

127 applet. start() ; 
128 

129 // Display the frame 

130 frame.packO; 

131 frame . setVi si bl e(true) ; 

132 } 



133 } 

Listing 30.9 StudentServer . java 

1 i mport j ava . i o . * ; 

2 import java.net.*; 

3 

4 public class StudentServer { 



5 private ObjectOutputStream outputToFi 1 e ; 

6 private ObjectlnputStream i nputFromCl i ent ; 
7 

8 public static void main(String[] args) { 

9 new StudentServerO ; 
10 } 

11 

12 public StudentServerO { 

13 try { 

14 // Create a server socket 

15 ServerSocket serverSocket = new ServerSocket(8000) ; serversocket 

16 System. out. pri ntl n("Server started ") ; 
17 
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54 } 



// Create an object ouput stream 
outputToFile = new 0bject0utputStream( 

new Fi 1 eOutputStream("student .dat" , true)); 

while (true) { 

// Listen for a new connection request 
Socket socket = serverSocket . acceptO ; 

// Create an input stream from the socket 
i nputFromCl i ent = 

new ObjectlnputStream(socket.getlnputStreamO) ; 

// Read from input 

Object object = i nputFromCl i ent . readObject() ; 

// Write to the file 

outputToFi 1 e .wri teObject (object) ; 

System. out. println ("A new student object is stored"); 

} 

} 

catch(Cl assNotFoundExcepti on ex) { 
ex . pri ntStackTrace() ; 

} 

catch(I0Exception ex) { 
ex . pri ntStackTrace() ; 

} 

finally { 
try { 

inputFromClient.close() ; 
outputToFile. close() ; 

} 

catch (Exception ex) { 
ex.printStackTrace() ; 

} 

} 



On the client side, when the user clicks the "Register to the Server" button, the client creates 
a socket to connect to the host (line 86), creates an ObjectOutputStream on the output 
stream of the socket (lines 89-90), and invokes the writeObject method to send the 
StudentAddress object to the server through the object output stream (line 102). 

On the server side, when a client connects to the server, the server creates an 
ObjectlnputStream on the input stream of the socket (lines 27-28), invokes the 
readObject method to receive the StudentAddress object through the object input stream 
(line 31), and writes the object to a file (line 34). 

This program can run either as an applet or as an application. To run it as an application, 
the host name is passed as a command-line argument. 



30.7 Retrieving Files from Web Servers 

In previous sections you developed client/server applications. Java allows you to develop 
clients that retrieve files on a remote host through a Web server. In this case, you don't have to 
create a custom server program. The Web server can be used to send the files, as shown in 
Figure 30.13. 
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Web Server 




Applet reads the file j 

Figure 30.1 3 The applet client or the application client retrieves files from a Web server. 



To retrieve a file, first create a URL object for the file. The j ava . net .URL class was intro- 
duced in §18.10, "Locating Resource Using the URL Class." You can create a URL object 
using the following constructor: 

public URL(String spec) throws MalformedllRLException 

For example, the statement given below creates a URL object for http://www.cs.armstrong.edu/ 
liang/index.html. 

try { 

URL url = new URL("http://www. cs .armstrong.edu/1 iang/index. html ") ; 

} 

catch (MalformedURLException ex) { 
} 

A Mai formedURLException is thrown if the URL string has a syntax error. For example, 
the URL string "http:/www.cs. armstrong.edu/liang/index.html" would cause a Mai formed- 
URLException runtime error because two slashes (//)are required after the colon (:). 

You can then use the openStreamO method defined in the URL class to open an input 
stream to the file's URL. 

InputStream i nputStream = url . openStreamO ; 

Now you can read the data from the input stream. Listing 30.10 gives an example that 
demonstrates how to retrieve a file from a Web server. The program can run as an applica- 
tion or an applet. The user interface includes a text field in which to enter the URL of the 
file name, a text area in which to show the file, and a button that can be used to submit an 
action. A label is added at the bottom of the applet to indicate the status, such as File loaded 
successfully or Network connection problem. A sample run of the program is shown in 
Figure 30.14. 
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<!D0CTYPErrtml PUBLIC "-//W3C//DTD KTML4.01//EN"> 



<head> 

<tifle>Y. Daniel Liang Home Page</fitle> 

<meta http-equi'v^"content|-type" contenfc"text/htnril; chars efciso-S&59-r> 

<meta content="Y. Daniel Liang Home Page" name="description"> 

-met a eontcnt="JaYa. Liang. Y. Daniel Liang. Y. Daniel Liang Home Page" namc= 

<link rel="stylesheet' type="text/ess" href="intro6e/intro6e.css" !> 

</head> 
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File loaded successfully 



Figure 30.14 
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Listing 30.10 ViewRemoteFile. java 



create UI 



register listener 



get URL 



input stream 



1 

2 
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28 
29 
30 
31 
32 
33 
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import java.awt.*; 
import java. awt . event .* ; 
import java.io.*; 
import java.net." ; 
import javax. swi ng . * ; 

public class ViewRemoteFile extends JApplet { 

// Button to view the file 

private JButton jbtView = new JButton("View") ; 

// Text field to receive file name 

private JTextField jtfURL = new ITextFi el d(12) ; 



// Text area to store file 
private JTextArea jtaFile = 

// Label to display status 
private J Label jlbl Status = 



new ITextAreaQ ; 



new 1 Label () ; 



/** Initialize the applet */ 
public void init() { 

// Create a panel to hold a label, a text field, and a button 

1 Panel pi = new JPanelO; 

pi. setLayout(new BorderLayoutO) ; 

pl.add(new ILabel ("Filename") , BorderLayout .WEST) ; 

pl.add(jtfURL, BorderLayout. CENTER) ; 

pl.add(jbtView, BorderLayout . EAST) ; 

// Place text area and panel p to the applet 
setLayout(new BorderLayoutO); 

add(new IScrollPane(jtaFile) , BorderLayout . CENTER) ; 

add (pi, BorderLayout. NORTH) ; 

add (jlbl Status, BorderLayout . SOUTH) ; 

// Register listener to handle the "View" button 
jbtView.addActionListener(new ActionLi stener() { 
public void actionPerformed(ActionEvent e) { 
showFi 1 e() ; 

} 

}); 

} 



private void showFileO { 
java. util .Scanner input 
URL url = null ; 



null; // Use Scanner for text input 



try { 

// Obtain URL from the text field 

url = new URL(jtfURL . getTextO . trim()) ; 

// Create a Scanner for input stream 

input = new java. util .Scanner(url . openStreamO) ; 

// Read a line and append the line to the text area 
while (input. hasNextQ) { 
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56 jtaFi 1 e . append(i nput . nextLi ne() + "\n"); 

57 } 
58 

59 jlbl Status. setText("File loaded successfully"); 

60 } 

61 catch (Mai formedURLExcepti on ex) { 

62 jlbl Status. setText ("URL " + url + " not found."); 

63 } 

64 catch (IOException e) { 

65 jlblStatus.setText(e.getMessage()) ; 

66 } 

67 finally { 

68 if (input != null) i nput . cl ose() ; 

69 } 

70 } 

71 } main method omitted 



Line 49 new URL(jtfURL.getText() .trimO) creates a URL for the file name entered 
from the text field. Line 52 url . openStreamO creates an InputStream from the URL. 
After the input stream is established, reading data from the remote file is just like reading data 
locally. A Scanner object is created from the input stream for reading text (line 52). The text 
from the file is displayed in the text area (line 56). 



30.8 JEditorPane 

Swing provides a GUI component named javax. swing. J Editor Pane that can display 
plain text, HTML, and RTF files automatically. Using it, you don't have to write code to ex- 
plicitly read data from the files. JEdi torPane is a subclass of JTextComponent. Thus it in- 
herits all the behavior and properties of JTextComponent. 

To display the content of a file, use the setPage(URL) method, as follows: 

public void setPage(URL url) throws IOException 

JEditorPane generates javax. swing. event .Hyperl inkEvent when a hyperlink in the 
editor pane is clicked. Through this event, you can get the URL of the hyperlink and display 
it using the setPage(url ) method. 

Listing 30.11 gives an example that creates a simple Web browser to render HTML files. 
The program lets the user enter an HTML file in a text field and press the Enter key to display 
it in an editor pane, as shown in Figure 30.15. 
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Figure 30.15 You can specify a URL in the text field and display the HTML file in an 
editor pane. 
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Listing 30.1 1 WebBrowser, java 



create UI 



register listener 



register listener 

get URL 
display HTML 



import 
import 
import 
import 
import 
import 



j ava . awt . * ; 
java. awt . event . * ; 
javax. swi ng . * ; 
java. net. URL; 
javax. swi ng . event . * ; 
j ava .io.*; 



1 
2 
3 
4 
5 
6 
7 

8 public class WebBrowser extends DApplet { 
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// J Editor pane to view HTML files 

private JEditorPane jep = new DEditorPaneQ ; 



// Label for URL 
private JLabel jlblURL 



new 1 Label ("URL"); 



// Text field for entering URL 

private JTextField jtfURL = new UTextFi el d() ; 

/** Initialize the applet */ 
public void init() { 

// Create a panel jpURL to hold the label and text fie 

JPanel jpURL = new JPanel (); 

jpURL.setLayout(new BorderLayoutO) ; 

jpURL.add(jlblURL, BorderLayout . WEST) ; 

jpURL. add (jtfURL, BorderLayout. CENTER) ; 

// Place jpURL and jspViewer in the applet 

add(new ]ScrollPane(jspViewer ) , BorderLayout . CENTER) ; 

add(jpURL, BorderLayout . NORTH) ; 

// Set jep nonedi table 
jep.setEditable(false) ; 

// Register listener 

jep . addHyperl i nkLi stener(new Hyperl i nkLi stener() { 
public void hyperl i nkUpdate(Hyperl i nkEvent e) { 
try { 

jep.setPage(e.getURLO) ; 

} 

catch (IOException ex) { 
System. out. println (ex) ; 

} 

} 

}); 

jtfURL . addActi onLi stener(new Acti onLi stener() { 
public void actionPerformed(ActionEvent e) { 
try { 

// Get the URL from text field 

URL url = new URL(jtf URL . getTextO .trim()) ; 

// Display the HTML file 
jep . setPage(url ) ; 

} 

catch (IOException ex) { 
System. out. println(ex) ; 

} 
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57 }); 

58 } 

59 } main method omitted 

In this example, a simple Web browser is created using the JEditorPane class (line 10). 
JEditorPane is capable of displaying files in HTML format. To enable scrolling, the editor 
pane is placed inside a scroll pane (line 27). 

The user enters the URL of the HTML file in the text field and presses the Enter key to fire 
an action event to display the URL in the editor pane. To display the URL in the editor pane, 
simply set the URL in the page property of the editor pane (line 51). 

The editor pane does not have all the functions of a commercial Web browser, but it is con- 
venient for displaying HTML files, including embedded images. 

There are two shortcomings in this program: (1) it cannot view a local HTML file, and (2) 
to view a remote HTML file, you have to enter a URL beginning with http://. In Exercise 30.11, 
you will modify the program so that it can also view an HTML file from the local host and ac- 
cept URLs beginning with either http:// or www. 

30.9 Case Studies: Distributed TicTacToe Games 

In §18.9, "Case Study: TicTacToe," you developed an applet for the TicTacToe game that en- 
ables two players to play on the same machine. In this section, you will learn how to develop 
a distributed TicTacToe game using multithreads and networking with socket streams. A dis- 
tributed TicTacToe game enables users to play on different machines from anywhere on the 
Internet. 

You need to develop a server for multiple clients. The server creates a server socket and ac- 
cepts connections from every two players to form a session. Each session is a thread that com- 
municates with the two players and determines the status of the game. The server can 
establish any number of sessions, as shown in Figure 30.16. 



Server 




Figure 30.1 6 The server can create many sessions, each of which facilitates a TicTacToe 
game for two players. 



For each session, the first client connecting to the server is identified as player 1 with token 
' X ' , and the second client connecting is identified as player 2 with token ' ' . The server no- 
tifies the players of their respective tokens. Once two clients are connected to it, the server 
starts a thread to facilitate the game between the two players by performing the steps repeat- 
edly, as shown in Figure 30.17. 
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Player 1 

1. Initialize user interface. 



2. Request connection to the server 
and know which token to use from the- 



3. Get the start signal from the server.- 



Wait for the player to mark a cell, 
send the cell's row and column index to 
the server. 

5. Receive status from the server. 



6. If WIN, display the winner; if Player 
2 wins, receive the last move from 
Player 2. Break the loop. 



7. If DRAW, display game is over; 
break the loop. 



\ 



8. If CONTINUE, receive Player 2's 
selected row and column index and 
mark the cell for Player 2. 



Create a server socket. 

*~ Accept connection from the first player and notify 
the player who is Player 1 with token X. 

Accept connection from the second player and 
notify the player who is Player 2 with token O. 
Start a thread for the session 



\ 



\ 



Handle a session: 

1. Tell Player 1 to start. 

2. Receive row and column of the selected cell from 
Player 1 . 

3. Determine the game status (WIN, DRAW, 
CONTINUE). If Player 1 wins, or draws, send the status- 
(PLAYERl_WON, DRAW) to both players and send 
Player l's move to Player 2. Exit. 

4. If CONTINUE, notify Player 2 to take the turn, and 
send Player l's newly selected row and column index to 
Player 2. 

5. Receive row and column of the selected cell from 
Player 2. 

6. If Player 2 wins, send the status (PLAYER2_WON) 
to both players, and send Player 2's move to Player 1. 
Exit. 

7. If CONTINUE, send the status, and send Player 2 s 
newly selected row and column index to Player 1. 



Player 2 

1. Initialize user interface. 



2. Request connection to the server and 
-know which token to use from the server. 



3. Receive status from the server. 

4. If WIN, display the winner. If Player 1 
wins, receive Player l's last move, and 
break the loop. 

5. If DRAW, display game is over, and 
receive Player l's last move, and break 
the loop. 

6. If CONTINUE, receive Player l's 
selected row and index and mark the cell 
for Player 1 . 

7. Wait for the player to move, and send 
the selected row and column to the 



Figure 30.1 7 The server starts a thread to facilitate communications between the two players. 



The server does not have to be a graphical component, but creating it as a frame in which 
game information can be viewed is user friendly. You can create a scroll pane to hold a text 
area in the frame and display game information in the text area. The server creates a thread to 
handle a game session when two players are connected to the server. 

The client is responsible for interacting with the players. It creates a user interface with 
nine cells, and displays the game title and status to the players in the labels. The client class is 
very similar to the TicTacToe class presented in §18.9, "Case Study: TicTacToe." However, 
the client in this example does not determine the game status (win or draw), it simply passes 
the moves to the server and receives the game status from the server. 

Based on the foregoing analysis, you can create the following classes: 

■ TicTacToeServer serves all the clients in Listing 30.13. 

■ Handl eASession facilitates the game for two players in Listing 30.13. It is in the 
same file with TicTacToeServer.java. 

■ Ti cTacToeCl i ent models a player in Listing 30. 14. 

■ Cell models a cell in the game in Listing 30.14. It is an inner class in 
Ti cTacToeCl i ent. 

■ TicTacToeConstants is an interface that defines the constants shared by all the 
classes in the example in Listing 30.12. 



The relationships of these classes are shown in Figure 30.18. 
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JFrame 



4 



Tic TacToe Constan ts 



JAppl 



Runnable 



Kr 



- TicTacToeServer 





TicTacToeClient 1 


1 







HandleASession [ — 



Cell 



Similar to 
■Listing 18.10 



TicTacToeServer 



+main(args: String[]): void 



«interface» 
TicTacToeConstants 



+PLAYER1 



1: int 



+PLAYER2 = 2: int 
+PLAYER1_W0N =1: int 
+PLAYER2JAJ0N = 2: int 
+DRAW = 3: int 



+C0NTINUE = 4: int 



HandleASession 



-playerl: Socket 
-player2: Socket 
-cell: char[][] 
-continueToPlay: boolean 



+run(): void 

-i sWon() : bool ean 

-isFull () : boolean 

-sendMove(out : 

DataOutputStream, row: 
column: int): void 



int, 



TicTacToeClient 



-myTurn: boolean 
-myToken: char 
-otherToken: char 
-cell: Cell[][] 
-continueToPlay: boolean 
-rowSelected: int 
-col umnSel ected : int 
-fromServer: DatalnputStream 
-toServer: DataOutputStream 
-waiting: boolean 



+ run(): void 

-connectToServerO : void 
- recei veMove () : voi d 
-sendMove(): void 
-receiveInfoFromServer() : void 
-waitForPlayerActionQ : void 



Figure 30.18 TicTacToeServer creates an instance of HandleASession for each session of two players. 
TicTacToeCl ient creates nine cells in the UI. 



Listing 30. 1 2 Ti cTacToeConstants . j ava 

1 public interface TicTacToeConstants { 

2 public static int PLAYER1 = 1; // Indicate player 1 

3 public static int PLAYER2 = 2; // Indicate player 2 

4 public static int PLAYER1_W0N = 1; // Indicate player 1 won 

5 public static int PLAYER2_W0N = 2; // Indicate player 2 won 

6 public static int DRAW = 3; // Indicate a draw 

7 public static int CONTINUE = 4; // Indicate to continue 

8 } 

Listing 30. 1 3 Ti cTacToeSe rve r . j ava 

1 import java.io.*; 

2 import java.net.*; 

3 import javax. swing.*; 

4 import java.awt.*; 

5 import java.util .Date; 
6 

7 public class TicTacToeServer extends DFrame 

8 implements TicTacToeConstants { 

9 public static void main(String[] args) { 

10 TicTacToeServer frame = new Ti cTacToeServer() ; runserver 

11 } 
12 
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create UI 



server socket 



connect to client 



to player 1 



to player2 



a session for two players 



13 
14 
15 
16 
17 
18 
19 
20 
21 
22 
23 
24 
25 
26 
27 
28 
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30 
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32 
33 
34 
35 
36 
37 
38 
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40 
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44 
45 
46 
47 
48 
49 
50 
51 
52 
53 
54 
55 
56 
57 
58 
59 
60 
61 
62 
63 
64 
65 
66 
67 
68 
69 
70 
71 
72 



public Ti cTacToeServerO { 

JTextArea jtaLog = new ITextAreaO ; 

// Create a scroll pane to hold text area 
IScrollPane scrollPane = new IScroll Pane(jtaLog) ; 

// Add the scroll pane to the frame 
add(scrollPane, BorderLayout . CENTER) ; 

setDef aul tCl oseOperati on (1 Frame . EXIT_0N_CL0SE) ; 
setSize(300, 300); 
setTitle("TicTacToeServer") ; 
setVi si bl e(true) ; 

try { 

// Create a server socket 

ServerSocket serverSocket = new ServerSocket(8000) ; 
jtaLog. append(new Date() + 

": Server started at socket 8000\n") ; 

// Number a session 
int sessionNo = 1; 

// Ready to create a session for every two players 
while (true) { 

jtaLog . append(new Date() + 

": Wait for players to join session " + sessionNo + '\ri'); 

// Connect to player 1 

Socket playerl = serverSocket. acceptO ; 

jtaLog . append(new Date() + ": Player 1 joined session " + 

sessionNo + '\n') ; 
jtaLog. append("Player l's IP address" + 

playerl. getInetAddress() .getHostAddress() + '\ri'); 

// Notify that the player is Player 1 
new Data0utputStream( 

playerl. getOutputStreamO) .wri telnt(PLAYERl) ; 

// Connect to player 2 

Socket player2 = serverSocket. accept () ; 

jtaLog . append(new Date() + 

": Player 2 joined session " + sessionNo + '\n')l 
jtaLog. append("Player 2's IP address" + 

player2 .getInetAddress() .getHostAddress() + '\n'); 

// Notify that the player is Player 2 
new Data0utputStream( 

pi ayer2. getOutputStreamO) .wri teInt(PLAYER2) ; 

// Display this session and increment session number 
jtaLog . append(new Date() + ": Start a thread for session " + 
sessionNo++ + '\n'); 

// Create a new thread for this session of two players 
Handl eASessi on task = new HandleASession(playerl, player2); 

// Start the new thread 



30.9 Case Studies: Distributed TicTacToe Games 1045 



73 new Thread(task) . start() ; 

74 } 

75 } 

76 catch (IOExcepti on ex) { 

77 System. err. println(ex) ; 

78 } 



79 } 

80 } 
81 

82 // Define the thread class for handling a new session for two players 

83 class HandleASession implements Runnable, Ti cTacToeConstants { 



84 private Socket playerl; 

85 private Socket player2; 
86 

87 // Create and initialize cells 

88 private char[][] cell = new char[3][3]; 
89 

90 private DatalnputStream fromPlayerl; 

91 private DataOutputStream toPlayerl; 

92 private DatalnputStream fromPlayer2; 

93 private DataOutputStream toPlayer2; 
94 

95 // Continue to play 

96 private boolean conti nueToPl ay = true; 
97 

98 /** Construct a thread */ 

99 public HandleASession(Socket playerl, Socket player2) { 

100 this. playerl = playerl; 

101 this.player2 = player2; 
102 

103 // Initialize cells 

104 for (int i = 0; i < 3; i++) 

105 for (int j = 0; j < 3; j++) 

106 cell[i][j] = ' '; 

107 } 
108 

109 /** Implement the run() method for the thread */ 

110 public void run() { 

111 try { 

112 // Create data input and output streams 

113 DatalnputStream fromPlayerl = new DataInputStream( 

114 playerl. getlnputStreamO) ; 

115 DataOutputStream toPlayerl = new Data0utputStream( 

116 playerl. getOutputStreamO) ; 

117 DatalnputStream fromPlayer2 = new DataInputStream( 

118 pi ayer2 . getlnputStreamO) ; 

119 DataOutputStream toPlayer2 = new Data0utputStream( 

120 player2. getOutputStreamO) ; 
121 

122 // Write anything to notify player 1 to start 

123 // This is just to let player 1 know to start 

124 toPlayerl. writelnt(l) ; 
125 

126 // Continuously serve the players and determine and report 

127 // the game status to the players 

128 while (true) { 

129 // Receive a move from player 1 

130 int row = fromPlayerl. readlntO ; 

131 int column = fromPlayerl. readlntO ; 

132 cell [row] [column] = 'X'; 
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133 

134 // Check if Player 1 wins 

135 if (iswon('X')) { 

136 toPlayerl.wn'teInt(PLAYERl_WON) ; 

137 toPlayer2.writeInt(PLAYERl_W0N) ; 

138 sendMove(toPlayer2 , row, column); 

139 break; // Break the loop 

140 } 

141 else if (isFullO) { // Check if all cells are filled 

142 toPlayerl.writelnt(DRAW) ; 

143 toPlayer2 .writelnt(DRAW) ; 

144 sendMove(toPlayer2 , row, column); 

145 break; 

146 } 

147 else { 

148 // Notify player 2 to take the turn 

149 toPlayer2.writeInt(C0NTINUE) ; 
150 

151 // Send player l's selected row and column to player 2 

152 sendMove(toPlayer2 , row, column); 

153 } 
154 

155 // Receive a move from Player 2 

156 row = f romPl ayer2 . readlnt() ; 

157 column = f romPl ayer2 . readlnt() ; 

158 cell [row] [column] = '0'; 
159 

160 // Check if Player 2 wins 

161 if (iswon('O')) { 

162 toPlayerl.writeInt(PLAYER2_W0N) ; 

163 toPlayer2.writeInt(PLAYER2_WON) ; 

164 sendMove(toPlayerl, row, column); 

165 break; 

166 } 

167 else { 

168 // Notify player 1 to take the turn 

169 toPlayerl.writelnt(CONTINUE) ; 
170 

171 // Send player 2's selected row and column to player 1 

172 sendMove(toPlayerl, row, column); 

173 } 

174 } 

175 } 

176 catch (IOExcepti on ex) { 

177 System. err. println(ex) ; 

178 } 

179 } 
180 

181 /** Send the move to other player */ 

182 private void sendMove(DataOutputStream out, int row, int column) 

183 throws IOExcepti on { 

184 out.writelnt(row) ; // Send row index 

185 out.writelnt(column) ; // Send column index 

186 } 
187 

188 /** Determine if the cells are all occupied */ 

189 private boolean isFullO { 

190 for (int i = 0; i < 3; i++) 

191 for (int j = 0; j < 3; j++) 

192 if (cell[i][j] == ' ') 
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193 return false; // At least one cell is not filled 
194 

195 // All cells are filled 

196 return true; 

197 } 
198 

199 /** Determine if the player with the specified token wins */ 

200 private boolean isWon(char token) { 

201 // Check all rows 

202 for (int i = 0; i < 3; i++) 

203 if ((cell [i] [0] == token) 

204 && (cell [i] [1] == token) 

205 && (cell [i] [2] == token)) { 

206 return true; 

207 } 
208 

209 /** Check all columns */ 

210 for (int j = 0; j < 3; j++) 

211 if ((cell [0] [j] == token) 

212 && (cell [1] [j] == token) 

213 && (cell [2] [j] == token)) { 

214 return true; 

215 } 
216 

217 /** Check major diagonal */ 

218 if ((cell[0][0] == token) 

219 && (cell[l][l] == token) 

220 && (cell [2] [2] == token)) { 

221 return true; 

222 } 
223 

224 /** Check subdi agonal */ 

225 if ((cell [0] [2] == token) 

226 && (cell[l][l] == token) 

227 && (cell [2] [0] == token)) { 

228 return true; 

229 } 
230 

231 /** All checked, but no winner */ 

232 return false; 

233 } 



234 } 

Listing 30. 1 4 Ti cTacToeCl i en t . j ava 

1 import java.awt.*; 

2 import java.awt. event.*; 

3 import javax. swing.*; 

4 import javax. swi ng . border . Li neBorder ; 

5 import java.io.*; 

6 import java.net.*; 
7 

8 public class Ti cTacToeCl i ent extends 1 Applet 



9 implements Runnable, Ti cTacToeConstants { 

10 // Indicate whether the player has the turn 

11 private boolean myTurn = false; 
12 

13 // Indicate the token for the player 

14 private char myToken = 1 ' ; 
15 



1048 Chapter 30 



Networking 



create UI 



connect to server 



16 
17 
18 
19 
20 
21 
22 
23 
24 
25 
26 
27 
28 
29 
30 
31 
32 
33 
34 
35 
36 
37 
38 
39 
40 
41 
42 
43 
44 
45 
46 
47 
48 
49 
50 
51 
52 
53 
54 
55 
56 
57 
58 
59 
60 
61 
62 
63 
64 
65 
66 
67 
68 
69 
70 
71 
72 
73 
74 
75 



// Indicate the token for the other player 
private char otherToken = 1 ' ; 

// Create and initialize cells 

private Cell [] [] cell = new Cell [3] [3]; 

// Create and initialize a title label 
private J Label jlbl Title = new DLabelO; 

// Create and initialize a status label 
private JLabel jlblStatus = new JLabelO; 

// Indicate selected row and column by the current move 
private int rowSelected; 
private int col umnSel ected ; 

// Input and output streams from/to server 
private DatalnputStream fromServer; 
private DataOutputStream toServer; 



// Continue to play? 

private boolean conti nueToPl ay 



true; 



// Wait for the player to mark a cell 
private boolean waiting = true; 

// Indicate if it runs as application 
private boolean isStandAlone = false; 

// Host name or ip 

private String host = "local host"; 

/** Initialize UI */ 
public void init() { 

// Panel p to hold cells 
1 Panel p = new JPanelO; 
p . setLayout(new Gri dLayout(3 , 3, 0, 0)); 
for (int i = 0; i < 3; i++) 
for (int j = 0; j < 3; 

p.add(cell [i] [j] = new Cell (i , j)); 

// Set properties for labels and borders for labels and panel 

p.setBorder(new LineBorder(Color. black, 1)); 

j 1 blTi tl e . setHori zontal Al ignmentQ Label .CENTER) ; 

jlblTitle.setFont(new FontC'SansSerif", Font. BOLD, 16)); 

j 1 blTi tl e . setBorder(new Li neBorder(Col or . bl ack , 1)); 

j 1 bl Status . setBorder(new LineBorder(Color. black, 1)); 

// Place the panel and the labels to the applet 

add (jlbl Title, BorderLayout . NORTH) ; 

add(p, BorderLayout. CENTER) ; 

add (jlbl Status, BorderLayout . SOUTH) ; 



// Connect to the server 
connectToServerQ ; 



} 



private void connectToServer() { 
try { 

// Create a socket to connect to the server 
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76 Socket socket; 

77 if (isStandAlone) 

78 socket = new Socket(host , 8000); standalone 

79 else 

80 socket = new Socket(getCodeBase() . getHost() , 8000); applet 
81 

82 // Create an input stream to receive data from the server 

83 fromSe rver = new DatalnputSt ream (socket. getlnputSt ream ()) ; input from server 
84 

85 // Create an output stream to send data to the server 

86 toServer = new DataOutputStream(socket.getOutputStreamO) ; output to server 

87 } 

88 catch (Exception ex) { 

89 System. err. println(ex) ; 

90 } 
91 

92 // Control the game on a separate thread 

93 Thread thread = new Thread(this) ; 

94 thread. start() ; 

95 } 
96 

97 public void run() { 

98 try { 

99 // Get notification from the server 
100 int player = f romServer. readlnt() ; 
101 

102 // Am I player 1 or 2? 

103 if (player == PLAYER1) { 

104 myToken = 'X' ; 

105 otherToken = '0' ; 

106 jlblTitle.setText ("Player 1 with token 'X'"); 

107 jlbl Status. setText ("Waiting for player 2 to join"); 
108 

109 // Receive startup notification from the server 

110 f romServer . readlnt() ; // Whatever read is ignored 
111 

112 // The other player has joined 

113 jlblStatus.setText("Player 2 has joined. I start first"); 
114 

115 // It is my turn 

116 myTurn = true; 

117 } 

118 else if (player == PLAYER2) { 

119 myToken = '0' ; 

120 otherToken = 'X' ; 

121 jlbl Title. setText ("Player 2 with token '0'"); 

122 jlblStatus.setText("Waiting for player 1 to move"); 

123 } 
124 

12 5 // Continue to play 

126 while (conti nueToPl ay) { 

127 if (player == PLAYER1) { 

128 waitForPlayerAction() ; // Wait for player 1 to move 

129 sendMoveO; // Send the move to the server 

130 recei velnfoFromServerO ; // Receive info from the server 

131 } 

132 else if (player == PLAYER2) { 

133 recei velnfoFromServerO ; // Receive info from the server 

134 waitForPlayerAction() ; // Wait for player 2 to move 

135 sendMoveO ; // Send player 2's move to the server 
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136 } 

137 } 

138 } 

139 catch (Exception ex) { 

140 } 

141 } 
142 

143 /** Wait for the player to mark a cell */ 

144 private void waitForPlayerAction() throws InterruptedException { 

145 while (waiting) { 

146 Thread. si eep(100) ; 

147 } 
148 

149 waiting = true; 

150 } 
151 

152 /** Send this player's move to the server */ 

153 private void sendMove() throws IOException { 

154 toServer .wri teInt(rowSel ected) ; // Send the selected row 

155 toServer. writelnt(columnSelected) ; // Send the selected column 

156 } 
157 

158 /** Receive info from the server */ 

159 private void recei velnfoFromServerO throws IOException { 

160 // Receive game status 

161 int status = f romServer . readlnt() ; 
162 

163 if (status == PLAYER1_W0N) { 

164 // Player 1 won, stop playing 

165 conti nueToPl ay = false; 

166 if (myToken == 'X') { 

167 jlbl Status. setText ("I won! (X)"); 

168 } 

169 else if (myToken == '0') { 

170 jlbl Status. setText ("Player 1 (X) has won!"); 

171 recei veMove() ; 

172 } 

173 } 

174 else if (status == PLAYER2_W0N) { 

175 // Player 2 won, stop playing 

176 conti nueToPl ay = false; 

177 if (myToken == '0') { 

178 jlbl Status. setText ("I won! (0)"); 

179 } 

180 else if (myToken == 'X') { 

181 jlbl Status. setText ("Player 2 (0) has won!"); 

182 recei veMove() ; 

183 } 

184 } 

185 else if (status == DRAW) { 

186 // No winner, game is over 

187 conti nueToPl ay = false; 

188 jlblStatus.setText("Game is over, no winner!"); 
189 

190 if (myToken == '0') { 

191 recei veMove() ; 

192 } 

193 } 

194 else { 

195 recei veMove() ; 



30.9 Case Studies: Distributed TicTacToe Games 1051 



196 jlblStatus.setText("My turn"); 

197 myTurn = true; // It is my turn 

198 } 

199 } 
200 

201 private void recei veMove() throws IOException { 

202 // Get the other player's move 

203 int row = f romServer . readlntO ; 

204 int column = f romServer . readlntO ; 

205 cell [row] [column] . setToken(otherToken) ; 

206 } 
207 

208 // An inner class for a cell 

209 public class Cell extends 1 Panel { model a cell 

210 // Indicate the row and column of this cell in the board 

211 private int row; 

212 private int column; 
213 

214 // Token used for this cell 

215 private char token = 1 ' ; 
216 

217 public Cell (int row, int column) { 

218 this . row = row; 

219 this. column = column; 

220 setBorder(new LineBorder(Color. black, 1)); // Set cell's border 

221 addMouseLi stener(new CI i ckLi stenerO) ; // Register listener register listener 

222 } 
223 

224 /** Return token */ 

225 public char getToken() { 

226 return token; 

227 } 
228 

229 /** Set a new token */ 

230 public void setToken(char c) { 

231 token = c; 

232 repaintO; 

233 } 
234 

235 /** Paint the cell */ 

236 protected void pai ntComponent(Graphi cs g) { 

237 super . pai ntComponent(g) ; 
238 

239 if (token == 'X') { 

240 g.drawLine(10, 10, getWidth() - 10, getHeight() - 10); drawX 

241 g.drawLine(getwidth() - 10, 10, 10, getHeight() - 10); 

242 } 

243 else if (token == '0') { 

244 g.drawOval (10, 10, getwidthO - 20, getHeightO - 20); drawO 

245 } 

246 } 
247 

248 /** Handle mouse click on a cell */ 

249 private class CI i ckLi stener extends MouseAdapter { mouse listener 

250 public void moused i cked(MouseEvent e) { 

251 // If cell is not occupied and the player has the turn 
2 52 if ((token == ' ') && myTurn) { 

253 setToken(myToken) ; // Set the player's token in the cell 

2 54 myTurn = false; 

255 rowSelected = row; 
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256 col umnSel ected = column; 

257 jl bl Status . setText("Wai ting for the other player to move"); 

258 waiting = false; // lust completed a successful move 



259 
260 
261 
262 

main method omitted 263 } 



The server can serve any number of sessions. Each session takes care of two players. The 
client can be a Java applet or a Java application. To run a client as a Java applet from a Web 
browser, the server must run from a Web server. Figures 30.19 and 30.20 show sample runs of 
the server and the clients. 



■|t TicTacToeServer 


-lalxl 


: ri Apr 02 1 9:20:54 EST 2004: Server started at socket 8000 
Fri Apr 02 19:20:54 EST 2004: Wait for players to join session 1 
Fri Apr 02 1 9:21 :05 EST 2004: Player 1 joined session 1 
Player 1 's IP addressl 27.0.0.1 

Fri Apr 02 1 9:21 :31 EST 2004: Player 2 joined session 1 
Player 2's IP addressl 27.0.0.1 

Fri Apr 02 19:21:31 EST 2004: Start a thread for session 1 

Fri Apr 02 19:21:31 EST 2004: Wait for players to join session 2 





Figure 30.19 TicTacToeServer accepts connection requests and creates sessions to 
serve pairs of players. 



Player 1 with token 'X' 
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Player 2 with token '0' 




















3 layer 1 (X) has wan! 



Figure 30.20 TicTacToeCl ient can run as an applet or an application. 



The TicTacToeConstants interface defines the constants shared by all the classes in the 
project. Each class that uses the constants needs to implement the interface. Centrally defin- 
ing constants in an interface is a common practice in Java. For example, all the constants 
shared by Swing classes are defined in java. swing. SwingConstants. 

Once a session is established, the server receives moves from the players in alternation. 
Upon receiving a move from a player, the server determines the status of the game. If the 
game is not finished, the server sends the status (CONTINUE) and the player's move to the 
other player. If the game is won or drawn, the server sends the status (PLAYER1_W0N, 
PLAYER2_WON, or DRAW) to both players. 

The implementation of Java network programs at the socket level is tightly synchronized. 
An operation to send data from one machine requires an operation to receive data from the 
other machine. As shown in this example, the server and the client are tightly synchronized to 
send or receive data. 

Chapter Summary 

I . Java supports stream sockets and datagram sockets. Stream sockets use TCP (Trans- 
mission Control Protocol) for data transmission, whereas datagram sockets use UDP 
(User Datagram Protocol). Since TCP can detect lost transmissions and resubmit 
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them, transmissions are lossless and reliable. UDP, in contrast, cannot guarantee loss- 
less transmission. 

2. To create a server, you must first obtain a server socket, using new ServerSock- 
et(port). After a server socket is created, the server can start to listen for connec- 
tions, using the accept () method on the server socket. The client requests a 
connection to a server by using new socket (serverName , port) to create a client 
socket. 

3. Stream socket communication is very much like input/output stream communication 
after the connection between a server and a client is established. You can obtain an 
input stream using the getlnputStreamO method and an output stream using the 
getOutputStreamO method on the socket. 

4. A server must often work with multiple clients at the same time. You can use threads 
to handle the server's multiple clients simultaneously by creating a thread for each 
connection. 

5. Applets are good for deploying multiple clients. They can run anywhere with a single 
copy of the program. However, because of security restrictions, an applet client can 
connect only to the server where the applet is loaded. 

6. Java programs can retrieve data from a file on a remote host through a Web server. To do 
so, first create a URL object using new URL(url String), then use openSt ream () to 
get an InputStream to read the data from the file. 

7. Swing provides a GUI component named j avax . swi ng . JEdi torPane that can be 
used to display text, HTML, and RTF files automatically without writing the code to 
read data from the file explicitly. 

Review Questions 

Section 30.2 

30.1 How do you create a server socket? What port numbers can be used? What hap- 
pens if a requested port number is already in use? Can a port connect to multiple 
clients? 

30.2 What are the differences between a server socket and a client socket? 

30.3 How does a client program initiate a connection? 

30.4 How does a server accept a connection? 

30.5 How are data transferred between a client and a server? 

Sections 30.3-30.4 

30.6 How do you find the IP address of a client that connects to a server? 

30.7 How do you make a server serve multiple clients? 

Sections 30.5-30.6 

30.8 Can an applet connect to a server that is different from the machine where the 
applet is located? 

30.9 How do you find the host name of an applet? 

30. 1 How do you send and receive an object? 
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Sections 30.7-30.8 

30.11 Can an application retrieve a file from a remote host? Can an application update a 
file on a remote host? 

30.12 How do you retrieve a file from a Web server? 

30.1 3 What types of files can be displayed in a J Editor Pane? How do you display a 
file in a J Editor Pane? 



Programming Exercises 



Section 30.2 

30. 1 * (Loan server) Write a server for a client. The client sends loan information (annual 
interest rate, number of years, and loan amount) to the server (see Figure 30.21(b)). 
The server computes monthly payment and total payment and sends them back to 
the client (see Figure 30.21(a)). Name the client Exercise30_l Client and the server 
Exercise30_l Server. 



I Exerase30_lServer 



JnJ. 



EKercise30_1Ser.'er started at Wed Jul 1 8 15:49:01 EDT2007 
Starting thread for client 1 at Wed Jul 18 15:49:12 EDT 200 7 
Client 1 's hostname is localhost 
Client 1 's IP Address is 1 27.0. D.1 

Annual Interest Rate: 3.5 Number of Years: 3 Loan Amount: 50DO.O 

month lyPayment: 1 46.510398634551 5 totalPayment 146.51 0368634551 5 



(a) 



I Exercise30_l Client 



Jnj_x 



Annual Interest Rate 


3.5 




Number Of Years 
Loan Amount 


3 


Submit 


5000 





Annual Interest Rate: 3.5 Mumber of Years: 3 Loan Amount: 5DO0.0 

month lyPayment 146.510393634551 5 totalPayment: 146.510398634551 5 



: 



(b) 



Figure 30.2 1 The client in (b) sends the annual interest rate, number of years, and loan amount to the server and re- 
ceives the monthly payment and total payment from the server in (a). 



30.2 (Network I/O using Scanner and PrintWriter) Rewrite the client and server 
programs in Listings 30.1 and 30.2 using a Scanner for input and a 
PrintWriter for output. Name the client Exercise30_2Client and the server 
Exercise30_2Server. 

Sections 30.3-30.4 

30.3* (Loan server for multiple clients) Revise Exercise 30.1 to write a server for multi- 
ple clients. 

Section 30.5 

30.4 (Web visit count) §30.5, "Applet Clients," created an applet that shows the num- 
ber of visits made to a Web page. The count is stored in a file on the server side. 
Every time the page is visited or reloaded, the applet sends a request to the server, 
and the server increases the count and sends it to the applet. The count is stored 
using a random-access file. When the applet is loaded, the server reads the count 
from the file, increases it, and saves it back to the file. Rewrite the program to im- 
prove its performance. Read the count from the file when the server starts, and 
save the count to the file when the server stops, using the Stop button, as shown in 
Figure 30.22. When the server is alive, use a variable to store the count. Name the 
client Exercise30_4Client and the server Exercise30_4Server. The client program 
should be the same as in Listing 30.5. Rewrite the server as a GUI application 
with a Stop button that exits the server. 
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B Cxercise30 


4Server: Wei 


-Inlxl 


Server started 






Starting thread D 






Client IP n 27.0.0.1 






Starting thread 1 






Client IP 27.0.0.1 






Stop 







.Applet 


You a re visitor nu mrj er '6 




Applel started. 








.Applet 


Yo lj a re visitor nu mb er 4 




Applet started. 





Figure 30.22 The applet displays how many times this Web page has been accessed. The 
server stores the count. 



30.5 (Creating a stock ticker in an applet) Write an applet like the one in Exercise 18.16. 
Assume that the applet gets the stock index from a file named Exercise30_5.txt 
stored on the Web server. Enable the applet to run standalone. 

Section 30.6 

30.6 (Displaying and adding addresses) Develop a client/server application to view and 
add addresses, as shown in Figure 30.23(a). 

■ Define an Address class to hold name, street, city, state, and zip in an object. 

■ The user can use the buttons First, Next, Previous, and Last to view an address, 
and the Add button to add a new address. 

■ Limit the concurrent connections to two clients. 

Name the client Exercise30_6Client and the server Exercise30_6Server. 



ExerciseSO SCfent 



Name John Smith 
StreetR 



100 Main Strict 



City Savannah 



Zip 31 41 3 



Add 


First 


Next 


Previous 


Last 



I Exerrise30 10 



Jul. 



FlowLayoi.it 
> GridLayout 

'_') Rnxl ayout 



The GridLayout manager arranges 
components in a grid (matrix) formation 
with the number of rows and columns 
defined by the constructor. The components 



(a) (b) 
Figure 30.23 (a) You can view and add an address in this applet; (b) The HTML files are displayed in a JEdi torPane. 



30.7* (Transferring last 100 numbers in an array) Exercise 23.9 retrieves the last 100 
prime numbers from a file Exercise23_8.dat. Write a client program that requests 
the server to send the last 100 prime numbers in an array. Name the server pro- 
gram Exercise30_7Server and the client program Exercise30_7Client. Assume 
that the numbers of the 1 ong type are stored in Exercise23_8.dat in binary format. 

30.8* (Transferring last 100 numbers in an ArrayList) Exercise 23.9 retrieves the last 
100 prime numbers from a file Exercise23_8.dat. Write a client program that re- 
quests the server to send the last 100 prime numbers in an ArrayList. Name the 
server program Exercise30_8Server and the client program Exercise30_8Client. 
Assume that the numbers of the 1 ong type are stored in Exercise23_8.dat in binary 
format. 
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Section 30.7 
30.9* 



(Retrieving remote files) Revise Listing 30.10, ViewRemoteFile.java, to use 
J Editor Pane instead of JTextArea. 



Section 30.8 

30. 1 0* (Using JEditorPane) Write a program to get descriptions of the layout man- 
ager from an HTML file and display it in a JEdi torPane, as shown in Figure 
30.23(b). The descriptions are stored in three files: FlowLayout.html, Grid- 
Layout.html, and BoxLayout.html. 

30.1 I * (Web browser) Modify Listing 30. 1 1 , WebBrowser.java, as follows: 

■ It accepts an HTML file from a local host. Assume that a local HTML file 
name begins neither with http:// nor with www. 

■ It accepts a remote HTML file. A remote HTML file name begins with 
either http:// or www. 

Sections 30.9 

30.12** (Chat) Write a program that enables two users to chat. Implement one user as 
the server (Figure 30.24(a)) and the other as the client (Figure 30.24(b)). The 
server has two text areas: one for entering text and the other (noneditable) for 
displaying text received from the client. When the user presses the Enter key, 
the current line is sent to the client. The client has two text areas: one for re- 
ceiving text from the server, and the other for entering text. When the user 
presses the Enter key, the current line is sent to the server. Name the client 
Exercise30_12Client and the server Exercise30_12Server. 



Server 

Hi Juhn, 

How are you? 



Client 

I li rrank, 

I am Tine. 
Thanks. 



15 bxerciseatt_iztleiit; 


_|D|x| 


UKIH 


Hi Frank, 




1 an fi"t 




Thanks. 




Server 






Hi Jo tin, 




How arg you? 





(a) 



(b) 



Figure 30.24 The server and client send and receive text from each other. 



30.1 3*** (Multiple client chat) Write a program that enables any number of clients to 
chat. Implement one server that serves all the clients, as shown in Figure 30.25. 
Name the client Exercise30_13Client and the server Exercise30_13Server. 



'.kitTnfCGD&crvji carted at Jul 1 s 1 5 50 24 edt:qc 
Connection hum Su£k(flf,ad(Ji=M 27 D.1 .uoifcl 537,luc jlp 
Connection from rSntketfaddrsM ?7 D 1 porfcl fi?n.lne»lp 
connection from sockc-t[ad3r=ii 27 D i.porM629.iQc alp 
Pb-Ltji. Hp. Tliit Pater 
Katie Hi This is Katie 

John: Hi, [his is John 



n 



(a) 



(b) 



UIJlRSSJliMr ^IqJ-xJ 


Name Katie 


Enter Mad 


PuLti. Hi, This is Pytei 




Katie: in, Etna la Katie 




John. Hi.Tliis it Juhn 





(c) 



S Exerdbe3©_13Clit;ii't 


-|n|*l 


Hamelneter 


Enter tutr| 


Peler I li This ia Peter 




Kaliu.Hi, This Is Kadi* 




John: HI, This loJohn 







-lnl*| 


Name|john 


Enter loxl | 


Peter HI. This I e Peter 




Katie: 1 li. This is Kalie 




Juhn. Hi, This is Juhn 





(d) 



Figure 30.25 The server starts in (a) with three clients in (b), (c), and (d). 
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Internationalization 

Objectives 

■ To describe Java's internationalization features (§3 1.1). 

■ To construct a locale with language, country, and variant (§31.2). 

■ To display date and time based on locale (§31.3). 

■ To display numbers, currencies, and percentages based on locale (§31.4). 

■ To develop applications for international audiences using resource bundles (§31.5). 

■ To specify encoding schemes for text I/O (§31.6). 
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Unicode 



Local e class 



ResourceBundl e 



31.1 Introduction 

Many Web sites maintain several versions of Web pages so that readers can choose one writ- 
ten in a language they understand. Because there are so many languages in the world, it would 
be highly problematic to create and maintain enough different versions to meet the needs of 
all clients everywhere. Java comes to the rescue. Java is the first language designed from the 
ground up to support internationalization. In consequence, it allows your programs to be cus- 
tomized for any number of countries or languages without requiring cumbersome changes in 
the code. 

Here are the major Java features that support internationalization: 

■ Java characters use Unicode, a 16-bit encoding scheme established by the Unicode 
Consortium to support the interchange, processing, and display of written texts in the 
world's diverse languages. The use of Unicode encoding makes it easy to write Java 
programs that can manipulate strings in any international language. (To see all the 
Unicode characters, visit http://mindprod.com/jgloss/reuters.html.) 

■ Java provides the Local e class to encapsulate information about a specific locale. A 
Local e object determines how locale-sensitive information, such as date, time, and 
number, is displayed, and how locale-sensitive operations, such as sorting strings, 
are performed. The classes for formatting date, time, and numbers, and for sorting 
strings are grouped in the java. text package. 

■ Java uses the ResourceBundl e class to separate locale-specific information, such 
as status messages and GUI component labels, from the program. The information is 
stored outside the source code and can be accessed and loaded dynamically at run- 
time from a ResourceBundl e, rather than hard-coded into the program. 

In this chapter, you will learn how to format dates, numbers, currencies, and percentages for 
different regions, countries, and languages. You will also learn how to use resource bundles to 
define which images and strings are used by a component, depending on the user's locale and 
preferences. 



31.2 The Locale Class 

A Local e object represents a geographical, political, or cultural region in which a specific 
language or custom is used. For example, Americans speak English, and the Chinese speak 
Chinese. The conventions for formatting dates, numbers, currencies, and percentages may 
differ from one country to another. The Chinese, for instance, use year/month/day to represent 
the date, while Americans use month/day/year. It is important to realize that locale is not de- 
fined only by country. For example, Canadians speak either Canadian English or Canadian 
French, depending on which region of Canada they reside in. 

# Note 

1 ocal e property in Every Swing user-interface class has a locale property inherited from the Component class. 

Component 

To create a Local e object, use one of the three constructors with a specified language and 
optional country and variant, as shown in Figure 31.1. 

language The 1 anguage should be a valid language code — that is, one of the lowercase two-letter 

codes defined by ISO-639. For example, zh stands for Chinese, da for Danish, en for English, 
de for German, and ko for Korean. Table 31.1 lists the language codes. 

country The country should be a valid ISO country code — that is, one of the uppercase, two-letter 

codes defined by ISO-3166. For example, CA stands for Canada, CN for China, DK for Den- 
mark, DE for Germany, and US for the United States. Table 31.2 lists the country codes. 
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java.ulil. Locale 

+l_ocale (language: String) 
+Locale(language: String, country: String) 
+Locale(language: String, country: String, 

variant: String) 
+getCountry() : String 
+getl_anguage() : String 
+getVariant() : String 
+getDefau"lt() : Locale 
+getDisplayCountry() : String 
+getDisp1ayl_anguage() : String 
+getDisp1ayName() : String 

+getDisp1ayVariant() : String 
+getAvailableLocales() : Locale[] 



Figure 31.1 The Local e class encapsulates a locale. 



Table 3 1. 1 Common Languag 


e Codes 


Code 


Language 


Code 


Language 


da 


Danish 


ja 


Japanese 


de 


German 


ko 


Korean 


cl 


Greek 


nl 


Dutch 


cn 


English 


no 


Norwegian 


es 


Spanish 


Pt 


Portuguese 


fi 


Finnish 


sv 


Swedish 


fl- 


French 


tr 


Turkish 


it 


Italian 


zh 


Chinese 



Constructs a locale from a language code. 
Constructs a locale from language and country codes. 
Constructs a locale from language, country, and variant codes. 

Returns the country/region code for this locale. 
Returns the language code for this locale. 
Returns the variant code for this locale. 
Gets the default locale on the machine. 

Returns the name of the country as expressed in the current locale. 
Returns the name of the language as expressed in the current locale. 

Returns the name for the locale. For example, the name is Chi nese 

(Chi na) for the locale Local e . CHINA . 
Returns the name for the locale's variant if it exists. 
Returns the available locales in an array. 



Table 3 1.2 Common Country Codes 



Code 


Country 


Code 


Country 


AT 


Austria 


IE 


Ireland 


BE 


Belgium 


HK 


Hong Kong 


CA 


Canada 


IT 


Italy 


CH 


Switzerland 


JP 


Japan 


CN 


China 


KR 


Korea 


DE 


Germany 


NL 


Netherlands 


DK 


Denmark 


NO 


Norway 


ES 


Spain 


PT 


Portugal 


FI 


Finland 


SE 


Sweden 


FR 


France 


TR 


Turkey 


GB 


United Kingdom 


TW 


Taiwan 


GR 


Greece 


US 


United States 
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variant The argument variant is rarely used and is needed only for exceptional or system-dependent 

situations to designate information specific to a browser or vendor. For example, the Norwegian 
language has two sets of spelling rules, a traditional one called bokmal and a new one called 
nynorsk. The locale for traditional spelling would be created as follows: 

new Locale("no", "NO", "B") ; 

For convenience, the Locale class contains many predefined locale constants. Locale. 
CANADA is for the country Canada and language English; Local e . CANADA_FRENCH is for the 
country Canada and language French. Several other common constants are: 

Locale. US, Locale. UK, Local e . FRANCE , Locale. GERMANY, Locale. ITALY, 
Locale. CHINA, Locale. KOREA, Local e . JAPAN , and Locale. TAIWAN 

The Local e class also provides the following constants based on language: 

Locale. CHINESE, Local e . ENGLISH , Local e . FRENCH , Locale. GERMAN, 

Locale. ITALIAN, Locale. JAPANESE, Local e . KOREAN , 

Local e.SIMPLIFIED_CHINESE, and Local e .TRADITIONAL_CHINESE 

Tip 

You can invoke the static method getAvailableLocalesO in the Locale class to obtain 
all the available locales supported in the system. For example, 

Local e[] avai 1 abl eLocal es = Calendar. getAvailableLocalesO ; 

returns all the locales in an array. 

Tip 

Your machine has a default locale. You may override it by supplying the language and region pa- 
rameters when you run the program, as follows: 

java -Duser . 1 anguage=zh -Duser. region=CN MainClass 

locale sensitive An operation that requires a Local e to perform its task is called locale sensitive. Displaying 

a number such as a date or time, for example, is a locale-sensitive operation; the number 
should be formatted according to the customs and conventions of the user's locale. The sec- 
tions that follow introduce locale-sensitive operations. 

31.3 Displaying Date and Time 

Applications often need to obtain date and time. Java provides a system-independent encap- 
sulation of date and time in the java.util .Date class; it also provides java.util . 
TimeZone for dealing with time zones, and java.util .Calendar for extracting detailed 
information from Date. Different locales have different conventions for displaying date and 
time. Should the year, month, or day be displayed first? Should slashes, periods, or colons be 
used to separate fields of the date? What are the names of the months in the language? The 
j ava . text . DateFormat class can be used to format date and time in a locale-sensitive way 
for display to the user. The Date class was introduced in §8.6.1, "The Date Class," and the 
Cal endar class and its subclass GregorianCal endar were introduced in §14.3, "Example: 
Calendar and GregorianCal endar." 

31.3.1 The TimeZone Class 

Ti meZone Ti meZone represents a time zone offset and also figures out daylight savings. To get a Ti meZone 

object for a specified time zone ID, use TimeZone. getTimeZone(id). To set a time zone in a 





Date 



Calendar 
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Calendar object, use the setTimeZone method with a time zone ID. For example, 
cal .setTimeZone(TimeZone.getTimeZone("CST")) sets the time zone to Central Stan- 
dard Time. To find all the available time zones supported in Java, use the static method 
getAvailableIDs() in the TimeZone class. In general, the international time zone ID is a 
string in the form of continent/city like Europe/Berlin, Asia/Taipei, and America/Washington. You 
can also use the static method getDefaul t() in the TimeZone class to obtain the default time 
zone on the host machine. 

31.3.2 The DateFormat Class 

The DateFormat class can be used to format date and time in a number of styles. The DateFormat 
DateFormat class supports several standard formatting styles. To format date and time, sim- 
ply create an instance of DateFormat using one of the three static methods 
getDatelnstance, getTimelnstance, and getDateTimelnstance and apply the 
format (Date) method on the instance, as shown in Figure 31.2. 



java. text.DateFormat 



+format(date : Date): String 
+getDateInstanceQ : DateFormat 
+getDateInstance(dateStyle: int): DateFormat 
+getDateInstance(dateStyle: int, aLocale: 

Locale): DateFormat 
+getDateTimeInstance() : DateFormat 

+getDateTi melnstance (dateStyl e : int, 

timeStyle: int): DateFormat 
+getDateTi melnstance (dateStyl e : int, 

timeStyle: int, aLocale: Locale): DateFormat 
+getlnstance() : DateFormat 



Formats a date into a date/time string. 

Gets the date formatter with the default formatting style for the default locale. 
Gets the date formatter with the given formatting style for the default locale. 
Gets the date formatter with the given formatting style for the given locale. 

Gets the date and time formatter with the default formatting style for the 
default locale. 

Gets the date and time formatter with the given date and time formatting 

styles for the default locale. 
Gets the date and time formatter with the given formatting styles for the given 

locale. 

Gets a default date and time formatter that uses the SHORT style for both the 
date and the time. 



Figure 3 1 .2 The DateFormat class formats date and time. 



The dateStyl e and timeStyle are one of the following constants: DateFormat . SHORT, 
DateFormat . MEDIUM, DateFormat . LONG, DateFormat . FULL. The exact result depends on 
the locale, but generally, 

■ SHORT is completely numeric, such as 7/24/98 (for date) and 4:49 PM (for time). 

■ MEDIUM is longer, such as 24-M-98 (for date) and 4:52:09 PM (for time). 

■ LONG is even longer, such as July 24, 1998 (for date) and 4:53: 16 PM EST (for time). 

■ FULL is completely specified, such as Friday, July 24, 1998 (for date) and 
4:54: 13 o'clock PM EST (for time). 

The statements given below display current time with a specified time zone (CST), formatting 
style (full date and full time), and locale (US). 

Gregori anCal endar calendar = new Gregori anCal endar() ; 
DateFormat formatter = DateFormat . getDateTi melnstance( 

DateFormat. FULL, DateFormat . FULL , Locale. US); 
TimeZone timeZone = TimeZone. getTimeZone("CST") ; 
formatter . setTimeZone (ti meZone) ; 
System. out. println("The local time is " + 

formatter . format (cal endar . getTi me())) ; 



1062 Chapter 3 1 Internationalization 



31.3.3 The SimpleDateFormat Class 

SimpleDateFormat The date and time formatting subclass, Simpl eDateFormat, enables you to choose any user- 

defined pattern for date and time formatting. The constructor shown below can be used to cre- 
ate a Simpl eDateFormat object, and the object can be used to convert a Date object into a 
string with the desired format. 

public Si mpleDateFormat (St ring pattern) 

The parameter pattern is a string consisting of characters with special meanings. For exam- 
ple, y means year, M means month, d means day of the month, C is for era designator, h means 
hour, m means minute of the hour, s means second of the minute, and z means time zone. 
Therefore, the following code will display a string like "Current time is 1997.11.12 AD at 
04:10:18 PST" because the pattern is "yyyy.MM.dd G 'at' hh:mm:ss z". 

SimpleDateFormat formatter 

= new SimpleDateFormat("yyyy.MM.dd G 'at' hh:mm:ss z") ; 
date currentTime = new Date(); 

String dateString = formatter . format(currentTi me) ; 
System. out. pri ntl n("Current time is " + dateString); 

3 1 .3.4 The DateFormatSymbol s Class 

DateFormatSymbol s The DateFormatSymbol s class encapsulates localizable date-time formatting data, such as 

the names of the months and the names of the days of the week, as shown in Figure 31.3. 

For example, the following statement displays the month names and weekday names for 
the default locale. 

DateFormatSymbol s symbols = new DateFormatSymbol s() ; 
String[] monthNames = symbols .getMonthsO ; 
for (int i = 0; i < monthNames . 1 ength ; i++) { 

System. out. println(monthNames[i]) ; // Display January, ... 

} 

String [] weekdayNames = symbol s. getWeekdays () ; 
for (int i = 0; i < weekdayNames . 1 ength ; i++) { 

System. out. pri ntl n (weekdayNames [i] ) ; // Display Sunday, Monday, ... 

} 




java.text.DateFormatSymbols 



+DateFormatSymbol s () 

+DateFormatSymbol s (1 ocal e : Local e) 

+getAmPmStri ngs() : String [] 

+getEras(): String[] 

+getMonths() : String[] 

+setMonths(newMonths : String[]): void 

+getShortMonths() : String[] 

+setShortMonths(newShortMonths : String []) : 
void 

+getWeekdays() : String[] 

+setWeekdays(newWeekdays : String[]): void 

+getShortWeekdays() : String[] 

+setShortWeekdays(newWeekdays: String []) : 
void 



Constructs a DateFormatSymbol s object for the default locale. 

Constructs a DateFormatSymbol s object for the given locale. 

Gets AM/PM strings. For example: "AM" and "PM". 

Gets era strings. For example: "AD" and "BC". 

Gets month strings. For example: "January", "February", etc. 

Sets month strings for this locale. 

Gets short month strings. For example: "Jan", "Feb", etc. 
Sets short month strings for this locale. 

Gets weekday strings. For example: "Sunday", "Monday", etc. 
Sets weekday strings. 

Gets short weekday strings. For example: "Sun", "Mon", etc. 
Sets short weekday strings. 



Figure 3 1 .3 The DateFormatSymbol s class encapsulates localizable date-time formatting data. 
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The following two examples demonstrate how to display date, time, and calendar based on lo- 
cale. The first example creates a clock and displays date and time in locale-sensitive format. 
The second example displays several different calendars with the names of the days shown in 
the appropriate local language. 

3 1 .3.5 Example: Displaying an International Clock 

Write a program that displays a clock to show the current time based on the specified locale 
and time zone. The locale and time zone are selected from the combo boxes that contain the 
available locales and time zones in the system, as shown in Figure 31.4. 
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Figure 3 1.4 The program displays a clock that shows the current time with the specified 
locale and time zone. 



Here are the major steps in the program: 

1. Define a subclass of JPanel named WorldClock (Listing 31.1) to contain an in- 
stance of the Still Clock class (developed in Listing 15.10, StillClock.java), and 
place it in the center. Create a J Label to display the digit time, and place it in the 
south. Use the GregorianCal endar class to obtain the current time for a specific 
locale and time zone. 

2. Define a subclass of J Panel named WorldClockControl (Listing 3 1 .2) to contain an 
instance of WorldClock and two instances of JComboBox for selecting locales and 
time zones. 

3. Define an applet named WorldClockApp (Listing 31.3) to contain an instance of 
WorldClockControl and enable the applet to run standalone. 

The relationship among these classes is shown in Figure 31.5. 



javax. swing .3 Panel [ 



_ 



WorldClock 



-clock: Still Clock 
-jlblDigitTime: J Label 
-timeZone: TimeZone 
-timer: Timer 



+WorldClock() 
+setTi meZone (ti meZone : 
TimeZone): void 



1 1, 



j avax . swi ng . J Panel 

zs: 



j avax . swi ng . 3 Appl et 

zs: 



WorldClockControl 



-clock: WorldClock 
-jcbLocales: JComboBox 
-jcbTimeZones : JComboBox 
-avail ableLocales: Local e[] 
-avail ableTimeZones: String[] 



+Worl dClockControl () 
-setAvailableLocales() : void 
-setAvailableTimeZonesQ : void 



1 1; 



WorldClockApp 



+WorldClockApp() 
+main(args: String[]): void 



Figure 31.5 WorldClockApp contains WorldClockControl , and WorldClockControl contains WorldClock. 
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Listing 3 1. 1 WorldClock. java 



create timer 
create clock 



timer listener class 



1 

2 
3 
4 
5 
6 
7 
8 
9 
10 
11 
12 
13 
14 
15 
16 
17 
18 
19 
20 
21 
22 
23 
24 
25 
26 
27 
28 
29 
30 
31 
32 
33 
34 
35 
36 
37 
38 
39 
40 



import javax. swi ng . * ; 

import java.awt.*; 

import java. awt . event .* ; 

import java. util .Calendar; 

import java. util .TimeZone; 

import java. util .CregorianCalendar; 

import java. text.*; 

public class WorldClock extends DPanel { 

private TimeZone timeZone = TimeZone. getTimeZone("EST") ; 
private Timer timer = new Timer(1000, new TimerLi stenerO) ; 
private StillClock clock = new StillClock(); 
private J Label jlblDigitTime = new lLabel("", J Label .CENTER) ; 

public WorldClockO { 

setLayout(new BorderLayoutO) ; 
add(clock, BorderLayout . CENTER) ; 
add (jlblDigitTime, BorderLayout . SOUTH) ; 
timer. start() ; 

} 

public void setTimeZone(TimeZone timeZone) { 
this. timeZone = timeZone; 

} 

private class Ti merLi stener implements Acti onLi stener { 
public void acti onPerformed(Acti onEvent e) { 

Calendar calendar = new GregorianCalendar(timeZone, getLocal e()) ; 

clock. setHour (calendar. get (Calendar. HOUR)) ; 

cl ock . setMi nute(cal endar . get (Cal endar . MINUTE)) ; 

cl ock . setSecond (cal endar . get (Cal endar . SECOND)) ; 

// Display digit time on the label 

DateFormat formatter = DateFormat . getDateTi melnstance 

(DateFormat. MEDIUM, DateFormat . LONG , getLocal e()) ; 
formatter . setTi meZone(ti meZone) ; 

j 1 bl Di gi tTi me . setText (formatter . format (cal endar . getTi me () ) ) ; 



Listing 3 1.2 WorldClockControl .java 

1 import javax. swing.*; 

2 import java.awt.*; 

3 import java. awt. event.*; 

4 import java. util.*; 
5 

6 public class WorldClockControl extends JPanel { 

7 // Obtain all available locales and time zone ids 

locales 8 private Local e[] avai 1 abl eLocal es = Local e. getAvai 1 abl eLocal es () ; 

time zones 9 private String [] avai 1 abl eTi meZones = Ti meZone. getAvai 1 abl elDs () ; 

10 

11 // Combo boxes to display available locales and time zones 
combo boxes 12 private JComboBox jcbLocales = new JComboBoxO; 

13 private JComboBox jcbTimeZones = new JComboBoxO; 
14 
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15 // Create a clock 

16 private WorldClock clock = new WorldClockO ; createclock 
17 

18 public WorldClockControl () { 

19 // Initialize jcbLocales with all available locales 

20 setAvailableLocalesO ; 
21 

22 // Initialize jcbTimeZones with all available time zones 

23 setAvailableTimeZonesO ; 
24 

2 5 // Initialize locale and time zone 

26 clock. setLocale( 

27 avai 1 abl eLocal es [ j cbLocal es . getSel ectedlndexO ] ) ; 

28 clock. setTi meZone (Ti meZone . getTi meZone ( 

29 avai 1 abl eTi meZones [ j cbTi meZones . getSel ectedlndexO ] ) ) I 
30 

31 J Panel panel 1 = new JPanelO; create UI 

32 panel 1 . setLayout(new GridLayout(2 , 1)); 

33 panel 1. add (new D Label ("Locale")) ; 

34 panel 1. add (new JLabel ("Time Zone")); 

35 JPanel panel2 = new JPanelO; 
36 

37 panel 2 . setLayout(new GridLayout(2 , 1)); 

38 panel 2 . add(jcbLocal es , BorderLayout . CENTER) ; 

39 panel 2 . add(jcbTimeZones , BorderLayout . CENTER) ; 
40 

41 J Panel panel 3 = new JPanelO; 

42 panel 3 . setLayout(new BorderLayoutO) ; 

43 panel 3 . add(panel 1, BorderLayout .WEST) ; 

44 panel 3 . add(panel 2 , BorderLayout .CENTER) ; 
45 

46 setLayout(new BorderLayoutO); 

47 add (panel 3, BorderLayout . NORTH) ; 

48 add(clock, BorderLayout . CENTER) ; 
49 

50 jcbLocales. addActionLi stener(new ActionLi stener() { newlocale 

51 public void actionPerformed(ActionEvent e) { 

52 clock. setLocale( 

53 avai 1 abl eLocal es [j cbLocal es . getSel ectedlndexO] ) ; 

54 } 

55 }); 

56 jcbTimeZones. addActi onLi stener(new Acti onLi stener() { newtimezone 

57 public void actionPerformed(ActionEvent e) { 

58 clock. setTi meZone (Ti meZone . getTi meZone ( 

59 avai 1 abl eTi meZones [jcbTimeZones . getSel ectedlndexO] )) ; 

60 } 

61 }); 

62 } 
63 

64 private void setAvailableLocalesO { 

65 for (int i = 0; i < avai 1 abl eLocal es . 1 ength ; i++) { 

66 jcbLocal es . addltem(avai 1 abl eLocal es [i ]. getDi spl ayName() + " " 

67 + avai 1 abl eLocal es [i ]. toStri ng()) ; 

68 } 

69 } 
70 

71 private void setAvailableTimeZonesO { 

72 // Sort time zones 

73 Arrays . sort(avai 1 abl eTi meZones) ; 

74 for (int i =0; i < avai lab! eTi meZones. length; i++) { 
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75 j cbTi meZones . addltem (avai 1 abl eTi meZones [i ] ) ; 

76 } 

77 } 

78 } 

Listing 31.3 WorldClockApp. java 

1 import javax. swing.*; 
2 

3 public class WorldClockApp extends DApplet { 

4 /** Construct the applet */ 

5 public WorldClockAppO { 

6 add(new WorldClockControl ()) ; 

7 } 

main method omitted 8 } 

The WorldClock class uses GregorianCal endar to obtain a Calendar object for the 
specified locale and time zone (line 28). Since Worl dCl ock extends JPanel , and every GUI 
component has the 1 ocal e property, the locale for the calendar is obtained from the 
WorldClock using getLocaleO (line 28). 

An instance of Still CI ock is created (line 12) and placed in the panel (line 17). The 
clock time is updated every one second using the current Cal endar object in lines 28-31. 

An instance of DateFormat is created (lines 34-35) and is used to format the date in ac- 
cordance with the locale (line 37). 

The WorldClockControl class contains an instance of WorldClock and two combo 
boxes. The combo boxes store all the available locales and time zones (lines 64-77). The 
newly selected locale and time zone are set in the clock (lines 50-61) and used to display a 
new time based on the current locale and time zone. 

3 1 .3.6 Example: Displaying a Calendar 

Write a program that displays a calendar based on the specified locale, as shown in Figure 
31.6. The user can specify a locale from a combo box that consists of a list of all the available 
locales supported by the system. When the program starts, the calendar for the current month 
of the year is displayed. The user can use the Prior and Next buttons to browse the calendar. 
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Figure 3 1.6 The calendar applet displays a calendar with a specified locale. 

Here are the major steps in the program: 

1. Create a subclass of JPanel named CalendarPanel (Listing 31.4) to display the cal- 
endar for the given year and month based on the specified locale and time zone. 
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2. Create an applet named CalendarApp (Listing 31.5). Create a panel to hold an in- 
stance of Cal endarPanel and two buttons, Prior and Next. Place the panel in the cen- 
ter of the applet. Create a combo box and place it in the south of the applet. The 
relationships among these classes are shown in Figure 31.7. 



javax . swi ng . J Panel 



CalendarPanel 



-month: int 
-year: int 

-calendar: java.util .Calendar 



+getMonth(): int 
+setMonth(newMonth : int): void 
+getYear(): int 
+setYear(newYear : int): void 
+setl_ocal e(newLocal e : Locale): void 
+showHeader() : void 
+showDayNames() : void 
+showDays(): void 



javax .swing .J Applet | 

T 

CalendarApp 



-cal endarPanel : CalendarPanel 
- j boLocal e : javax . swi ng . DComboBox 
-jbtPrior: javax. swi ng.D Button 
-jbtNext: javax. swing.] Button 
-locales: java.util .Local e[] 

+init(): void 

+main(args: Strings[]): void 



Figure 31.7 CalendarApp contains CalendarPanel. 



Listing31.4 CalendarPanel .java 



i 

2 
3 
4 
5 
6 
7 
8 
9 
10 
11 
12 
13 
14 
15 
16 
17 
18 
19 
20 
21 
22 
23 
24 
25 
26 
27 
28 
29 



import java.awt.*; 

import javax. swing.*; 

import javax. swi ng . border . Li neBorder ; 

import java.util.*; 

import j ava . text . * ; 

public class CalendarPanel extends JPanel { 

// The header label 

private JLabel jlblHeader = new DLabel(" ' 



1 Label .CENTER) ; 



// Maximum number of labels to display day names and days 
private J Label [] jlblDay = new ]Label[49]; 

private Calendar calendar; 

private int month; // The specified month 

private int year; // The specified year 

// Panel jpDays to hold day names and days 

private JPanel jpDays = new JPanel(new CridLayout(0, 7)); 

public Cal endarPanel () { 

// Create labels for displaying days 
for (int i = 0; i < 49; i++) { 
jlblDay[i] = new DLabelO; 

jlblDay[i] . setBorder(new LineBorder(Color. black, 1)); 
jlblDay[i] .setHorizontalAlignment(]Label .RIGHT) ; 
jlblDay[i] .setVerticalAlignment(JLabel .TOP) ; 

} 



label for header 



labels for days 



calendar 

month 

year 



panel for days 



create labels 
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place header 
place day 

get current calendar 



update calendar 



show header 
show days 



show header 



new header 



get day names 



empty jpDays panel 
display day names 



days before this month 



30 
31 
32 
33 
34 
35 
36 
37 
38 
39 
40 
41 
42 
43 
44 
45 
46 
47 
48 
49 
50 
51 
52 
53 
54 
55 
56 
57 
58 
59 
60 
61 
62 
63 
64 
65 
66 
67 
68 
69 
70 
71 
72 
73 
74 
75 
76 
77 
78 
79 
80 
81 
82 
83 
84 
85 
86 
87 
88 
89 
90 



// Place header and calendar body in the panel 
this. setLayout (new BorderLayoutO) ; 
this. add(jlbl Header, BorderLayout . NORTH) ; 
this.add(jpDays, BorderLayout. CENTER) ; 

// Set current month and year 
calendar = new Cregori anCal endar() ; 
month = calendar. get(Cal endar . MONTH) ; 
year = calendar. get(Cal endar . YEAR) ; 
updateCal endar () ; 

// Show calendar 
showHeaderO ; 
showDays () ; 



7 



/** Update the header based on locale 
private void showHeaderO { 

SimpleDateFormat sdf = 

new SimpleDateFormat("MMMM yyyy" , getLocal e()) ; 

String header = sdf .format(calendar.getTime()) ; 

j 1 bl Header . setText(header) ; 

} 

/** Update the day names based on locale */ 
private void showDayNames() { 

DateFormatSymbol s dfs = new DateFormatSymbols(getLocaleO) ; 

String dayNames[] = dfs.getWeekdays() ; 

// jlblDay[0], jlblDay[l], jlblDay[6] for day names 

for (int i = 0; i < 7; i++) { 

jlblDay[i] . setText(dayNames [i + 1]); 

jlblDay[i] . setHori zontal Al ignmentCJLabel .CENTER) ; 

jpDays.add(jlblDay[i]) ; // Add to jpDays 

} 

} 

/ ** Display days */ 
public void showDaysO { 

jpDays . removeAll () ; // Remove all labels from jpDays 

showDayNamesO ; // Display day names 

// Get the day of the first day in a month 

int startingDayOf Month = cal endar. get (Cal endar. DAY_0F_WEEK) ; 

// Fill the calendar with the days before this month 
Calendar cloneCalendar = (Calendar)calendar.clone() ; 
cl oneCal endar . add(Cal endar . DATE , -1); // Becomes preceding month 
int daysInPrecedi ngMonth = cloneCalendar. getActualMaximum( 
Cal endar . DAY_0F_M0NTH) ; 



for (int i = 0; i < starti ngDayOfMonth - 1; i++) 
jlblDay[i + 7] . set Foreground (Col or . LIGHT_GRAY) 
jlblDay[i + 7] . setText(daysInPrecedi ngMonth - 

starti ngDayOfMonth + 2 + i + ""); 
jpDays.add(jlblDay[i + 7]); // Add to jpDays 



{ 



} 



// Display days of this 
int daysInCurrentMonth = 



month 

■■ calendar. getActualMaximum( 
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91 Cal endar . DAY_0F_M0NTH) ; 

92 for (int i = 1; i <= daysInCurrentMonth ; i++) { days in this month 

93 jlblDay[i - 2 + starti ngDayOf Month + 7]. 

94 setForeground(Color.black) I 

95 jlblDay[i - 2 + starti ngDayOfMonth + 7].setText(i + "") ; 

96 jpDays.add(jlblDay[i - 2 + starti ngDayOfMonth + 7]); 

97 } 
98 

99 // Fill the calendar with the days after this month 

100 int j = 1; 

101 for (int i = daysInCurrentMonth - 1 + starti ngDayOfMonth + 7; days after this month 

102 i % 7 != 0; i++) { 

103 jlblDay[i] . setForeg round (Col or . LIGHT_GRAY) ; 

104 jlblDay[i] .setText(j++ + ""); 

105 jpDays.add(jlblDay[i]); // Add to jpDays 

106 } 
107 

108 j pDays . repai nt() ; // Repaint the labels in jpDays repaint jpDays 

109 } 
110 

111 /** Set the calendar to the first day of the 

112 * specified month and year */ 

113 public void updateCalendar() { update calendar 

114 calendar. set(Cal endar . YEAR, year); 

115 cal endar. set(Cal endar. MONTH, month); 

116 calendar. set(Cal endar . DATE, 1); 

117 } 
118 

119 /** Return month */ 

120 public int getMonth() { 

121 return month; 

122 } 
123 

124 /** Set a new month */ 

125 public void setMonth(int newMonth) { set new month 

126 month = newMonth; 

127 updateCalendar() ; 

128 showHeader() ; 

129 showDaysO; 

130 } 
131 

132 /** Return year */ 

133 public int getYear() { 

134 return year; 

135 } 
136 

137 /** Set a new year */ 

138 public void setYear(int newYear) { set new year 

139 year = newYear; 

140 updateCalendar() ; 

141 showHeader() ; 

142 showDaysO; 

143 } 
144 

145 /** Set a new locale */ 

146 public void changeLocal e(Local e newLocale) { set new locale 

147 setLocal e (newLocal e) ; 

148 showHeader() ; 

149 showDaysO; 

150 } 



151 } 
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showHeader 



showDayNames 



showDays 



calendar panel 



combo box 



locales 



create UI 



Cal endarPanel is created to control and display the calendar. It displays the month and year 
in the header, and the day names and days in the calendar body. The header and day names are 
locale sensitive. 

The showHeader method (lines 47-52) displays the calendar title in a form like "MMMM 
yyyy". The Simpl eDateFormat class used in the showHeader method is a subclass of 
DateFormat. Simpl eDateFormat allows you to customize the date format to display the 
date in various nonstandard styles. 

The showDayNames method (lines 55-65) displays the day names in the calendar. The 
DateFormatSymbol s class used in the showDayNames method is a class for encapsulating 
localizable date-time formatting data, such as the names of the months, the names of the days 
of the week, and the time-zone data. The getWeekdays method is used to get an array of day 
names. 

The showDays method (lines 68-109) displays the days for the specified month of the 
year. As you can see in Figure 3 1 .6, the labels before the current month are filled with the last 
few days of the preceding month, and the labels after the current month are filled with the first 
few days of the next month. 

To fill the calendar with the days before the current month, a clone of cal endar, named 
cloneCalendar, is created to obtain the days for the preceding month (line 77). 
cl oneCal endar is a copy of cal endar with separate memory space. Thus you can change 
the properties of cloneCalendar without corrupting the calendar object. The clone() 
method is defined in the Object class, which was introduced in §14.7, "Example: The 
Cl oneabl e Interface." You can clone any object as long as its defining class implements the 
Cl oneabl e interface. The Cal endar class implements Cl oneabl e. 

The cl oneCal endar . getActual Maximum (Cal endar . DAY_0F_M0NTH) method (lines 
90-91) returns the number of days in the month for the specified calendar. 

Listing 31.5 CalendarApp. java 

1 import java.awt.*; 

2 import java.awt. event.*; 

3 import javax. swi ng . * ; 

4 import javax. swing. border.*; 

5 import java.util.*; 
6 

7 public class CalendarApp extends JApplet { 

8 // Create a Cal endarPanel for showing calendars 

9 private Cal endarPanel cal endarPanel = new Cal endarPanel () ; 
10 

11 // Combo box for selecting available locales 

12 private JComboBox jcboLocale = new IComboBoxO; 
13 

14 // Declare locales to store available locales 

15 private Local e[] locales = Cal endar . getAvai 1 abl eLocal es () ; 
16 

17 // Buttons Prior and Next for displaying prior and next month 

18 private JButton jbtPrior = new JButton("Prior") ; 

19 private JButton jbtNext = new DButton("Next") ; 
20 

21 /** Initialize the applet */ 

22 public void init() { 

23 // Panel jpLocale to hold the combo box for selecting locales 

24 J Panel jpLocale = new J Panel (new Fl owLayoutO) ; 

25 jpLocale. setBorder(new Ti tl edBorder("Choose a locale")); 

26 jpLocale. add(jcboLocale) ; 



27 
28 
29 



// Initialize the combo box to add locale names 
for (int i = 0; i < local es . 1 ength ; i++) 
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30 jcboLocal e . addltem(l ocal es [i ] . getDi spl ayNameO) ; 
31 

32 // Panel jpButtons to hold buttons 

33 JPanel jpButtons = new JPanel(new Fl owLayoutO) ; 

34 jpButtons .add(jbtPrior) ; 

35 jpButtons .add(jbtNext) ; 
36 

37 // Panel jpCalendar to hold cal endarPanel and buttons 

38 JPanel jpCalendar = new ]Panel(new BorderLayoutO) ; 

39 jpCalendar. add(calendarPanel , BorderLayout . CENTER) ; 

40 jpCalendar. add(jpButtons , BorderLayout . SOUTH) ; 
41 

42 // Place jpCalendar and jpLocale to the applet 

43 add(jpCalendar, BorderLayout .CENTER) ; 

44 add (jpLocale, BorderLayout . SOUTH) ; 
45 

46 // Register listeners 

47 jcboLocale.addActionListener(new ActionLi stenerO { 

48 public void actionPerformed(ActionEvent e) { 

49 if (e.getSourceO == jcboLocale) 

50 cal endarPanel .changeLocale( set a new locale 

51 locales[jcboLocale.getSelectedIndex()]) ; 

52 } 

53 }); 
54 

55 jbtPrior.addActionListener(new ActionLi stenerO { 

56 public void actionPerformed(ActionEvent e) { 

57 int currentMonth = cal endarPanel .getMonthO ; 

58 if (currentMonth == 0) // The previous month is 11 for Dec 

59 cal endarPanel . setYear(cal endarPanel . getYear() - 1); 

60 cal endarPanel . setMonth((currentMonth - 1) % 12); previous month 

61 }}); 
62 

63 jbtNext.addActionListener(new ActionLi stenerO { 

64 public void actionPerformed(ActionEvent e) { 

65 int currentMonth = cal endarPanel .getMonthO I 

66 if (currentMonth == 11) // The next month is for Jan 

67 cal endarPanel . setYear(cal endarPanel . getYear() + 1); 
68 

69 calendarPanel . setMonth((currentMonth + 1) % 12); nextmonth 

70 }}); 
71 

72 calendarPanel .changeLocale( 

73 locales[jcboLocale.getSelectedIndex()]) ; 

74 } 

75 } main method omitted 



Cal endarApp creates the user interface and handles the button actions and combo box item 
selections for locales. The Calendar .getAvailableLocalesO method (line 15) is used 
to find all the available locales that have calendars. Its getDi splayNameO method returns 
the name of each locale and adds the name to the combo box (line 30). When the user selects 
a locale name in the combo box, a new locale is passed to cal endarPanel , and a new cal- 
endar is displayed based on the new locale (lines 72-73). 

31.4 Formatting Numbers 

Formatting numbers is highly locale dependent. For example, number 5000.555 is dis- 
played as 5,000.555 in the United States, but as 5 000,555 in France and as 5.000,555 in 
Germany. 
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Numbers are formatted using the java. text. Number Format class, an abstract base 
class that provides the methods for formatting and parsing numbers, as shown in Figure 31.8. 



java. text.NumberFormat 



+getlnstance() : NumberFormat 
+getInstance(locale: Locale): NumberFormat 



+getlntegerlnstance() : NumberFormat 
+getIntegerInstance(locale: Locale) : 

NumberFormat 
+getCurrencyInstance() : NumberFormat 
+getNumberInstance() : NumberFormat 

+getNumberInstance(locale: Locale) : 

NumberFormat 
+getPercentInstance() : NumberFormat 

+getPercentInstance(locale: Locale) : 

NumberFormat 
+format(number: double): String 

+format(number: long): String 

+getMaximumFractionDigits() : int 

+setMaximumFractionDigits(newValue: int) : 
void 

+getMinimumFractionDigits() : int 

+setMinimumFractionDigits(newValue: int) : 
void 

+getMaximumIntegerDigits() : int 



+setMaximumIntegerDigits(newValue: int) : 
void 

+getMinimumIntegerDigits() : int 



+setMinimumIntegerDigits(newValue: int) : 
void 

+i sCroupi ngUsed() : boolean 



+setCroupingUsed(newValue: boolean): void 
+parse(source : String): Number 
+getAvailableLocales() : Local e[] 



Returns the default number format for the default locale. 
Returns the default number format for the specified locale. 
Returns an integer number format for the default locale. 
Returns an integer number format for the specified locale. 

Returns a currency format for the current default locale. 

Same as getlnstance(). 

Same as getlnstance(locale). 

Returns a percentage format for the default locale. 
Returns a percentage format for the specified locale. 

Formats a floating-point number. 
Formats an integer. 

Returns the maximum number of allowed fraction digits. 
Sets the maximum number of allowed fraction digits. 

Returns the minimum number of allowed fraction digits. 
Sets the minimum number of allowed fraction digits. 

Returns the maximum number of allowed integer digits in a 
fraction number. 

Sets the maximum number of allowed integer digits in a 
fraction number. 

Returns the minimum number of allowed integer digits in a 
fraction number. 

Sets the minimum number of allowed integer digits in a 
fraction number. 

Returns true if grouping is used in this format. For example, in 
the English locale, with grouping on, the number 1234567 is 
formatted as "1,234,567". 

Sets whether or not grouping will be used in this format. 

Parses string into a number. 

Gets the set of locales for which NumberFormats are installed. 



Figure 3 1.8 The NumberFormat class provides the methods for formatting and parsing numbers. 

With NumberFormat, you can format and parse numbers for any locale. Your code will be 
completely independent of locale conventions for decimal points, thousands-separators, currency 
format, and percentage formats. 



31.4-1 Plain Number Format 

You can get an instance of NumberFormat for the current locale using NumberFormat. 
getlnstanceO or NumberFormat. getNumberlnstance and for the specified locale 
using NumberFormat . getInstance(Local e) or NumberFormat . getNumberlnstance- 
(Locale). You can then invoke format (number) on the NumberFormat instance to return 
a formatted number as a string. 
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For example, to display number 5000.555 in France, use the following code: 

NumberFormat numberFormat = NumberFormat.getInstance(Locale. FRANCE) ; 
System . out . pri ntl n (numberFormat . format (5000. 555)) ; 

You can control the display of numbers with such methods as setMaximumFractionDigi ts 
and setMinimumFractionDigits. For example, 5000.555 will be displayed as 5000.6 if 
you use numberFormat. setMaximumFractionDigits(l). 

3 1 .4.2 Currency Format 

To format a number as a currency value, use NumberFormat .getCurrencylnstanceO to 
get the currency number format for the current locale or NumberFormat. getCurrency- 
lnstanceO Local e) to get the currency number for the specified locale. 

For example, to display number 5000.555 as currency in the United States, use the follow- 
ing code: 

NumberFormat currencyFormat = 

NumberFormat . getCurrency Instance (Local e . US) ; 
System . out . pri ntl n (currencyFormat . format (5000. 555)) ; 

5000.555 is formatted into $5,000,56. If the locale is set to France, the number will be formatted 
into 5 000,56 € . 

31.4-3 Percent Format 

To format a number in a percent, use NumberFormat . getPercentlnstanceO or Number- 
Format . getPercentInstance(Local e) to get the percent number format for the current 
locale or the specified locale. 

For example, to display number 0.555367 as a percent in the United States, use the following 
code: 

NumberFormat percentFormat = 

NumberFormat . getPercentlnstance (Local e . US) ; 
System . out . pri ntl n (percentFormat . format (0. 555367)) ; 

0.555367 is formatted into 56%. By default, the format truncates the fraction part in a percent 
number. If you want to keep three digits after the decimal point, use percentFormat. 
setMinimumFractionDigits (3). So 0.555367 would be displayed as 55.537%. 

31.4-4 Parsing Numbers 

You can format a number into a string using the format (numerical Val ue) method. You can 
also use the parse(String) method to convert a formatted plain number, currency value, or 
percent number with the conventions of a certain locale into an instance of java.lang. 
Number. The parse method throws a java . text . ParseException if parsing fails. For ex- 
ample, U.S. $5,000.56 can be parsed into a number using the following statements: 

NumberFormat currencyFormat = 

NumberFormat . getCurrency Instance (Local e . US) ; 
try { 

Number number = currencyFormat . parse("$5 ,000. 56") ; 
System . out . pri ntl n (numbe r . doubl eVal ue () ) ; 

} 

catch (java. text. ParseException ex) { 
System. out. pri ntl n("Parse failed") ; 

} 
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31.4-5 The Decimal Format Class 

If you want even more control over the format or parsing, cast the NumberFormat you get 
from the factory methods to a java.text.DecimalFormat, which is a subclass of 
NumberFormat. You can then use the applyPattern (String pattern) method of the 
Decimal Format class to specify the patterns for displaying the number. 

A pattern can specify the minimum number of digits before the decimal point and the max- 
imum number of digits after the decimal point. The characters ' ' and 1 # ' are used to spec- 
ify a required digit and an optional digit, respectively. The optional digit is not displayed if it 
is zero. For example, the pattern "00.0##" indicates minimum two digits before the decimal 
point and maximum three digits after the decimal point. If there are more actual digits before 
the decimal point, all of them are displayed. If there are more than three digits after the deci- 
mal point, the number of digits is rounded. Applying the pattern "00 . 0##", number 111 . 2226 
is formatted to 111 . 223, number 1111 . 2226 to 1111 . 223, number 1 . 22 to 01 . 22, and num- 
ber 1 to 01 . 0. Here is the code: 

NumberFormat numberFormat = NumberFormat . getInstance(Local e . US) ; 

Decimal Format decimal Format = (Decimal Format)numberFormat ; 

deci mal Format . appl yPattern ("00 . 0##") ; 

System . out . pri ntl n (deci mal Format . format (111 . 2226)) ; 

System . out . pri ntl n (deci mal Format . format (11 11 . 2226)) ; 

System .out .pri ntl n (deci mal Format . format (1 . 22)) ; 

System . out . pri ntl n (deci mal Format . format (1)) ; 

The character 1 % ' can be put at the end of a pattern to indicate that a number is formatted as 
a percentage. This causes the number to be multiplied by 100 and appends a percent sign %. 



31.4-6 Example: Formatting Numbers 

Create a loan calculator for computing loans. The calculator allows the user to choose locales, 
and displays numbers in accordance with locale-sensitive format. As shown in Figure 31.9, 
the user enters interest rate, number of years, and loan amount, then clicks the Compute but- 
ton to display the interest rate in percentage format, the number of years in normal number 
format, and the loan amount, total payment, and monthly payment in currency format. Listing 
31.6 gives the solution to the problem. 

Listing 3 1.6 NumberFormatDemo . java 

1 import java.awt.*; 

2 import java.awt. event.*; 

3 import javax. swing.*; 

4 import javax. swing. border.*; 

5 import java.util.*; 

6 import java. text. NumberFormat; 
7 

8 public class NumberFormatDemo extends JApplet { 

9 // Combo box for selecting available locales 

UI components 10 private JComboBox jcboLocale = new JComboBoxO ; 

11 

12 // Text fields for interest rate, year, and loan amount 

13 private JTextField jtf InterestRate = new JTextField("6.75") ; 

14 private JTextField jtfNumberOfYears = new JTextField("15") ; 

15 private JTextField jtf LoanAmount = new JTextFi eld ("107000") ; 

16 private JTextFi eld jtf FormattedlnterestRate = new JTextFi el d(10) ; 

17 private JTextField jtf FormattedNumberOfYears = new JTextFi eld (10) ; 

18 private JTextField jtf FormattedLoanAmount = new JTextFi eld (10) ; 
19 

20 // Text fields for monthly payment and total payment 
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21 private JTextField jtfTotal Payment = new ]TextField() ; 

22 private JTextField jtf Month! yPayment = new JTextFieldO; 
23 

24 // Compute button 

25 private JButton jbtCompute = new JButton("Compute") ; 
26 

27 // Current locale 

28 private Locale locale = Locale. getDefaultO ; 
29 

30 // Declare locales to store available locales 

31 private Locale[] locales = Calendar. getAvailableLocalesO ; 
32 

33 /** Initialize the combo box */ 

34 public void i ni ti al i zeComboBoxO { 

35 // Add locale names to the combo box 

36 for (int i = 0; i < 1 ocal es . 1 ength ; i++) 

37 jcboLocale.addItem(locales[i] .getDisplayNameO) ; 

38 } 
39 

40 /** Initialize the applet */ 

41 public void init() { 

42 // Panel pi to hold the combo box for selecting locales create UI 

43 DPanel pi = new 3Panel(); 

44 pi. setLayout(new FlowLayoutO) ; 

45 pl.add(jcboLocale) ; 

46 i ni ti al i zeComboBoxO ; 

47 pi. setBorder(new Ti tl edBorder("Choose a Locale")); 
48 

49 // Panel p2 to hold the input 

50 3 Panel p2 = new JPanelO; 

51 p2 . setLayout(new GridLayout(3 , 3)); 

52 p2.add(new JLabel ("Interest Rate")); 

53 p2 .add(jtflnterestRate) ; 

54 p2 .add(jtfFormattedlnterestRate) ; 

55 p2.add(new DLabel ("Number of Years")); 

56 p2 .add(jtfNumberOfYears) ; 

57 p2 .add(jtfFormattedNumberOfYears) ; 

58 p2. add (new J Label ("Loan Amount")); 

59 p2 .add(jtfLoanAmount) ; 

60 p2 .add(jtfFormattedLoanAmount) ; 

61 p2 . setBorder(new Ti tl edBorder("Enter Annual Interest Rate, " + 

62 "Number of Years, and Loan Amount")); 

63 

64 // Panel p3 to hold the result 

65 JPanel p3 = new JPanelO; 

66 p3 . setLayout(new GridLayout(2 , 2)); 

67 p3.setBorder(new TitledBorder("Payment")) ; 

68 p3. add (new DLabel ("Monthly Payment")); 

69 p3. add (jtfMonthl yPayment) ; 

70 p3. add (new DLabel ("Total Payment")); 

71 p 3. add (jtf Total Payment) ; 
72 

73 // Set text field alignment 

74 jtf FormattedlnterestRate . setHori zontalAl i gnment (JTextFi el d . RIGHT) ; 

75 j tf FormattedNumberOf Years . setHori zontal Al i gnment ( JTextFi el d . RIGHT) ; 

76 jtf FormattedLoanAmount . setHori zontalAl i gnment (JTextFi el d . RIGHT) ; 

77 j tfTotal Payment . setHori zontal Al i gnment (DTextFi eld. RIGHT) ; 

78 j tf Monthl yPayment . setHori zontalAl i gnment (JTextFi el d . RIGHT) ; 
79 

80 // Set editable false 
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register listener 

new locale 
compute loan 



register listener 



compute loan 



81 
82 
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84 
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130 
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134 
135 
136 
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138 
139 
140 



j tf FormattedlnterestRate . setEdi tabl e (fal se) ; 
j tf FormattedNumberOf Years .setEdi tabl e (fal se) ; 
jtf Formatted LoanAmount . setEdi tabl e (fal se) ; 
j tfTotal Payment .setEdi tabl e (fal se) ; 
j tf Month! yPayment . setEdi tabl e (fal se) ; 

// Panel p4 to hold result payments and a button 

3 Panel p4 = new JPanelO; 

p4 . setLayout(new BorderLayoutO) ; 

p4.add(p3, BorderLayout. CENTER) ; 

p4.add(jbtCompute, BorderLayout . SOUTH) ; 

// Place panels to the applet 
add(pl, Borde rLayout. NORTH) ; 
add(p2, BorderLayout. CENTER) ; 
add(p4, BorderLayout. SOUTH) ; 

// Register listeners 

jcboLocal e . addActi onLi stener(new Acti onLi stener() { 
public void acti onPerformed (Acti onEvent e) { 

locale = locales[jcboLocale.getSelectedIndex()] ; 
computeLoanO ; 

} 

}); 

jbtCompute.addActionListener(new Acti onLi stener() { 
public void actionPerformed(ActionEvent e) { 
computeLoanO ; 

} 

}); 

} 

/** Compute payments and display results locale-sensitive format */ 
private void computeLoanO { 
// Retrieve input from user 

double loan = new Double(jtfLoanAmount.getTextO) . doubl eVal ue() ; 
double interestRate = 

new Double(jtflnterestRate.getTextO) . doubl eVal ue() / 1240; 
int numberOfYears = 

new Integer (jtf NumberOfYears . getTextO) . i ntVal ue() ; 

// Calculate payments 

double monthl yPayment = loan * interestRate/ 

(1 - (Math.pow(l / (1 + interestRate), numberOfYears * 12))); 
double totalPayment = monthl yPayment * numberOfYears * 12; 

// Get formatters 

NumberFormat percentFormatter = 

Number Format . getPercentlnstance (1 ocal e) ; 
NumberFormat currencvForm = 

NumberFormat . getCurrencylnstance (local e) ; 

NumberFormat numberForm = NumberFormat. getNumberlnstance(locale) ; 
percentFormatter . setMi nimumFractionDi gits (2) ; 

// Display formatted input 

jtf FormattedlnterestRate . setText( 

percentFormatter . format(i nterestRate * 12)); 
jtf FormattedNumberOfYears . setText 

(numberForm. format(numberOfYears) ) ; 
jtf Formatted LoanAmount . setText (currency Form . format (loan) ) ; 
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141 

142 // Display results in currency format 

143 jtf Monthly Payment . setText (currency Form. format (monthly Payment) ) ; 

144 j tfTotal Payment . setText (cu r rency Fo rm . format (total Payment) ) ; 

145 } 

146 } main method omitted 



I NumberFormatDemo 



Choose a Locale 



English (United States) 



Enter Annual interest Kate, Nuiriher or Years, and Loan Amount 
interest Rate 
Number of Years 
Loan Amount 



6.75 


6 53 % 


15 


15 


1D700D 


J107.DO0.0D 



Payment 

Merit lily Payment 

Total Payment 



$033.38 
$163,117.01 



Compute 



I NumberFormatDemo 



Choose a Locale 



Spanish (Panama) 



kilter Annual interest Kate, Number ot Years, and Loan Amount 
Inter Q5t Rate 
Number of Years 
Loan Amount 



6.75 


■: 53 % 


15 


15 


1D700D 


B107.DO0.0D 



Payment 
Monthly Payment 
Total Payment 



BS33.QS 
B168.117.D1 



Compute 



Figure 3 1.9 The locale determines the format of the numbers displayed in the loan calculator. 



The computeLoan method (lines 1 14-145) gets the input on interest rate, number of years, 
and loan amount from the user, computes monthly payment and total payment, and displays 
annual interest rate in percentage format, number of years in normal number format, and loan 
amount, monthly payment, and total payment in locale-sensitive format. 

The statement percentFormatter.setMinimumFractionDigits(2) (line 133) sets 
the minimum number of fractional parts to 2. Without this statement, . 075 would be displayed 
as 7% rather than 7.5%. 



3 1.5 Resource Bundles 

The NumberFormatDemo in the preceding example displays the numbers, currencies, and 
percentages in local customs, but displays all the message strings, titles, and button labels in 
English. In this section, you will learn how to use resource bundles to localize message 
strings, titles, button labels, and so on. 

A resource bundle is a Java class file or text file that provides locale-specific information, resource bundle 
This information can be accessed by Java programs dynamically. When a locale-specific re- 
source is needed — a message string, for example — your program can load it from the re- 
source bundle appropriate for the desired locale. In this way, you can write program code that 
is largely independent of the user's locale, isolating most, if not all, of the locale-specific in- 
formation in resource bundles. 

With resource bundles, you can write programs that separate the locale-sensitive part of 
your code from the locale-independent part. The programs can easily handle multiple locales, 
and can easily be modified later to support even more locales. 

The resources are placed inside the classes that extend the ResourceBundl e class or a 
subclass of ResourceBundl e. Resource bundles contain key/value pairs. Each key uniquely 
identifies a locale-specific object in the bundle. You can use the key to retrieve the object. 
ListResourceBundle is a convenient subclass of ResourceBundl e that is often used to 
simplify the creation of resource bundles. Here is an example of a resource bundle that con- 
tains four keys using ListResourceBundle: 

// MyResource . java: resource file 

public class MyResource extends java. uti 1 . Li stResourceBundle { 
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static final 0bject[][] contents = { 
{"national Flag", "us.gif"}, 
{"national Anthem" , "us.au"}, 
{"national Col or" , Color. red}, 
{"annualGrowthRate" , new Double(7.8)} 

}; 

public 0bject[][] getContents() { 
return contents; 

} 

} 

Keys are case-sensitive strings. In this example, the keys are national Fl ag, national Anthem, 
national Col or, and annualGrowthRate. The values can be any type of Object. 

If all the resources are strings, they can be placed in a convenient text file with the exten- 
sion .properties. A typical property file would look like this: 

#Wed Jul 01 07:23:24 EST 1998 
nati onal Fl ag=us . gi f 
nati onal Anthem=us . au 

To retrieve values from a ResourceBundl e in a program, you first need to create an instance 
of ResourceBundl e using one of the following two static methods: 

public static final ResourceBundle getBundle(String baseName) 
throws Mi ssi ngResourceException 

public static final ResourceBundle getBundle 

(String baseName, Locale locale) throws Mi ssi ngResourceException 

The first method returns a ResourceBundle for the default locale, and the second method 
returns a ResourceBundle for the specified locale. baseName is the base name for a set of 
classes, each of which describes the information for a given locale. These classes are named 
in Table 31.3. 

For example, MyResource_en_BR.class stores resources specific to the United Kingdom, 
My Resource_en_US. class stores resources specific to the United States, and 
MyResource_en. class stores resources specific to all the English-speaking countries. 

Table 31.3 Resource Bundle Naming Conventions 

1 . BaseName_language_country_variant.class 

2. BaseName_language_country.class 

3. BaseName_language.class 

4. BaseName.class 

5 . BaseName_language_country_variant.properties 

6 . B aseName_language_country. properties 

7. BaseName_language.properties 

8. BaseName.properties 

The getBundl e method attempts to load the class that matches the specified locale by lan- 
guage, country, and variant by searching the file names in the order shown in Table 31.3. The 
files searched in this order form a resource chain. If no file is found in the resource chain, the 
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getBundle method raises a MissingResourceException, a subclass of 
RuntimeException. 

Once a resource bundle object is created, you can use the getObject method to retrieve 
the value according to the key. For example, 

ResourceBundle res = ResourceBundl e . getBundl e("MyResource") ; 
String flagFile = (Stri ng) res . getObject("national Flag") ; 
String anthemFile = (Stri ng) res . getObject("national Anthem") ; 
Color color = (Color) res . getObject("nationalColor") ; 
double growthRate = (Doubl e) res . getObject("annualGrowthRate") 



Hi Tip 

[f the resource value is a string, the convenient getString method can be used to replace the 
getObject method. The getString method simply casts the value returned by getObject 
to a string. 

What happens if a resource object you are looking for is not defined in the resource bundle? 
Java employs an intelligent look-up scheme that searches the object in the parent file along 
the resource chain. This search is repeated until the object is found or all the parent files in the 
resource chain have been searched. A MissingResourceException is raised if the search 
is unsuccessful. 

Let us modify the NumberFormatDemo program in the preceding example so that it dis- 
plays messages, title, and button labels in multiple languages, as shown in Figure 31.10. 

You need to provide a resource bundle for each language. Suppose the program supports 
three languages: English (default), Chinese, and French. The resource bundle for the English 
language, named MyResource.properties, is given as follows: 

#MyResource . properti es for English language 
Number_Of_Years=Years 
Total_Payment=French Total\ Payment 

Enter_Interest_Rate=Enter\ Interest\ Rate,\ Years, \ and\ Loan\ Amount 

Payment=Payment 

Compute=Compute 

Annual _Interest_Rate=Interest\ Rate 
Number_Formatti ng=Number\ Formatting\ Demo 
Loan_Amount=Loan\ Amount 
Choose_a_Local e=Choose\ a\ Locale 
Month! y_Payment=Monthly\ Payment 



S Resou rceBu nd leDemo 



9 Resou rceBu nd leDemo 


-|n|x| 


Choisir la localite 


French (France) 







inscrire letaux d'interet, les annees, et le montant clu pret 



le taux d'iiiteret 


6.75 


6,53% 


annees 


15 


15 


Le montant clu pret 


107000 


107 000,00 € 


liaiement 






versement mensuel 




933,98 € 


reglement total 




168 117,01 € 



Calculer I'hypothecjue 



Chinese I Singapore) 



mm 


6.75 


6.53% 




15 


-a S ||| 


mwmm. 


107000 


SJ1 07,000.00 


ttJt 














SI933.98 


am 




S(1 68,1 17.01 





Figure 31.10 The program displays the strings in multiple languages. 
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The resource bundle for the Chinese language, named MyResource_zh.properties, is given as 
follows: 

#MyResource_zh . properti es for Chinese language 
Choose_a_Locale = \u9078\u64c7\u570b\u5bb6 
Enter_Interest_Rate = 

\u8f38\u5165\u5229\u7387,\u5e74\u9650,\u8cb8\u6b3e\u7e3d\u984d 
Annual_Interest_Rate = \u5229\u7387 
Number_Of_Years = \u5e74\u9650 
Loan_Amount = \u8cb8\u6b3e\u984d\u5ea6 

Payment = \u4ed8\u606f 

Month! y_Payment = \u6708\u4ed8 
Total ^Payment = \u7e3d\u984d 

Compute = \u8a08\u7b97\u8cb8\u6b3e\u5229\u606f 

The resource bundle for the French language, named MyResource_fr.properties, is given as 
follows: 

#MyResource_fr . properti es for French language 
Number_Of_Years=annees 
Annual_Interest_Rate=l e taux d'interet 
Loan_Amount=Le montant du pret 

Enter_Interest_Rate=i nscri re le taux d'interet, les annees, et le mon- 
tant du pret 
Payment=pai ement 
Compute=Cal cul er l'hypotheque 

Number_Formatti ng=demonstrati on du formatting des chiffres 
Choose_a_Local e=Choi si r la local ite 
Monthly_Payment=versement mensuel 
Total_Payment=regl ement total 

The resource-bundle file should be placed in the class directory (e.g., c:\book for the exam- 
ples in this book). The program is given in Listing 31.7. 

Listing 31.7 ResourceBundleDemo. java 

1 import java.awt.*; 

2 import java.awt. event.*; 

3 import javax. swing.*; 

4 import javax. swing. border.*; 

5 import java.util.*; 

6 import java. text. NumberFormat; 
7 

8 public class ResourceBundleDemo extends JApplet { 

9 // Combo box for selecting available locales 

10 private JComboBox jcboLocale = new XomboBoxO; 
getresource 11 private ResourceBundle res = ResourceBundle.getBundle("MyResource") ; 

12 

13 // Create labels 

14 private JLabel jl bl InterestRate = 

15 new DLabel (res.getString("Annual__Interest_Rate") ) ; 

16 private JLabel jl bl NumberOfYears = 

17 new 1 Label (res. getStri ng ("Number_Of_Years") ) ; 

18 private J Label jl bl LoanAmount = new J Label 

19 (res . getStri ng("Loan_Amount") ) ; 

20 private JLabel jl blMonthlyPayment = 

21 new 1 Label (res . getStri ng ("Monthly Payment")) ; 

22 private JLabel jl blTotal Payment = 

23 new DLabel (res.getString("Total„Payment") ) ; 
24 
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25 // Create titled borders 

26 private TitledBorder comboBoxTitle = 

27 new Ti tl edBorder(res . getStri ng("Choose a Locale") ) ; 

28 private TitledBorder inputTitle = new TitledBorder 

29 (res.getString("Enter_Interest_Rate") ) ; 

30 private TitledBorder paymentTitle = 

31 new TitledBorder(res.getString("Payment") ) ; 
32 



33 // Text fields for interest rate, year, loan amount, 

34 private JTextField jtflnterestRate = new JTextField("6.75") ; 

35 private JTextField jtfNumberOfYears = new JTextField("15") ; 

36 private JTextField jtf LoanAmount = new JTextFi eld ("107000") ; 

37 private JTextFi eld jtf FormattedlnterestRate = new JTextFi el d(10) ; 

38 private JTextField jtf FormattedNumberOfYears = new JTextFi eld (10) ; 

39 private JTextField jtf FormattedLoanAmount = new JTextFi eld (10) ; 
40 

41 // Text fields for monthly payment and total payment 

42 private JTextField jtfTotal Payment = new JTextFieldO ; 

43 private JTextField jtfMonthlyPayment = new JTextFieldO; 
44 

45 // Compute button 

46 private JButton jbtCompute = new JButton(res.getString("Compute")) ; 
47 

48 // Current locale 

49 private Locale locale = Local e . getDefaul t() ; 
50 

51 // Declare locales to store available locales 

52 private Locale[] locales = Calendar. getAvailableLocalesO ; 
53 

54 /** Initialize the combo box */ 

55 public void initializeComboBox() { 

56 // Add locale names to the combo box 

57 for (int i = 0; i < 1 ocal es . 1 ength ; i++) 

58 jcboLocal e . addltem(l ocal es [i ] .getDisplayNameO) ; 

59 } 
60 

61 /** Initialize the applet */ 

62 public void init() { create UI 

63 // Panel pi to hold the combo box for selecting locales 

64 J Panel pi = new JPanelO; 

65 pi. setLayout(new FlowLayoutO) ; 

66 pl.add(jcboLocale) ; 

67 i ni ti al i zeComboBox() ; 

68 pl.setBorder(comboBoxTitle) ; 



69 
70 
71 
72 
73 
74 
75 
76 
77 
78 
79 
80 
81 
82 
83 
84 



// Panel p2 to hold the input for annual interest rate, 

// number of years and loan amount 

J Panel p2 = new JPanelO; 

p2 . setLayout(new Gri dLayout(3 , 3)); 

p2 . add(jl bl InterestRate) ; 

p2 .add(jtflnterestRate) ; 

p2 .add(jtfFormattedlnterestRate) ; 

p2 . add(jl bl NumberOf Years) ; 

p2 .add(jtfNumberOfYears) ; 

p2 .add(jtfFormattedNumberOfYears) ; 

p2 . add(jl bl LoanAmount) ; 

p2 .add (jtf LoanAmount) ; 

p2 .add(jtfFormattedLoanAmount) ; 

p2.setBorder(inputTitle) ; 
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// Panel p3 to hold the payment 
JPanel p3 = new JPanel (); 
p3 . setLayout(new GridLayout(2 , 2)); 
p3 . setBorder(paymentTi tl e) ; 
p3.add(jlblMonthlyPayment) ; 
p3.add(jtfMonthlyPayment) ; 
p3 . add(jl bl Total Payment) ; 
p3 . add ( j tf Total Payment) ; 

// Set text field alignment 

jtf FormattedlnterestRate . setHori zontal Al i gnment 

(JTextFi eld. RIGHT) ; 
jtf FormattedNumberOf Years . setHori zontal Al i gnment 

(JTextFi el d . RIGHT) ; 
j tf Formatted LoanAmount . setHori zontal Al i gnment (JTextFi el d . RIGHT) ; 
jtfTotal Payment . setHori zontal Al i gnment (JTextFi eld. RIGHT) ; 
j tf Month! y Payment . setHori zontal Al i gnment (JTextFi el d . RIGHT) ; 

// Set editable false 

jtf FormattedlnterestRate . setEdi tabl e (fal se) ; 
jtf FormattedNumberOfYears . setEdi tabl e(fal se) ; 
jtf Formatted LoanAmount .setEdi tabl e (fal se) ; 
jtfTotal Payment .setEdi tabl e (fal se) ; 
j tf Month! yPayment . setEdi tabl e (fal se) ; 

// Panel p4 to hold result payments and a button 

J Panel p4 = new JPanelO; 

p4 . set Layout (new Border Layout ()) ; 

p4.add(p3, BorderLayout. CENTER) ; 

p4.add(jbtCompute, BorderLayout . SOUTH) ; 

// Place panels to the applet 
add(pl, BorderLayout. NORTH) ; 
add(p2, BorderLayout. CENTER) ; 
add(p4, BorderLayout. SOUTH) ; 

// Register listeners 

jcboLocal e . addActi onLi stener(new Acti onLi stener() { 
public void acti onPerformed (Acti onEvent e) { 

locale = locales[jcboLocale.getSelectedIndex()] ; 
updateStri ngs () ; 
computeLoanO ; 

} 

}); 

jbtCompute.addActionListener(new Acti onLi stener() { 
public void actionPerformed(ActionEvent e) { 
computeLoanO ; 

} 

}); 

} 

/** Compute payments and display results locale-sensitive format */ 
private void computeLoanO { 
// Retrieve input from user 

double loan = new Double(jtfLoanAmount.getTextO) . doubl eVal ue() ; 
double interestRate = 

new Doubl e(jtf InterestRate. getTextO) .doubleValueO / 1240; 
int numberOfYears = 

new Integer (jtf NumberOfYears . getTextO) ■ i ntVal ue() ; 
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146 // Calculate payments 

147 double monthl yPayment = loan * i nterestRate/ 

148 (1 - (Math.pow(l / (1 + i nterestRate) , numberOfYears * 12))); 

149 double totalPayment = monthl yPayment * numberOfYears * 12; 
150 

151 // Get formatters 

152 NumberFormat percentFormatter = 

153 NumberFormat. getPercentlnstance(locale) ; 

154 NumberFormat currencyForm = 

155 NumberFormat. getCurrencylnstance(locale) ; 

156 NumberFormat numberForm = NumberFormat. getNumberlnstance(locale) ; 

157 percentFormatter . setMi nimumFractionDi gi ts(2) ; 
158 

159 // Display formatted input 

160 jtf FormattedlnterestRate . setText( 

161 percentFormatter. format(i nterestRate * 12)); 

162 jtf FormattedNumberOfYears . setText 

163 (numberForm. format(numberOfYears)) ; 

164 jtf Formatted LoanAmount . setText (currencyForm . format (loan)) ; 
165 

166 // Display results in currency format 

167 jtf Monthl yPayment . setText (currency Form. format (monthl yPayment)) ; 

168 jtfTotal Payment . setText (currency Form. format (total Payment)) ; 

169 } 
170 

171 /** Update resource strings */ 

172 private void updateStri ngs () { new resource 

173 res = ResourceBundle.getBundle("MyResource", locale); 

174 jl bl InterestRate . setText (res . getStri ng ("Annual _Interest„Rate") ) ; 

175 jl bl NumberOfYears . setText(res .getStri ng("Number_Of„Years") ) ; 

176 jlbl LoanAmount. setText(res. getStri ng("Loan__Amount") ) ; 

177 jlblTotalPayment.setText(res.getString("Total„Payment") ) ; 

178 jl bl Monthl yPayment . setText (res . getStri ng ("Monthl y Payment") ) ; 

179 jbtCompute.setText(res.getString("Compute") ); 

180 comboBoxTi tie. setTi tl e ( res . getSt ri ng ( "Choose a Local e") ) ; 

181 i nputTi tl e . setTi tl e ( res . getStri ng ("Enter Interest Rate") ) ; 

182 paymentTi tl e . setTi tl e (res . getStri ng("Payment") ) ; 
183 

184 // Make sure the new labels are displayed 

185 repaintO; 

186 } 
187 

188 /** Main method */ 

189 public static void main(String[] args) { 

190 // Create an instance of the applet 

191 ResourceBundl eDemo applet = new ResourceBundleDemoO ; 
192 

193 // Create a frame with a resource string 

194 JFrame frame = new JFrame( 

195 applet, res .getString("Number Formatting")) ■ resinapplet 
196 

197 // Add the applet instance to the frame 

198 frame. add(applet, BorderLayout .CENTER) ; 
199 

200 // Invoke init() and start() 

201 applet. init() ; 

202 applet. start() ; 
203 

204 // Display the frame 

205 frame. setSize(400, 300); 

206 frame. setLocationRelativeTo(null) ; 
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207 frame . setDef aul tCl oseOpe rati on (J Frame . EXIT_0N_CL0SE) ; 

208 frame . setVi si bl e(true) ; 

209 } 

210 } 

Property resource bundles are implemented as text files with a .properties extension, and are 
placed in the same location as the class files for the application or applet. ListResource- 
Bundl es are provided as Java class files. Because they are implemented using Java source 
code, new and modified ListResourceBundles need to be recompiled for deployment. 
With PropertyResourceBundl es, there is no need for recompilation when translations are 
modified or added to the application. Nevertheless, Li stResourceBundl es provide consid- 
erably better performance than PropertyResourceBundl es. 

If the resource bundle is not found or a resource object is not found in the resource bundle, 
a MissingResourceException is raised. Since MissingResourceException is a sub- 
class of RuntimeException, you do not need to catch the exception explicitly in the code. 

This example is the same as Listing 31.6, NumberFormatDemo.java, except that the pro- 
gram contains the code for handling resource strings. The updateString method (lines 
172-186) is responsible for displaying the locale-sensitive strings. This method is invoked when 
a new locale is selected in the combo box. Since the variable res of the ResourceBundl e 
class is an instance variable in ResourceBundl eDemo, it cannot be directly used in the mai n 
method, because the mai n method is static. To fix the problem, create appl et as an instance 
of ResourceBundl eDemo, and you will then be able to reference res using applet, res. 

31.6 Character Encoding 

Java programs use Unicode. When you read a character using text I/O, the Unicode code of 
the character is returned. The encoding of the character in the file may be different from the 
Unicode encoding. Java automatically converts it to the Unicode. When you write a character 
using text I/O, Java automatically converts the Unicode of the character to the encoding spec- 
ified for the file. This is pictured in Figure 31.11. 



Program 

The Unicode of 
the character is 
returned 

The Unicode of 
the character is 
sent out 



A character is converted 
into Unicode 



A character stored in 
a specified encoding 



A character is converted into the 
code for the specified encoding 

Figure 31.1 1 The encoding of the file may be different from the encoding used in the 
program. 



You can specify an encoding scheme using a constructor of Scanner/PrintWriter for 
text I/O, as follows: 

public Scanner(File file, String encodi ngName) 
public PrintWriter(File file, String encodi ngName) 

For a list of encoding schemes supported in Java, see http://java.sun.eom/j2se/l.5.0/docs/guide/ 
intl/encoding.doc.html and http://rnindpi'od.corn/jgloss/encoding.html. For example, you may use the en- 
coding name GB18030 for simplified Chinese characters, Bi g5 for traditional Chinese characters, 
Cp939 for Japanese characters, Cp933 for Korean characters, and Cp838 for Thai characters. 
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The following code in Listing 31.8 creates a file using the GB18030 encoding (line 8). You 
have to read the text using the same encoding (line 12). The output is shown in Figure 31.12(a). 

Listing 3 1.8 Encodi ngDemo. java 

1 import java.util . *; 

2 import java.no.*; 

3 import javax. swing.*; 
4 

5 public class Encodi ngDemo { 

6 public static void man n(Stri ng [] args) 

7 throws IOException, Fi 1 eNotFoundExcepti on { 

8 PrintWriter output = new PrintWriter("temp.txt", "CB18030" ) ; specify encoding 

9 output. pn'nt("\u6B22\u8FCE Welcome \u03bl\u03b2\u03b3") ; 
10 output. close() ; 

11 

12 Scanner input = new Scanner(new File("temp.txt") , "GB18030"); specify encoding 

13 JOptionPane.showMessageDialog(null , input. nextLineO) ; 

14 } 

15 } 




(a) Using GB18030 encoding (b) Using default encoding 

Figure 31.12 You can specify an encoding scheme for a text file. 



If you don't specify an encoding in lines 8 and 12, the system's default encoding scheme is 
used. The US default encoding is ASCII. ASCII code uses 8 bits. Java uses the 16-bit Uni- 
code. If a Unicode is not an ASCII code, the character '?' is written to the file. Thus, when 
you write \u6B22 to an ASCII file, the ? character is written to the file. When you read it 
back, you will see the ? character, as shown in Figure 31.12(b). 

To find out the default encoding on your system, use 

System, out. print! n (System, get Property ("file, encoding")) ; get default encoding 

The default encoding name is Cpl252 on Windows, which is a variation of ASCII. 

Key Terms 

locale 1058 file encoding scheme 1084 

resource bundle 1058 
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i. 



Java is the first language designed from the ground up to support internationalization. 
In consequence, it allows your programs to be customized for any number of countries 
or languages without requiring cumbersome changes in the code. 
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2. Java characters use Unicode in the program. The use of Unicode encoding makes it 
easy to write Java programs that can manipulate strings in any international language. 

3. Java provides the Local e class to encapsulate information about a specific locale. A 
Local e object determines how locale-sensitive information, such as date, time, and 
number, is displayed, and how locale-sensitive operations, such as sorting strings, are 
performed. The classes for formatting date, time, and numbers, and for sorting strings 
are grouped in the java . text package. 

4. Different locales have different conventions for displaying date and time. The 
java. text. DateFormat class and its subclasses can be used to format date and 
time in a locale-sensitive way for display to the user. 

5 . To format a number for the default or a specified locale, use one of the factory class 
methods in the NumberFormat class to get a formatter. Use getlnstance or 
getNumberlnstance to get the normal number format. Use getCur rencylnstance 
to get the currency number format. Use getPercentlnstance to get a format for dis- 
playing percentages. 

6. Java uses the ResourceBundl e class to separate locale-specific information, such as 
status messages and GUI component labels, from the program. The information is 
stored outside the source code and can be accessed and loaded dynamically at runtime 
from a ResourceBundl e, rather than hard-coded into the program. 

7. You can specify an encoding for a text file when constructing a PrintWriter or a 
Scanner. 



Review Questions 

Sections 31.1-31.2 

31.1 How does Java support international characters in languages like Chinese and Arabic? 

3 1 .2 How do you construct a Local e object? How do you get all the available locales 
from a Cal endar object? 

3 1.3 How do you set a locale for the French-speaking region of Canada in a Swing 
JButton? How do you set a locale for the Netherlands in a Swing J Label ? 

Section 31.3 

3 1 .4 How do you set the time zone "PST" for a Cal endar object? 
31.5 How do you display current date and time in German? 

3 1 .6 How do you use the Simpl eDateFormat class to display date and time using the 
pattern "yyyy.MM.dd hh:mm:ss"? 

31.7 In line 73 of WorldClockControl.java, Arrays, sort (avail ableTimeZones) 

is used to sort the available time zones. What happens if you attempt to sort the 
available locales using Arrays. sort (avai lableLocales)? 

Section 31.4 

3 1 .8 Write the code to format number 12345.678 in the United Kingdom locale. Keep 
two digits after the decimal point. 

3 1 .9 Write the code to format number 12345.678 in U.S. currency. 
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31.10 Write the code to format number 0.345678 as percentage with at least three digits 
after the decimal point. 

31.11 Write the code to parse 3,456.78 into a number. 

31.12 Write the code that uses the Decimal Format class to format number 12345.678 
using the pattern "0.0000#". 

Section 31.5 

31.13 How does the getBundl e method locate a resource bundle? 

31.14 How does the getOb j ect method locate a resource? 

Section 31.6 

31.15 How do you specify an encoding scheme for a text file? 

31.16 What would happen if you wrote a Unicode character to an ASCII text file? 

31.17 How do you find the default encoding name on your system? 

Programming Exercises 

Sections 31.1-31.2 

3 I . I * (Unicode viewer) Develop an applet that displays Unicode characters, as shown 
in Figure 31.13. The user specifies a Unicode in the text field and presses the 
Enter key to display a sequence of Unicode characters starting with the speci- 
fied Unicode. The Unicode characters are displayed in a scrollable text area of 
20 lines. Each line contains 16 characters preceded by the Unicode that is the 
code for the first character on the line. 



9 Unicode Viewer 
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Figure 31.13 The applet displays the Unicode characters. 



3 1 .2** (Displaying date and time) Write a program that displays the current date and 
time as shown in Figure 31.14. The program enables the user to select a locale, 
time zone, date style, and time style from the combo boxes. 



B Show Date and Time 


-In|x| 


Date: Sunday, February 1 B : 20D7 


Time: 7:51:42 AM WST 


Locale: |an | » | Tine Zone: UT » 


Date Style: | Rill |» 


Time Style: Full »■] 



Figure 31.14 The program displays the current date and time. 
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Section 31.3 

31.3 (Placing the calendar and clock in a panel) Write an applet that displays the cur- 
rent date in a calendar and current time in a clock, as shown in Figure 31.15. En- 
able the applet to run standalone. 



\ Calendar and Clock 
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Figure 31.15 The calendar and clock display the current date and time. 



3 1 .4 (Finding the available locales and time zone IDs) Write two programs to display the 
available locales and time zone IDs using buttons, as shown in Figure 31.16. 



I Available Locales and Time 



Japanese (Japan) ja_JP 
Spanish (Peru) es_PE 
English en 

Japanese (Japan.JP) ja_JP_JP 

Spanish (Panama) es_PA 

Serbian (Bosnia and Herzegovina) sr_BA 

Macedonian mk 

Spanish (Guatemala) es_GT 

Arabic (United Arab Emirates) ar_AE 

Norwegian (Noway) no_NO 

Albanian (Albania) sq_AL 



All Locales 



All Time Zones: 



[ Available Locales and Time Z 



Etc'GMT+12 
Etc/GMT+11 
MIT 

Pacific/Apia 

Pacific/Midway 

PacificfrJiue 

Pacific/Pago_Pago 

Pacific/Samoa 

US/Samoa 

Arnerica/Adak 

America/Atka 





All Locales 




All Time Zones 



Figure 31.16 The program displays available locales and time zones using buttons. 



Section 31.4 

3 1.5* (Computing loan amortization schedule) Rewrite Exercise 4.22 using an applet, as 
shown in Figure 31.17. The applet allows the user to set the loan amount, loan period, 
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Figure 31.17 The program displays the loan payment schedule. 
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and interest rate, and displays the corresponding interest, principal, and balance 
in the currency format. 

31.6 (Converting dollars to other currencies) Write a program that converts U.S. 

dollars to Canadian dollars, German marks, and British pounds, as shown in 
Figure 31.18. The user enters the U.S. dollar amount and the conversion rate, 
and clicks the Convert button to display the converted amount. 



9 txchanqe currencies 
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Figure 31.18 The program converts U.S. dollars to Canadian dollars, German marks, and 
British pounds. 

31.7 (Computing loan payments) Rewrite Listing 2.8, ComputeLoan.java, to display 
the monthly payment and total payment in currency. 

3 1 .8 (Using the Decimal Format class) Rewrite Exercise 5.8 to display at most two 
digits after the decimal point for the temperature using the Decimal Format 
class. 

Section 31.5 

3 1 .9* (Using resource bundle) Modify the example for displaying a calendar in §31.3.6, 
"Example: Displaying a Calendar," to localize the labels "Choose a locale" and 
"Calendar Demo" in French, German, Chinese, or a language of your choice. 

31.10** (Flag and anthem) Rewrite Listing 18.13, ImageAudioAnimation.java, to use 
the resource bundle to retrieve image and audio files. 

(Hint: When a new country is selected, set an appropriate locale for it. Have your 
program look for the flag and audio file from the resource file for the locale.) 

Section 31.6 

31.1 I ** (Specifying file encodings) Write a program named Exercise31_l 1 Writer that 
writes 1307 X 16 Chinese Unicode characters starting from \u0E00 to a file 
named Exercise31_ll.gb using the GBK encoding scheme. Output 16 charac- 
ters per line and separate the characters with spaces. Write a program named 
Exercise31_l IReader that reads all the characters from a file using a specified 
encoding. Figure 31.19 displays the file using the GBK encoding scheme. 
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Figure 31.19 The program displays the file using the specified encoding 



scheme. 



This page intentionally left blank 



Chapter 3 2 

JavaBeans and Bean Events 

Objectives 

■ To describe what a JavaBeans component is (§32.2). 

■ To explain the similarities and differences between beans and regular objects (§32.2). 

■ To develop JavaBeans components that follow the naming patterns (§32.3). 

■ To review the Java event delegation model (§32.4). 

■ To create custom event classes and listener 
interfaces (§32.5). 

■ To develop source components using event sets from 
the Java API or custom event sets (§32.6). 
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32.1 Introduction 

Every Java user interface class is a JavaBeans component. Understanding JavaBeans will help 
you to learn GUI components. In Chapter 16, "Event-Driven Programming," you learned how 
to handle events fired from source components such as JButton, JTextField, JRadio- 
Button, and JComboBox. In this chapter, you will learn how to create custom events and de- 
velop your own source components that can fire events. By developing your own events and 
source components, you will gain a better understanding of the Java event model and GUI 
components. 



JavaBeans component 



32.2 JavaBeans 



JavaBeans is a software component architecture that extends the power of the Java language 
by enabling well-formed objects to be manipulated visually at design time in a pure Java 
builder tool, such as NetBeans and Eclipse. Such well-formed objects are referred to as 
JavaBeans or simply beans. The classes that define the beans, referred to as JavaBeans com- 
ponents or bean components conform to the JavaBeans component model with the following 
requirements: 

■ A bean must be a public class. 

■ A bean must have a public no-arg constructor, though it can have other constructors 
if needed. For example, a bean named MyBean must either have a constructor with 
the signature 



serializable 



accessor 
mutator 



event registration 



publ ic MyBean () ; 
or have no constructor if its superclass has a no-arg constructor. 

■ A bean must implement the j ava . i o . Ser i al i zabl e interface to ensure a persis- 
tent state. 

■ A bean usually has properties with correctly constructed public accessor (get) meth- 
ods and mutator (set) methods that enable the properties to be seen and updated 
visually by a builder tool. 

■ A bean may have events with correctly constructed public registration and deregistra- 
tion methods that enable it to add and remove listeners. If the bean plays a role as the 
source of events, it must provide registration methods for registering listeners. For ex- 
ample, you can register a listener for ActionEvent using the addActionLi stener 
method of a JButton bean. 

The first three requirements must be observed, and therefore are referred to as minimum Java- 
Beans component requirements. The last two requirements depend on implementations. It is 
possible to write a bean component without get/set methods and event registration/deregistration 
methods. 

A JavaBeans component is a special kind of Java class. The relationship between Jav- 
aBeans components and Java classes is illustrated in Figure 32.1. 
Every GUI class is a JavaBeans component, because 

1. it is a public class, 

2. it has a public no-arg constructor, and 

3. It is an extension of j ava. awt. Component, which implements java.io.- 
Serial izabl e. 
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class 



Data members 

Methods 

Constructors 



JavaBeans Component 



public class 

public no-arg constructor 
serializable 
may have accessor/mutator methods 
may have registration/deregistration methods 



Minimum 
requirement 



Optional 
requirement 



Figure 32.1 A JavaBeans component is a serializable public class with a public no-arg constructor. 



32.3 Bean Properties 

Properties are discrete, named attributes of a Java bean that can affect its appearance or be- 
havior. They are often data fields of a bean. For example, the JButton component has a prop- 
erty named text that represents the text to be displayed on the button. Private data fields are 
often used to hide specific implementations from the user and prevent the user from acciden- 
tally corrupting the properties. Accessor and mutator methods are provided instead to let the 
user read and write the properties. 



32.3.1 Property-Naming Patterns 

The bean property-naming pattern is a convention of the JavaBeans component model that sim- 
plifies the bean developer's task of presenting properties. A property can be a primitive data type 
or an object type. The property type dictates the signature of the accessor and mutator methods. 

In general, the accessor method is named get<PropertyName>0, which takes no para- 
meters and returns a primitive type value or an object of a type identical to the property type. 
For example, 

public String getMessageO 
public int getXCoordi nate() 
public int getYCoordi nate() 

For a property of bool ean type, the accessor method should be named i s<PropertyName>0, 
which returns a bool ean value. For example, 

public boolean isCenteredO 

The mutator method should be named set<PropertyName>(dataType p), which takes a 
single parameter identical to the property type and returns void. For example, 

public void setMessage(Stri ng s) 
public void setXCoordi nate(int x) 
public void setYCoordi nate(int y) 
public void setCentered(boolean centered) 



accessor method 



boolean accessor method 



mutator method 



Note 

You may have multiple get and set methods, but there must be one get or set method with a sig- 
nature conforming to the naming patterns. 



32.3.2 Properties and Data Fields 

Properties describe the state of the bean. Naturally, data fields are used to store properties. 
However, a bean property is not necessarily a data field. For example, in the MessagePanel 
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class in Listing 15.7, MessagePanel . java, you may create a new property named 
messageLength that represents the number of characters in message. The get method for 
the property may be defined as follows: 

public int getMessageLengthO { 
return message. JengthO ; 

} 

||| Note 

read-only property A property may be read-only with a get method but no set method, or write-only with a set 

write-only property method but no get method. 

32.4 Java Event Model Review 

A bean may communicate with other beans. The Java event delegation model provides the 
foundation for beans to send, receive, and handle events. Let us review the Java event model 
that was introduced in Chapter 16, "Event-Driven Programming." The Java event model con- 
sists of the following three types of elements, as shown in Figure 16.3: 

■ The event object 

■ The source object 

■ The event listener object 

An event is a signal to the program that something has happened. It can be triggered by exter- 
nal user actions, such as mouse movements, mouse button clicks, and keystrokes, or by the 
operating system, such as a timer. An event object contains the information that describes the 
event. A source object is where the event originates. When an event occurs on a source 
object, an event object is created. An object interested in the event handles the event. Such an 
object is called a listener. Not all objects can handle events. To become a listener, an object 
must be registered as a listener by the source object. The source object maintains a list of lis- 
teners and notifies all the registered listeners by invoking the event-handling method imple- 
mented on the listener object. The handlers are defined in the event listener interface. Each 
event class has a corresponding event listener interface. The Java event model is referred to 
as a delegation-based model, because the source object delegates the event to the listeners 
for processing. 

32.4-1 Event Classes and Event Listener Interfaces 

An event object is created using an event class, such as ActionEvent, MouseEvent, and 
ItemEvent, as shown in Figure 16.2. All the event classes extend java.util . EventOb- 
ject. The event class contains whatever data values and methods are pertinent to the particular 
event type. For example, the KeyEvent class describes the data values related to a key event and 
contains the methods, such as getKeyCharO, for retrieving the key associated with the event. 
Every event class is associated with an event listener interface that defines one or more 
handler methods referred to as handlers. An event listener interface is a subinterface of 

java.util . EventListener. The handlers are implemented by the listener components. 
The source component invokes the listeners' handlers when an event is detected. 

Since an event class and its listener interface are coexistent, they are often referred to as an 
event set event set or event pair. The event listener interface must be named as XListener for the 

XEvent. For example, the listener interface for ActionEvent is ActionLi stener. The 
parameter list of a handler always consists of an argument of the event class type. Table 16.2 
lists some commonly used events and their listener interfaces. Figure 32.2 shows the pair of 
ActionEvent and ActionLi stener. 



event 

source object 
listener 
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java.util .EventObject 



«i nterface» 
java.util . EventLi stener 



java.awt.event.ActionEvent 



+ActionEvent(source: Object, id: int, command: String) 
+getActionCommand() : String 
+getModifier() : int 
+getWhen(): long 



^ 

«interface» 
java. awt. event. ActionListener 



+actionPerformed(e : ActionEvent) : void 



Figure 32.2 ActionEvent and ActionLi stener are examples of an event pair. 



32.4-2 Source Components 

The component on which an event is generated is referred to as an event source. Every Java GUI 
component is an event source for one or more events. For example, JButton is an event source 
for ActionEvent. A J But ton object fires a java.awt.event.ActionEvent when it is 
clicked. JComboBox is an event source for ActionEvent and ItemEvent. A JComboBox 
object fires a java.awt.event.ActionEvent and a java. awt. event. ItemEvent when 
a new item is selected in the combo box. 

The source component contains the code that detects an external or internal action that trig- 
gers the event. Upon detecting the action, the source should fire an event to the listeners by in- 
voking the event handler defined by the listeners. The source component must also contain 
methods for registering and deregistering listeners, as shown in Figure 32.3. 



Source Component 



Register listener method 
Deregister listener method 


A vector (stores the listener objects) | 








Detect events | >~ 


Fire and process event by invoking the event 
handler from each listener in the vector 



Figure 32.3 The source component detects events and processes them by invoking the 
event listeners' handlers. 



32.4-3 Listener Components 

A listener component for an event must implement the event listener interface. The object of 
the listener component cannot receive event notifications from a source component unless the 
object is registered as a listener of the source. 

A listener component may implement any number of listener interfaces to listen to several 
types of events. A source component may register many listeners. A source component may 
register itself as a listener. 

Listing 32.1 gives an example that creates a source object (line 8) and a listener object (line 
14), and registers the listener with the source object (line 17). Figure 32.4 highlights the rela- 
tionship between the source and the listener. The listener is registered with the source by in- 
voking the addActionLi stener method. Once the button is clicked, an ActionEvent is 
generated by the source. The source object then notifies the listener by invoking the listener's 
actionPerformed method. 
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Source Component 



Listener Component 



JButton 



Listener vector 



Generate an 




Process event 


event 





addActi onLi stener (Acti onLi stener 1 ) 
removeActi onLi stener (Acti onLi stener 1 ) 



Invoke listener's 

actionPerformed 

method 



My Li stener class implements 
ActionListener 



actionPerformed(ActionEvent e) 




JButton jbt = new--?Button() ; // Create a source object 

MyListener listener = new MyListener (); // Create a listener object 

jbt . addActi onLi stener (1 i stener) ; // Register listener to the source 



Figure 32.4 The listener is registered with the source, and the source invokes the listener's handler to process 
the event. 



Listing 32.1 TestSourceLi stener . java 



source object 



listener object 



registration 



listener class 



import javax. swi ng . * ; 
import java. awt . event .* ; 

public class TestSourceLi stener { 

public static void main(String[] args) { 

JFrame frame = new JFrame("TestSourceListener") ; 
// Create a source object 
JButton jbt = new JButton("0K") ; 
frame . add (jbt) ; 
frame.setSize(200, 200); 
frame.setVisible(true) ; 



1 
2 
3 
4 
5 
6 
7 
8 
9 
10 
11 
12 
13 
14 
15 
16 
17 

18 } 

19 } 
20 

21 /** MyListener class */ 

22 class MyListener implements ActionListener { 

23 public void actionPerformed(ActionEvent e) 

24 System. out. println("I will process it!"); 

25 } 

26 } 



// Create listeners 
MyListener listener 



new My Li stener () ; 



// Register listeners 

jbt . addActi onLi stener (1 i stener) ; 
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32.5 Creating Custom Source Components 

You have used source components such as JButton. This section demonstrates how to create 
a custom source component. 

A source component must have the appropriate registration and deregistration methods for 
adding and removing listeners. Events can be unicasted (only one listener object is notified of 
the event) or multicasted (each object in a list of listeners is notified of the event). The naming 
pattern for adding a unicast listener is 

public void add<£ vent>Li stener (<£vent>Li stener 1) 
throws TooManyLi stenersException ; 

The naming pattern for adding a multicast listener is the same, except that it does not throw multicast 
the TooManyLi stenersException. 

public void add<£Ve/?t>Li stener (<£Vent>Li stener 1) 

The naming pattern for removing a listener (either unicast or multicast) is: deregistration method 

public void remove<£Vent>Li stener (<£Vent>Li stener 1) 

A source component contains the code that creates an event object and passes it to invoke the 
handler of the listeners. You may use a standard Java event class like ActionEvent to create 
event objects or may define your own event classes if necessary. 

The Course class in §10.8, "Designing the Course Class," models the courses. Sup- 
pose a Course object fires an ActionEvent when the number of students for the course ex- 
ceeds a certain enrollment cap. The new class named CourseWithActionEvent is shown in 
Figure 32.5. 



registration method 



unicast 



_ 



CourseWithActionEvent 



-courseName : String 
-students: ArrayLi st<Stri ng> 
-enrollmentCap: int 



+CourseWi thActionEvent() 

+Cou rseWi thActi onEvent (cou rseName : St ri ng) 
+getCourseName() : String 
+addStudent(student : String): void 
+getStudents() : String[] 
+getNumberOfStudents() : int 
+getEnroTlmentCapO : int 

+setEnrollmentCap(enrollmentCap: int): void 
+addActionl_istener(e: ActionEvent): void 
+ removeActionl_istener(e: ActionEvent): void 
-processEvent(e : ActionEvent): void 



The name of the course. 

The students who take the course. 

The maximum enrollment (default: 10). 

Creates a default course. 

Creates a course with the specified name. 

Returns the course name. 

Adds a new student to the course list. 

Returns the students for the course as an array. 

Returns the number of students for the course. 

Returns the enrollment cap. 

Sets a new enrollment cap. 

Adds a new Acti onEvent listener. 

Deletes an Acti onEvent listener. 

Processes an Acti onEvent. 



Figure 32.5 The new CourseWithActionEvent class can fire an ActionEvent. 



The source component is responsible for registering listeners, creating events, and notify- 
ing listeners by invoking the methods defined in the listeners' interfaces. The Course- 
WithActionEvent component is capable of registering multiple listeners, generating 
ActionEvent objects when the enrollment exceeds the cap, and notifying the listeners 
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by invoking the listeners' actionPerformed method. Listing 32.2 implements the new 
class. 



store students 
enrollmentCap 

store listeners 

no-arg constructor 

constructor 

return courseName 



create event 



register listener 



Listing 32.2 CourseWithActionEvent.java 

1 import java.util.*; 

2 import java.awt. event.*; 
3 

4 public class CourseWithActionEvent { 

5 private String courseName = "default name"; 
private ArrayLi st<Stri ng> students = new ArrayLi st<Stri ng>() ; 
private int enrollmentCap = 10; 



6 
7 
8 
9 
10 
11 
12 
13 
14 
15 
16 
17 
18 
19 
20 
21 
22 
23 
24 
25 
26 
27 
28 
29 
30 
31 
32 
33 
34 
35 
36 
37 
38 
39 
40 
41 
42 
43 
44 
45 
46 
47 
48 
49 
50 
51 
52 
53 
54 
55 



private ArrayLi st<Acti onLi stener> acti onLi stenerLi st ; 

public CourseWithActionEventO { 
} 

public CourseWi thActi onEvent(Stri ng courseName) { 
this . courseName = courseName; 

} 

public String getCourseNameO { 
return courseName; 

} 

public void addStudent(Stri ng student) { 
students . add (student) ; 

if (students . si ze() > enrollmentCap) { 
// Fire ActionEvent 
process Event (new Acti onEvent(this , 
ActionEvent. ACTI0N_PERF0RMED , null)) ; 

} 

} 

public String[] getStudents () { 

return (Stri ng [] )students . toArrayO ; 

} 

public int getNumberOf Students () { 
return students . si ze() ; 

} 

public int getEnrollmentCapO { 
return enrollmentCap; 

} 

public void setEnrollmentCap(int enrollmentCap) { 
this. enrollmentCap = enrollmentCap; 

} 

/** Register an action event listener */ 
public synchronized void addActionLi stener 
(Acti onLi stener listener) { 
if (actionLi stenerLi st == null) { 

actionLi stenerLi st = new ArrayLi st<ActionLi stener>(2) ; 

} 

if (!actionListenerList.contains(listener)) { 
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56 acti on Li stenerLi st . add(l i stener) ; 

57 } 

58 } 
59 

60 /** Remove an action event listener */ 

61 public synchronized void removeActi onLi stener remove listener 

62 (Acti onLi stener listener) { 

63 if (actionListenerList != 

64 null && actionListenerList.contains(listener)) { 

65 acti onLi stenerLi st . remove(l i stener) ; 

66 } 

67 } 
68 

69 /** Fire ActionEvent */ 

70 private void processEvent(ActionEvent e) { process event 

71 ArrayList list; 
72 

73 synchronized (this) { 

74 if (acti onLi stenerLi st == null) return; 

75 list = (ArrayList)actionListenerList.clone() ; 

76 } 
77 

78 for (int i = 0; i < list.size(); i++) { 

79 Acti onLi stener listener = (Acti onLi stener)! i st . get(i ) ; 

80 listener. actionPerformed(e) ; 

81 } 

82 } 



83 } 

Since the source component is designed for multiple listeners, a java.util .ArrayList 
instance actionListenerList is used to hold all the listeners for the source component 
(line 9). The data type of the elements in the array list is ActionLi stener. To add a listener, 
1 i stener, to actionListenerList, use 

acti onLi stenerLi st . add(l i stener) ; (line 56) 

To remove a listener, 1 i stener, from actionListenerList, use 

actionListenerList. remove(listener) ; (line 65) 

The if statement (lines 55-56) ensures that the addActionLi stener method does not add 
the listener twice if it is already in the list. The removeActi on Li stener method removes a 
listener if it is in the list. actionListenerList is an instance of ArrayList, which func- 
tions as a flexible array that can grow or shrink dynamically. Initially, actionListenerList 
is of size 2, which implies that the capacity of the list is 2, but the capacity can be changed dy- 
namically. If more than two listeners are added to actionListenerList, the list size will 
be automatically increased. 

|§| Note 

Instead of using ArrayList, you can also use javax. swing, event. EventLi stenerLi st 

to store listeners. Using EventLi stenerLi st is preferred, since it provides the support for syn- storing listeners 

chronization and is efficient in the case of no listeners. 

The addActionLi stener and removeActi on Li stener methods are synchronized to pre- 
vent data corruption on actionListenerList when attempting to register multiple listen- 
ers concurrently (lines 49, 61). 

The addStudent method (lines 22-30) adds a new student to the course and checks 
whether the number of students is more than the enrollment cap. If so, it creates an 
ActionEvent and invokes the processEvent method to process the event (lines 27-28). 
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The UML diagram for ActionEvent is shown in Figure 32.2. To create an Action- 
Event, use the constructor 

ActionEvent(Object source, int id, String command) 

where source specifies the source component, id identifies the event, and command speci- 
fies a command associated with the event. Use ActionEvent . ACTI0N_PERF0RMED for the 
id. If you don't want to associate a command with the event, use nul 1 . 

The processEvent method (lines 70-82) is invoked when an ActionEvent is generated. 
This notifies the listeners in actionListenerList by calling each listener's action- 
Performed method to process the event. It is possible that a new listener may be added or an 
existing listener may be removed when processEvent is running. To avoid corruption on 
actionListenerList, a clone 1 ist of actionListenerList is created for use to notify 
listeners. To avoid corruption when creating the clone, invoke it in a synchronized block, as in 
lines 73-76: 

synchronized (this) { 

if (actionListenerList == null) return; 

list = (ArrayList)actionListenerList.clone() ; 

} 

Listing 32.3 gives a test program that creates a course using the new class (line 5), sets the 
enrollment cap to 2 (line 8), registers a listener (line 9), and adds three students to the course 
(lines 11-13). When line 13 is executed, the addStudent method adds student Tim to the 
course and fires an ActionEvent because the course exceeds the enrollment cap. The course 
object invokes the listener's actionPerformed method to process the event and displays a 
message Enrollment cap exceeded. 



Listing 32.3 TestCourseWi thActionEvent . java 



create course 



set enrollmentCap 
create listener 
register listener 
add students 



1 
2 
3 
4 
5 
6 
7 
8 
9 
10 
11 
12 
13 
14 
15 
16 
17 
18 
19 
20 
21 
22 
23 
24 
25 



import java. awt . event .* ; 

public class TestCourseWithActionEvent { 
CourseWithActionEvent course = 

new CourseWithActionEvent("Java Programming"); 

public TestCourseWithActionEventO { 
course . set Enrol lmentCap(2) ; 
Acti onLi stener listener = new ListenerO; 
course . addActi onLi stenerO i stener) ; 
course . addStudent ("John") ; 
course . addStudent ("Jim") ; 
course . addStudent("Tim") ; 

} 

public static void main(String[] args) { 
new TestCourseWithActionEventO ; 

} 

private class Listener implements Acti onLi stener { 
public void actionPerformed(ActionEvent e) { 
System. out . pri ntl n("Enrollment cap exceeded"); 

} 

} 



The flow of event processing from the source to the listener is shown in Figure 32.6. 
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Source Component 



Listener Component 



Cou rseWi thActi onEvent 



Listener vector 



Generate an 




Process event 


event 





addActi onLi stener(Acti onLi stener 1 ) 
removeActi onLi stener (Acti onLi stener 1 ) 



Invoke listener's 

actionPerformed 

method 



Listener class implements 
ActionListener 



actionPerformed(ActionEvent e) 



TestCou rseWi thActi onEve 




CourseWithActionEvent^com^se_^ () ; // Create a source object 

Listener listener = new ListenerO; // Create a listener object 
course . addActi onLi stener (1 i stener) ; // Register listener to the source 



Figure 32.6 The listener is registered with the source course, and the source invokes the listener's handler 
actionPerformed to process the event. 



32.6 Creating Custom Event Sets 

The Java API provides many event sets. You have used the event set ActionEvent/ 
ActionListener in the preceding section. A course object fires an ActionEvent when the en- 
rollment cap is exceeded. It is convenient to use the existing event sets in the Java API, but they are 
not always adequate. Sometimes you need to declare custom event classes in order to obtain infor- 
mation not available in the existing API event classes. For example, suppose you want to know the 
enrollment cap and the number of students in the course; an ActionEvent object does not pro- 
vide such information. You have to define your own event class and event listener interface. 

A custom event class must extend java.util .EventObject or a subclass of java.- 
util . EventObject. Additionally, it may provide constructors to create events, data mem- 
bers, and methods to describe events. 

A custom event listener interface must extend java.util . EventLi stener or a subin- 
terface of java.util . EventLi stener and define the signature of the handlers for the 
event. By convention, the listener interface should be named ^Listener for the corresponding 
event class named XEvent. For example, ActionListener is the listener interface for 
ActionEvent. 

Let us define Enrol 1 mentEvent as the event class for describing the enrollment event and its 
corresponding listener interface Enrol 1 mentLi stener for defining an enrol 1 mentExceeded 
handler, as shown in Figure 32.7. The getStudentToEnrol 1 () method returns the student who 
attempts to enroll the course. 

The source code for the enrollment event set is given in Listings 32.4 and 32.5. 

Listing 32.4 En rol 1 mentEvent . j ava 

1 public class En roll mentEvent extends java. uti 1 . EventObject { extends EventObject 

2 private String studentToEnroIl ; 

3 private int enrollmentCap; 
4 
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constructor 



invoke superclass constructor 



5 
6 
7 
8 
9 
10 
11 
12 
13 
14 
15 
16 
17 
18 
19 
20 



/** Construct a Enrol ImentEvent */ 

public EnrollmentEvent(Object source, String studentToEnroll , 
int enrollmentCap) { 
super(source) ; 

this . studentToEnrol 1 = studentToEnroll; 
this. enrollmentCap = enrollmentCap; 

} 

public String getStudentToEnrol 1 () { 
return studentToEnroll; 

} 

public long getEnrollmentCapC) { 
return enrollmentCap; 

} 



extends EventListener 

handler 



Listing 32.5 Enrol 1 ment Li stener. java 



1 public interface EnrollmentListener extends java. uti 1 . EventLi stener 

2 /** Handle an EnrollmentEvent, to be implemented by a listener */ 

3 public void enrollmentExceeded(EnrollmentEvent e) ; 

4 } 



java. uti 1 .EventObject 



«i nterface» 
java. uti 1 . EventLi stener 



EnrollmentEvent 



-studentToEnroll: String 
-enrollmentCap: int 



+EnrollmentEvent(source: Object, 

student: String, numberOfStudents : int, 
enrollmentCap: int) 

+getEnrollmentCapO : int 

+getStudentToEnrol 1 () : String 



«interface» 
EnrollmentListener 



+enronmentExceeded(e: EnrollmentEvent) : void 



Figure 32.7 Enrol ImentEvent and EnrollmentListener comprise an event set for enrollment event. 



An event class is an extension of EventObject. To construct an event, the constructor of 
EventObject must be invoked by passing a source object as the argument. In the construc- 
tor for EnrollmentEvent, super (source) (line 8) invokes the superclass's constructor 
with the source object as the argument. Enrol 1 mentEvent contains the information pertain- 
ing to the event, such as number of students and enrollment cap. 

EnrollmentListener simply extends EventListener and defines the enrollment- 
Exceeded method for handling enrollment events. 

||| Note 

specifying a source for an An event class does not have a no-arg constructot, because you must always specify a source for 

event the event when creating an event. 

Let us revise CourseWithActionEvent in Listing 32.2 to use EnrollmentEvent/ 
EnrollmentListener instead of ActionEvent/ActionListener. The new class named 
CourseWi thEnrol 1 mentEvent in Listing 32.6 is very similar to CourseWi thActionEvent 

in Listing 32.2. 
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Listing 32.6 CourseWithEnrollmentEvent. java 

1 import java.util.*; 

2 

3 public class CourseWithEnrollmentEvent { 

4 private String name = "default name"; 

5 private ArrayLi st<Stri ng> students = new ArrayLi st<Stri ng>() ; store students 

6 private int enrollmentCap = 10; enrollmentCap 
7 

8 private ArrayList<EnrollmentListener> enrollmentListenerList; store listeners 

9 

10 public CourseWithEnrollmentEventO { no-arg constructor 

11 } 
12 

13 public CourseWithEnrollmentEvent(String name) { constructor 

14 this. name = name; 

15 } 
16 

17 public void addStudent(Stri ng student) { 

18 students . add(student) ; 
19 

20 if (students. size() > enrollmentCap) { 

21 // Fire EnrollmentEvent 

22 processEvent(new EnrollmentEvent(this, createevent 

23 student, getEnrollmentCapO)) ; 

24 } 

25 } 
26 

27 public String[] getStudents () { 

28 return (Stri ng [] )students . toArrayO ; 

29 } 
30 

31 public int getNumberOf Students () { 

32 return students . si ze() ; 

33 } 
34 

35 public int getEnrollmentCapO { 

36 return enrollmentCap; 

37 } 
38 

39 public void setEnrollmentCap(int enrollmentCap) { 

40 this. enrollmentCap = enrollmentCap; 

41 } 
42 

43 /** Register an action event listener */ 

44 public synchronized void addEnrollmentLi stener register listener 

45 (EnrollmentLi stener listener) { 

46 if (enrollmentListenerList == null) { 

47 enrollmentListenerList = new ArrayList<EnrollmentListener>(2) ; 

48 } 
49 

50 if (!enrollmentListenerList.contains(listener)) { 

51 enrollment Li stener Li st. add (listener) ; 

52 } 

53 } 
54 

55 /** Remove an action event listener */ 

56 public synchronized void removeEnrollmentLi stener remove listener 

57 (EnrollmentLi stener listener) { 

58 if (enrollmentListenerList != 
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59 
60 
61 
62 
63 
64 
65 
66 
67 
68 
69 
70 
71 
72 
73 
74 
75 
76 
77 

78 } 



null && enrollmentListenerList.contains(listener)) { 
enrollmentListenerList. remove (1 i stener) ; 



} 



} 



process event 



/** Fire Enrol lmentEvent */ 

private void processEvent(EnrollmentEvent e) { 
ArrayList list; 



synchronized (this) { 

if (enrollment!.! stenerLi st == null) return; 

list = (ArrayList)enrollmentListenerList.clone() ; 

} 



for (int i =0; i < list. size () ; i++) { 

EnrollmentLi stener listener = (EnrollmentListener)list.get(i) ; 
listener. enrollmentExceeded(e) ; 

} 



} 



Line 8 creates a java.util .ArrayList instance enrollment Li stener List for holding all 
the listeners for the source component. The data type of the elements in the array list is 
Enrol 1 mentLi stener. The registration and deregistration methods for Enrol 1 mentLi stener 
are defined in lines 44, 56. 

The addStudent method adds a new student to the course and checks whether the num- 
ber of students is more than the enrollment cap. If so, it creates an Enrol 1 mentEvent and 
invokes the processEvent method to process the event (lines 22-23). To create an 
Enrol 1 mentEvent, use the constructor 

Enrol lmentEvent(Object source, String studentToEnroll , 
int enrollmentCap) 

where source specifies the source component. 

The processEvent method (lines 65-77) is invoked when an Enrol 1 mentEvent is gen- 
erated. This notifies the listeners in enroll mentLi stenerList by calling each listener's 
enrol 1 men t Exceeded method to process the event. 

Let us revise the test program in Listing 32.3 to use Enrol lmentEvent/ 
Enroll mentLi stener instead of ActionEvent/ActionListener. The new program, 
given in Listing 32.7, creates a course using CourseWithEnrol 1 mentEvent (line 3), sets 
the enrollment cap to 2 (line 6), creates an enrollment listener (line 7), registers it (line 8), and 
adds three students to the course (lines 9-11). When line 11 is executed, the addStudent 
method adds student Tim to the course and fires an Enrol lmentEvent because the course 
exceeds the enrollment cap. The course object invokes the listener's enrol lmentExceeded 
method to process the event and displays the number of students in the course and the enroll- 
ment cap. 

Listing 32.7 TestCourseWi thEnroll mentEvent. java 

1 public class TestCourseWithEnrollmentEvent { 

2 CourseWi thEnrol 1 mentEvent course = 



create course 



3 
4 
5 
6 
7 



new CourseWi thEnrol 1 mentEvent("Java Programming") ; 



set enrollmentCap 
create listener 



public TestCourseWithEnrollmentEventO { 
course. setEnrollmentCap(2) ; 

EnrollmentLi stener listener = new NewLi stenerQ ; 
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8 course. addEnrollmentListener(listener) ; register listener 

9 course . addStudent("John Smith"); addstudents 

10 course . addStudent("Jim Peterson"); 

11 course . addStudent("Tim Johnson"); 

12 } 
13 

14 public static void mai n (Stri ng [] args) { 

15 new TestCourseWithEnrollmentEventO ; 

16 } 
17 

18 private class NewListener implements EnrollmentLi stener { 

19 public void enrollmentExceededCEnrollmentEvent e) { 

20 System . out . pri ntl n(e . getStudentToEnroll () + 

21 " attempted to enroll\n" + 

22 "The enrollment cap is " + e . getEnrol 1 mentCapO) ; 

23 } 

24 } 

25 } 



Tim Johnson attempted to enroll 
The enrollment cap is 2 



The flow of event processing from the source to the listener is shown in Figure 32.8 



Cou rseWi thEn rol 1 ment Event 



Listener Component 



Listener vector 



Generate an 




event 





Process event 



addEnrollmentLi stener (En roll ment Li stener 1) 
removeEnrollmentLi stener (En roll ment Li stener 1) 



Invoke listener's 

en rol 1 ment Exceeded 

method 



Listener class implements 
En rol 1 ment Li stener 



en roll ment Exceeded (En roll ment Event e) 



TestCourseWi thEnrol Imen^EAtgTTf 



Cou rseWi thEn rol lmentEver^^co^se>*--TT?w CourseWithEnrollmentEvent () ; // Create a source object 
EnrollmentLi stener listener = new NewLi stenerO ; // Create a listener object 
cou rse.addEn roll ment Li stener (1 i stener) ; // Register listener to the source 



Figure 32.8 The listener is registered with the source course, and the source invokes the listener's handler 
enrol 1 ment Exceeded to process the event. 



Tip 

Using the ActionEvent/ActionLi stener event set is sufficient in most cases. Normally, 
the information about the event can be obtained from the source. For example, the number of 
students in the course and the enrollment can all be obtained from a course object. The source 
can be obtained by invoking e.getSourceQ for any event e. 



ActionEvent 
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Note 

The Enroll mentEvent component is created from scratch. If you build a new component that 
inheriting features extends a component capable of generating events, the new component inherits the ability to 

generate the same type of events. For example, since JButton is a subclass of 
java.awt. Component that can fire MouseEvent, JButton can also detect and generate 
mouse events. You don't need to write the code to generate these events and register listeners for 
them, since the code is already given in the superclass. However, you still need to write the code 
to make your component capable of firing events not supported in the superclass. 



Key Terms 

event set 1094 JavaBeans events 1094 

JavaBeans component 1092 JavaBeans properties 1093 



Chapter Summary 

1 . JavaBeans is a software component architecture that extends the power of the Java 
language for building reusable software components. JavaBeans properties describe 
the state of the bean. Naturally, data fields are used to store properties. However, a 
bean property is not necessarily a data field. 

2. A source component must have the appropriate registration and deregistration meth- 
ods for adding and removing listeners. Events can be unicasted (only one listener 
object is notified of the event) or multicasted (each object in a list of listeners is no- 
tified of the event). 

3. An event object is created using an event class, such as ActionEvent, MouseEvent, and 
ItemEvent. All event classes extend java.util . EventObject. Every event class is 
associated with an event listener interface that defines one or more methods referred to as 
handlers. An event listener interface is a subinterface of java. util . Event Listener. 
Since an event class and its listener interface are coexistent, they are often referred to as an 
event set or event pair. 



Review Questions 

Sections 32.1-32.4 

32.1 What is a JavaBeans component? Is every GUI class a JavaBeans component? Is 
every GUI user interface component a JavaBeans component? Is it true that a Jav- 
aBeans component must be a GUI user interface component? 

32.2 Describe the naming conventions for accessor and mutator methods in a Jav- 
aBeans component. 

32.3 Describe the naming conventions for JavaBeans registration and deregistration 
methods. 

32.4 What is an event pair? How do you define an event class? How do you define an 
event listener interface? 
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Sections 32.1-32.6 

32.1* (Enabling MessagePanel to fire ActionEvent) The MessagePanel class 
in Listing 15.7 is a subclass of JPanel ; it can fire a MouseEvent, KeyEvent, 
and ComponentEvent, but not an ActionEvent. Modify the MessagePanel 

class so that it can fire an ActionEvent when an instance of the 
MessagePanel class is clicked. Name the new class 
MessagePanel WithActionEvent. Test it with a Java applet that displays the 
current time in a message panel whenever the message panel is clicked, as 
shown in Figure 32.9. 



Figure 32.9 The current time is displayed whenever you click on the message 
panel. 



32.2* (Creating custom event sets and source components) Develop a project that 



meets the following requirements: 

■ Create a source component named MemoryWatch for monitoring memory. 
The component generates a MemoryEvent when the free memory space ex- 
ceeds a specified highLimit or is below a specified lowLimit. The 
highLimit and lowLimit are customizable properties in MemoryWatch. 

■ Create an event set named MemoryEvent and MemoryListener. The 
MemoryEvent simply extends java.util .EventObject and contains 
two methods, f reeMemory and total Memory, which return the free mem- 
ory and total memory of the system. The MemoryListener interface con- 
tains two handlers, suf f icientMemory and insuff icientMemory. The 
suf f icientMemory method is invoked when the free memory space ex- 
ceeds the specified high limit, and insuff icientMemory is invoked when 
the free memory space is less than the specified low limit. The free memory 
and total memory in the system can be obtained using 

Runtime runtime = Runtime. getRuntimeO ; 
runti me . f reeMemory () ; 
runtime. totalMemoryO ; 

■ Develop a listener component that displays free memory, total memory, and 
whether the memory is sufficient or insufficient when a MemoryEvent oc- 
curs. Make the listener an applet with a mai n method to run standalone. 



32.3** (The Hurricane source component) Create a class named Hurricane with 
properties name and category and its accessor methods. The Hurricane 
component generates an ActionEvent whenever its category property is 
changed. Write a listener that displays the hurricane category. If the category 
is 2 or greater, a message "Hurricane Warning" is displayed, as shown in 
Figure 32.10. 
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Figure 32.10 Whenever the hurricane category is changed, an appropriate message is dis- 
played in the message panel. 



32.4** (The Clock source component) Create a JavaBeans component for displaying 
an analog clock. This bean allows the user to customize a clock through the 
properties, as shown in Figure 32.11. Write a test program that displays four 
clocks, as shown in Figure 32.12. 



Clock 



-dateStyle: int ^ 
-digitalDateTimeColor: Color 
-header: String 
-headColor: Color 
-hourHandColor : Color 
-minuteHandColor: Color 
-running: boolean 
-secondHandColor: Color 
-showi ngDi gi tal DateTi me : bool ean 
-showi ngHeader : boolean 
-timeStyle: int 
-timeZonelD: String 
-timeZoneOffset: int 
-tz: TimeZone 
-usingTimeZonelD: boolean 



+Clock 

+Clock(timeZoneID: String) 
+start(): void 
+stop(): void 



JavaBeans properties with get and set 
methods omitted in the UML diagram. 



Date style for the digital date and time string. 

Color of the digital date and time string. 

Clock header string. 

Color of the clock header string. 

Color of the hour hand. 

Color of the minute hand. 

True if the clock is running. 

Color of the second hand. 

True if the digital date and time string is displayed. 

True if the clock header is displayed. 

Time style for the digital date and time string. 

A string for the time zone ID. 

Time zone offset. 

An instance of the Ti meZone class. 
True if time zone id is used. 

Constructs a clock with the default time zone. 
Constructs a clock with the specified time zone. 
Starts the clock. 
Stops the clock. 



Figure 32.1 1 The CI ock component displays an analog clock. 




32.5* (Creating ClockWithAlarm from Clock) Create an alarm clock, named 
ClockWithAlarm, which extends the Clock component built in the preceding 
exercise, as shown in Figure 32.13. This component contains two new proper- 
ties, alarmDate and alarmTime. alarmDate is a string consisting of year, 
month, and day, separated by commas. For example, 1998, 5, 13 represents the 
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Clock 



ClockWithAlarm 



-alarmDate: String 
-alarmTime: String 



JavaBeans properties with get and set 
methods omitted in the UML diagram 



Alarm date. 
Alarm time. 



Figure 32.13 The ClockWithAlarm component extends Clock with alarm functions. 



year 1998, month 5, and day 13. alarmTime is a string consisting of hour, 
minute, and second, separated by commas. For example, 10,45,2 represents 
10 o'clock, 45 minutes, and 2 seconds. When the clock time matches the 
alarm time, ClockWithAlarm fires an ActionEvent. Write a test program 
that displays the alert message "You have an appointment now" on a dialog 
box at a specified time (e.g., date: 2004,1,1 and time: 10,30,0). 

32.6*** (The Tick source component) Create a custom source component that is capa- 
ble of generating tick events at variant time intervals, as shown in Figure 32.14. 
The Tick component is similar to javax. swing. Timer. The Timer class 
generates a timer at fixed time intervals. This Tick component can generate tick 
events at variant as well as at fixed time intervals. 



Tick 



-tickCount: int 
-ticklnterval : int 
-maxlnterval : i nt 
-mi nlnterval : i nt 
-step: long 
-e: TickEvent 

-tickListenerList: ArrayList 
-timer: javax. swing. Timer 



+Tick() 

+Tick(ticklnterval : int, maxlnterval: int, 

minlnterval: int, step: int) 
+ resume(): void 
+suspend(): void 

+addTi ckLi stener(l : Ti ckLi stener) : void 
+ removeTi ckLi stener(l : Ti ckLi stener) : void 
-processEvent(e : TickEvent): void 



JavaBeans properties with get and set 
methods omitted in the UML diagram 



JavaBeans property for ti ckCount (default 0). 
JavaBeans property for ti cklnterval (default 100). 
JavaBeans property for maxlnterval (default 5000). 
JavaBeans property for mi nlnterval (default 1). 
JavaBeans property for step (default 0). 
Ti ck event created from the Ti ck object. 
Stores the Ti ckEvent listeners. 
Timer for controlling the tick. 

Creates a Ti ck object with default properties. 
Creates a Ti ck object with the specified properties. 

Resumes the tick. 

Suspends the tick. 

Adds a new listener to this object. 

Removes a listener from this object. 

Processes the event. 



Figure 32.14 Tick is a component that generates TickEvent. 



The component contains the properties tickCount, ticklnterval, 
maxlnterval, minlnterval, and step. The component adjusts the 
ticklnterval by adding step to it after a tick event occurs. If step is 0, 
ticklnterval is unchanged. If step > 0, ticklnterval is increased. If 
step < 0, ticklnterval is decreased. If ticklnterval > maxlnter- 
val or ticklnterval < minlnterval, the component will no longer 
generate tick events. 
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The Tick component is capable of registering multiple listeners, generat- 
ing TickEvent objects at variant time intervals, and notifying the listeners by 
invoking the listeners' handleTick method. The UML diagram for 
TickEvent and TickListener is shown in Figure 32.15. 



java.util .EventObject 



TickEvent 



java . uti 7 . EventLi stener 
^ 

TickListener 



-tickCount: long 
-ti cklnterval : long 



+Ti ckEvent(source : Object) 
+getTi ckCountO : long 
+getTi cklnterval () : long 
+setTickCount (tickCount: long): void 
+setTi cklnterval (ti cklnterval : long): void 



+handleTick(TickEvent e) : void 



Figure 32.15 TickEvent and TickListener comprise an event set for a tick event. 



Create an applet named DisplayMovingMessage, and create a panel 
named MovingMessage to display the message. Place an instance of the 
panel in the applet. To enable the message to move rightward, redraw the mes- 
sage with a new incremental x-coordinate. Use a Tick object to generate a 
tick event and invoke the repai nt method to redraw the message when a tick 
event occurs. To move the message at a decreasing pace, use a positive step 
(e.g., 10) when constructing a Tick object. 



Chapter 33 

Containers, Layout Managers, 
and Borders 

Objectives 

■ To explore the internal structures of the Swing container (§33.2). 

■ To explain how a layout manager works in Java (§33.3). 

■ To use CardLayout and BoxLayout (§§33.3.1-33.3.2). 

■ To use the absolute layout manager to place components 
in the fixed position (§33.3.3). 

■ To create custom layout managers (§33.4). 

■ To use JScrol 1 Pane to create scroll panes (§33.5). 

■ To use JTabbedPane to create tabbed panes (§33.6). 

■ To use JSpl i tPane to create split panes (§33.7). 

■ To use various borders for Swing components (§33.8). 
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33.1 Introduction 

Chapter 12, "GUI Basics," introduced the concept of containers and the role of layout man- 
agers. You learned how to add components into a container and how to use FlowLayout, 
container Border Layout, and GridLayout to arrange components in a container. A container is an 

layout manager object that holds and groups components. A layout manager is a special object used to place 

components in a container. Containers and layout managers play a crucial role in creating user 
interfaces. This chapter presents a conceptual overview of containers, reviews the layout man- 
agers in Java, and introduces several new containers and layout managers. You will also learn 
how to create custom layout managers and use various borders. 

33.2 Swing Container Structures 

User interface components like JButton cannot be displayed without being placed in a con- 
tainer. A container is a component that holds other components. You do not display a user in- 
terface component; you place it in a container, and the container displays the components it 
contains. 

The base class for all containers is java.awt .Container, which is a subclass of 
java.awt .Component. The Container class has the following essential functions: 

■ It adds and removes components using various add and remove methods. 

■ It maintains a 1 ayout property for specifying a layout manager that is used to lay 
out components in the container. Every container has a default layout manager. 

■ It provides registration methods for the java . awt . event . Container Event. 

In AWT programming, the java . awt . Frame class is used as a top-level container for Java ap- 
plications, the j ava . awt . Appl et class is used for all Java applets, and j ava . awt . Di al og 
is used for dialog windows. These classes do not work properly with Swing lightweight com- 
ponents. Special versions of Frame, Applet, and Dialog named J Frame, JApplet, and 
JDialog have been developed to accommodate Swing components. J Frame is a subclass of 
Frame, J Applet is a subclass of Applet, and JDialog is a subclass of Dialog. JFrame and 
JAppl et inherit all the functions of their heavyweight counterparts, but they have a more com- 
plex internal structure with several layered panes, as shown in Figure 33.1. 



JRootPane 



JLayeredPane 



JMenuBar 




Optional 



Content Pane 



Glass Pane 



Figure 33.1 Swing top-level containers use layers of panes to group lightweight compo- 
nents and make them work properly. 



33.2 Swing Container Structures 1113 



javax. swing. JRootPane is a lightweight container used behind the scenes by Swing's 
top-level containers, such as JFrame, JAppl et, and JDialog. javax. swing. J LayeredPane 
is a container that manages the optional menu bar and the content pane. The content pane is an in- 
stance of Container. By default, it is a JPanel with Border Layout. This is the container 
where the user interface components are added. To obtain the content pane in a JFrame or in a 
JAppl et, use the getContentPaneO method. If you wish to set an instance of Contai ner to 
be a new content pane, use the setContentPane method. The glass pane floats on top of every- 
thing, javax . swi ng . JG1 assPane is a hidden pane by default. If you make the glass pane vis- 
ible, then it's like a sheet of glass over all the other parts of the root pane. It's completely 
transparent, unless you implement the glass pane's paint method so that it paints something, 
and it intercepts input events for the root pane. In general, JRootPane, J LayeredPane, and 
JG1 assPane are not used directly. 

Now let us review the three most frequently used Swing containers: JFrame, JAppl et, 
and JPanel . 

33.2.1 JFrame 

JFrame, a Swing version of Frame, is a top-level container for Java graphics applications. 
Like Frame, JFrame is displayed as a standalone window with a title bar and a border. The 
following properties are often useful in JFrame: 

■ contentPane is the content pane of the frame. 

■ i conlmage is the image that represents the frame. This image replaces the default 
Java image on the frame's title bar and is also displayed when the frame is mini- 
mized. This property type is Image. You can get an image using the Imagelcon 
class, as follows: 

Image image = (new Imagelcon (fi 1 ename)) .getlmageO ; 

■ jMenuBar is the optional menu bar for the frame. 

■ resizable is a boolean value indicating whether the frame is resizable. The 
default value is true. 

■ ti tl e specifies the title of the frame. 

33.2.2 JAppl et 

JAppl et is a Swing version of Appl et. Since it is a subclass of Appl et, it has all the func- 
tions required by the Web browser. Here are the four essential methods defined in Applet: 

// Called by the browser when the Web page containing 
// this applet is initially loaded 
public void init() 

// Called by the browser after the init() method and 
// every time the Web page is visited, 
public void start() 

// Called by the browser when the page containing this 
// applet becomes inactive, 
public void stopO 

// Called by the browser when the Web browser exits, 
public void destroy () 

Additionally, JAppl et has the contentPane and jMenuBar properties, among others. As 
with JFrame, you do not place components directly into JAppl et; instead you place them 
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into the content pane of the applet. The Applet class cannot have a menu bar, but the 
JAppl et class allows you to set a menu bar using the set JMenuBar method. 

|§l Note 

When an applet is loaded, the Web browser creates an instance of the applet by invoking the ap- 
plet's no-arg constructor. So the constructor is invoked before the init method. 

33.2.3 JPanel 

Panels act as subcontainers for grouping user interface components, j avax . swi ng . JPanel 
is different from JFrame and JAppl et. First, JPanel is not a top-level container; it must be 
placed inside another container, and it can be placed inside another JPanel . Second, since 
JPanel is a subclass of JComponent, it is a lightweight component, but JFrame and 
JAppl et are heavyweight components. 

As a subclass of JComponent, JPanel can take advantage of JComponent, such as dou- 
ble buffering and borders. You should draw figures on JPanel rather than JFrame or 
JAppl et, because JPanel supports double buffering, which is the technique for eliminating 
flickers. 

33.3 Layout Managers 

Every container has a layout manager that is responsible for arranging its components. The 
container's set Layout method can be used to set a layout manager. Certain types of con- 
tainers have default layout managers. For instance, the content pane of JFrame or JAppl et 
uses Border Layout, and JPanel uses FlowLayout. 

The layout manager places the components in accordance with its own rules and property 
settings, and with the constraints associated with each component. Every layout manager has 
its own specific set of rules. For example, the FlowLayout manager places components in 
rows from left to right and starts a new row when the previous row is filled. The 
BorderLayout manager places components in the north, south, east, west, or center of the 
container. The Grid Layout manager places components in a grid of cells in rows and 
columns from left to right in order. 

Some layout managers have properties that can affect the sizing and location of the com- 
ponents in the container. For example, BorderLayout has properties called hgap (horizon- 
tal gap) and vgap (vertical gap) that determine the distance between components 
horizontally and vertically. Fl owLayout has properties that can be used to specify the align- 
ment (left, center, right) of the components and properties for specifying the horizontal or 
vertical gap between the components. GridLayout has properties that can be used to speci- 
fy the horizontal or vertical gap between columns and rows and properties for specifying the 
number of rows and columns. These properties can be retrieved and set using their accessor 
and mutator methods. 

The size of a component in a container is determined by many factors, such as: 

■ The type of layout manager used by the container. 

■ The layout constraints associated with each component. 

■ The size of the container. 

■ Certain properties common to all components (such as preferredSize, min- 
imumSize, maximumSize, al ignmentX, and al ignmentY). 

The preferredSize property indicates the ideal size at which the component looks best. 
Depending on the rules of the particular layout manager, this property may or may not be con- 
sidered. For example, the preferred size of a component is used in a container with a 
FlowLayout manager, but ignored if it is placed in a container with a GridLayout manager. 
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The mi ni mumSi ze property specifies the minimum size at which the component is useful. 
For most GUI components, minimumSize is the same as preferredSize. Layout man- 
agers generally respect minimumSize more than preferredSize. 

The maximumSize property specifies the maximum size needed by a component, so that 
the layout manager won't wastefully give space to a component that does not need it. For in- 
stance, BorderLayout limits the center component's size to its maximum size, and gives the 
space to edge components. 

The al ignmentX (al ignmentY) property specifies how the component would like to be 
aligned relative to other components along the x-axis (y-axis). This value should be a number 
between and 1, where represents alignment along the origin, 1 is aligned the farthest away 
from the origin, . 5 is centered, and so on. These two properties are used in the BoxLayout 
and Overl ayLayout. 

Java provides a variety of layout managers. You have learned how to use BorderLayout, 
FlowLayout, and GridLayout. The sections that follow introduce CardLayout, Null lay- 
out, and BoxLayout. GridBagLayout, Overl ayLayout, and SpringLayout are present- 
ed in Supplement III.S. 

j|| Tip 

[f you set a new layout manager in a container, invoke the container's validateO method to 
force the container to again lay out the components. If you change the properties of a layout man- 
ager in a JFrame or JApplet, invoke the doLayoutO method to force the container to again 
lay out the components using the new layout properties. If you change the properties of a layout 
manager in a JPanel , invoke either doLayoutO or reval idate() method to force it to again 
lay out the components using the new layout properties, but it is better to use reval idateO- 
Note that validateO is a public method defined in java.awt. Container, 
revalidateO is a public method defined in javax. swing. ^Component, and 
doLayoutO is a public method defined in java.awt .Container. 



33.3.1 CardLayout 

CardLayout places components in the container as cards. Only one card is visible at a time, 
and the container acts as a stack of cards. The ordering of cards is determined by the contain- 
er's own internal ordering of its component objects. You can specify the size of the horizontal 
and vertical gaps surrounding a stack of components in a CardLayout manager, as shown in 
Figure 33.2. 



vCap 



hGap 




Components in the 
container of 
CardLayout 



Component 1 

Component 2 
Component3 
Component 4 



Figure 33.2 The CardLayout places components in the container as a stack of cards. 



CardLayout defines a set of methods that allow an application to flip through the cards 
sequentially or to display a specified card directly, as shown in Figure 33.3. 
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«i nterface» 
java.awt. LayoutManager 



java.awt.CardLayout 



-hgap: int 
-vgap: int 



+CardLayout() 

+CardLayout(hgap: int, vgap: int) 
+fi rst(parent : Container): void 
+1 ast(parent : Container): void 
+next(parent : Container): void 

+previous(parent: Container): void 



+show(parent : Container, name: String): void 



JavaBeans properties with get and set^^V 
methods omitted in the UML diagram. 



Horizontal gap. 
Vertical gap. 

Creates a default CardLayout manager with no gaps. 
Creates a default CardLayout manager with the specified gaps. 
Flips to the first card in the container. 
Flips to the last card in the container. 

Flips to the next card in the specified container. If the currently visible 
card is the last one, this method flips to the first card in the layout. 

Flips to the previous card in the specified container. If the currently 
visible card is the first one, this method flips to the last card in the 
layout. 

Flips to the component that was added to this layout with the specified 
name. 



Figure 33.3 CardLayout contains the methods to flip the card. 



To add a component into a container, use the add (Component c, String name) 
method defined in the LayoutManager interface. The String parameter, name, gives an ex- 
plicit identity to the component in the container. 

Listing 33.1 gives a program that creates two panels in a frame. The first panel uses 
CardLayout to hold six labels for displaying images. The second panel uses Fl owLayout to 
group four buttons named First, Next, Previous, and Last, and a combo box labeled Image, as 
shown in Figure 33.4. 




These buttons control which image will be shown in the CardLayout panel. When the 
user clicks the button named First, for example, the first image in the CardLayout panel ap- 
pears. The combo box enables the user to directly select an image. 

Listing 33.1 ShowCardLayout. java 

1 import java.awt."-; 

2 import java.awt. event.*; 

3 import javax. swing.*; 
4 

5 public class ShowCardLayout extends JApplet { 
cardlayout 6 private CardLayout CardLayout = new CardLayout(20, 10); 

7 private JPanel cardPanel = new IPanel (cardLayout) ; 
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8 private JButton jbtFirst, jbtNext, jbtPrevious, jbtLast; 

9 private JComboBox jcbolmage; 

10 private final int NUM OF FLAGS = 6; 
11 

12 public ShowCardLayoutO { 

13 cardPanel . setBorder( create UI 

14 new javax. swing. border. Li neBorder(Col or . red)) ; 
15 

16 // Add 9 labels for displaying images into cardPanel 

17 for (int i = 1; i <= NUM_OF_FLACS ; i++) { 

18 DLabel label = 

19 new DLabel (new Imagelcon ("image/ flag" + i + ".gif")); 

20 cardPanel .add(label , String.valueOf (i)) ; 

21 } 
22 

23 // Panel p to hold buttons and a combo box 

24 J Panel p = new JPanelO; 

25 p.add(jbtFirst = new ]Button("First")) ; 

26 p. add (jbtNext = new JButton("Next")) ; 

27 p.add(jbtPrevious= new JButton("Previous")) ; 

28 p.add(jbtLast = new JButton("Last")) ; 

29 p.add(new JLabel ("Image")) ; 

30 p. add (jcbolmage = new JComboBoxO) ; 
31 

32 // Initialize combo box items 

33 for (int i =1; i <= NUM_OF_FLAGS ; i++) 

34 jcbolmage. addItem(String.valueOf(i)) ; 
35 

36 // Place panels in the frame 

37 add(cardPanel , BorderLayout . CENTER) ; 

38 add(p, BorderLayout . SOUTH) ; 
39 

40 // Register listeners with the source objects 

41 jbtFi rst . addActi onLi stener(new ActionLi stener() { register listener 

42 public void actionPerformed(ActionEvent e) { 

43 // Show the first component in cardPanel 

44 cardLayout . f i rst(cardPanel ) ; first component 

45 } 

46 }); 

47 jbtNext. addActionLi stener(new ActionLi stener() { register listener 

48 public void actionPerformed(ActionEvent e) { 

49 // Show the first component in cardPanel 

50 cardLayout . next(cardPanel ) ; next component 

51 } 

52 }); 

53 jbtPrevious. addActi onLi stener(new Acti onLi stener() { register listener 

54 public void actionPerformed(ActionEvent e) { 

55 // Show the first component in cardPanel 

56 cardLayout. previous(cardPanel) ; previous component 

57 } 

58 }); 

59 jbtLast. addActionLi stener(new ActionLi stener() { register listener 

60 public void actionPerformed(ActionEvent e) { 

61 // Show the first component in cardPanel 

62 cardLayout . 1 ast (cardPanel ) ; last component 

63 } 

64 }); 

65 jcbolmage. addltemLi stener(new ItemLi stener() { register listener 

66 public void i temStateChanged(ItemEvent e) { 
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67 
68 
69 
70 
71 

72 } 



// Show the component at specified index 
cardLayout.show(cardPanel , (Stri ng)e . getltemQ) ; 



} 

}); 



} 



main method omitted 



An instance of CardLayout is created in line 6, and a panel of CardLayout is created in line 
7. You have already used such statements as set Layout (new FlowLayoutO) to create an 
anonymous layout object and set the layout for a container, instead of creating a separate in- 
stance of the layout manager, as in this program. The CardLayout object, however, is useful 
later in the program to show components in cardPanel . You have to use 
CardLayout. first (cardPanel) (line 44), for example, to view the first component in 
cardPanel . 

The statement in lines 18-20 adds the image label with the identity String. valueOf (i) . 
Later, when the user selects an image with number i, the identity String. valueOf(i) is 
used in the CardLayout . show() method (line 68) to view the image with the specified 
identity. 



j avax . swi ng . BoxLayout is a Swing layout manager that arranges components in a row or 
a column. To create a BoxLayout, use the following constructor: 

public BoxlayLayout(Container target, int axis) 

This constructor is different from other layout constructors. It creates a layout manager that is 
dedicated to the given target container. The axis parameter is BoxLayout .X_AXIS or 
BoxLayout .Y_AXIS, which specifies whether the components are laid out horizontally or 
vertically. For example, the following code creates a horizontal BoxLayout for panel pi: 

1 Panel pi = new JPanelO; 

BoxLayout boxLayout = new BoxLayout (pi, BoxLayout. X_AXIS) ; 
pi. setLayout(boxLayout) ; 

You still need to invoke the setLayout method on pi to set the layout manager. 

You can use BoxLayout in any container, but it is simpler to use the Box class, which is 
a container of BoxLayout. To create a Box container, use one of the following two static 
methods: 

Box boxl = Box . createHori zontal Box() ; 
Box box2 = Box . createVerti cal Box() ; 

The former creates a box that contains components horizontally, the latter a box that contains 
components vertically. 

You can add components to a box in the same way that you add them to the containers of 
FlowLayout or GridLayout using the add method, as follows: 

boxl.add(new JButton("A Button")); 

You can remove components from a box in the same way that you drop components to a 
container. The components are laid left to right in a horizontal box, and top to bottom in a 
vertical box. 

BoxLayout is similar to GridLayout but has many unique features. 



33.3.2 BoxLayout 
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First, BoxLayout respects a component's preferred size, maximum size, and minimum 
size. If the total preferred size of all the components in the box is less than the box size, then 
the components are expanded up to their maximum size. If the total preferred size of all the 
components in the box is greater than the box size, then the components are shrunk down to 
their minimum size. If the components do not fit at their minimum width, some of them will 
not be shown. In the GridLayout, the container is divided into cells of equal size, and the 
components are fit in regardless of their preferred maximum or minimum size. 

Second, unlike other layout managers, BoxLayout considers the component's 
al ignmentX or al ignmentY property. The al ignmentX property is used to place the com- 
ponent in a vertical box layout, and the al ignmentY property is used to place it in a horizon- 
tal box layout. 

Third, BoxLayout does not have gaps between the components, but you can use fillers to 
separate components. A filler is an invisible component. There are three kinds of fillers: 
struts, rigid areas, and glues. 

A strut simply adds some space between components. The static method create- strut 
HorizontalStrut(int) in the Box class is used to create a horizontal strut, and the static 
method createVerticalStrut(int) to create a vertical strut. For example, the code 
shown below adds a vertical strut of 8 pixels between two buttons in a vertical box. 

box2.add(new JButton("Button 1")); 
box2 . add(Box. createVerti cal Strut(8)) ; 
box2.add(new JButton("Button 2")); 

A rigid area is a two-dimensional space that can be created using the static method rigid area 
createRigidArea(dimension) in the Box class. For example, the next code adds a rigid 
area 10 pixels wide and 20 pixels high into a box. 

box2 . add(Box. createRi gi dArea(new Dimension (10, 20)); 

A glue separates components as much as possible. For example, by adding a glue between glue 
two components in a horizontal box, you place one component at the left end and the other at 
the right end. A glue can be created using the Box . created ue() method. 

Listing 33.2 shows an example that creates a horizontal box and a vertical box. The hori- 
zontal box holds two buttons with print and save icons. The vertical box holds four buttons for 
selecting flags. When a button in the vertical box is clicked, a corresponding flag icon is dis- 
played in the label centered in the applet, as shown in Figure 33.5. 



I ShowBoxLayout 



- n x 



Canada 



Norway 



Germany 



| ShowBoxLayout 




Figure 33.5 The components are placed in the containers of BoxLayout. 

Listing 33.2 ShowBoxLayout . j ava 

1 import java.awt.'" ; 

2 import java.awt. event.*; 

3 import javax. swi ng . * ; 
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public class ShowBoxLayout extends DApplet { 

// Create two box containers 

private Box boxl = Box . createHori zontal Box() ; 

private Box box2 = Box . createVerti cal Box() ; 

// Create a label to display flags 
private J Label jlblFlag = new DLabelO; 

// Create image icons for flags 
private Imagelcon imagelconUS = 

new Imagelcon (getCl ass O .getResource("image/us.gif")) ; 
private Imagelcon i magelconCanada = 

new ImageIcon(getClass() .getResource("image/ca.gif")) ; 
private Imagelcon i magelconNorway = 

new Imagelcon (getCl ass O .getResource("image/norway.gif")) I 
private Imagelcon i magelconGermany = 

new ImageIcon(getClass() .getResource("image/germany.gif")) ; 
private Imagelcon i magelconPri nt = 

new ImageIcon(getClass() .getResource("image/print.gif")) ; 
private Imagelcon i magelconSave = 

new ImageIcon(getClass() .getResource("image/save.gif")) ; 



// Create buttons to select 
private JButton jbtUS = new 
private JButton jbtCanada = 
private JButton jbtNorway = 
private JButton jbtGermany = 



i mages 

lButton("US") ; 
new JButton("Canada") ; 
new ]Button("Norway") ; 
new J Button ("Germany") ; 



public ShowBoxLayoutO { 

boxl.add(new JButton(imageIconPri nt)) ; 
boxl. add (Box. createHori zontal St rut (20)) ; 
boxl. add(new JButton(imagelconSave)) ; 

box2.add(jbtUS) ; 

box2 . add(Box .createVerti cal Strut(8)) ; 

box2 . add ( j btCanada) ; 

box2 . add (Box .created ue()) ; 

box2 . add ( j btNo rway) ; 

box2 . add (Box . createRigi dArea(new Dimension (10 , 
box2 . add (jbtGermany) ; 



8))); 



boxl. setBorder (new javax . swi ng . border . Li neBorder(Col or , 
box2 . setBorder(new javax . swi ng . border . Li neBorder(Col or , 

add(boxl, BorderLayout . NORTH) ; 
add(box2, BorderLayout . EAST) ; 
add(jlblFlag, BorderLayout . CENTER) ; 

// Register listeners 

jbtUS.addActionListener(new Acti onLi stener() { 
public void actionPerformed(ActionEvent e) { 
jl bl Fl ag . setlcon (imagelconUS) ; 

} 

}); 

jbtCanada. addActi onLi stener(new Acti onLi stener() { 
public void actionPerformed(ActionEvent e) { 
j 1 bl Fl ag . setlcon (i magelconCanada) ; 

} 



red)); 
black)) ; 
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63 }); 

64 jbtNorway . addActi onLi stener(new Acti onLi stenerO { 

65 public void actionPerformed(ActionEvent e) { 

66 j 1 bl Fl ag . setlcon(imagelconNorway) ; 

67 } 

68 }); 

69 jbtGermany.addActionListener(new ActionLi stenerO { 

70 public void actionPerformed(ActionEvent e) { 

71 jl bl Fl ag . setlcon(imagelconGermany) ; 

72 } 

73 }); 

74 } 

75 } main method omitted 



Two containers of the Box class are created in lines 7-8 using the convenient static methods 
createHorizontalBoxO and createVertical Box(). The box containers always use 
the BoxLayout manager. You cannot reset the layout manager for the box containers. 

The image icons are created from image files (lines 14-25) through resource URL, intro- 
duced in §18.10, "Locating Resource Using the URL Class." 

Two buttons with print and save icons are added into the horizontal box (lines 34-36). A 
horizontal strut with size 20 is added between these two buttons (line 35). 

Four buttons with texts US, Canada, Norway, and Germany are added into the vertical box 
(lines 38^44). A horizontal strut with size 8 is added to separate the US button and the Cana- 
da button (line 39). A rigid area is inserted between the Norway button and the Germany but- 
ton (line 43). A glue is inserted to separate the Canada button and the Norway button as far as 
possible in the vertical box. 

The strut, rigid area, and glue are instances of Component, so they can be added to the box 
container. In theory, you can add them to a container other than the box container. But they 
may be ignored and have no effect in other containers. 

33.3.3 Using Null Layout Manager 

If you have used a Windows-based visual form design tool like Visual Basic, you know that 
it is easier to create user interfaces with Visual Basic than in Java. This is mainly because in 
Visual Basic the components are placed in absolute positions and sizes, whereas in Java they 
are placed in containers using a variety of layout managers. Absolute positions and sizes are 
fine if the application is developed and deployed on the same platform, but what looks fine on 
a development system may not look right on a deployment system. To solve this problem, 
Java provides a set of layout managers that place components in containers in a way that is in- 
dependent of fonts, screen resolutions, and platform differences. 

For convenience, Java also supports an absolute layout, called null layout, which enables null layout 
you to place components at fixed locations. In this case, the component must be placed using 
the component's instance method setBoundsO (defined in java.awt. Component), as 
follows: 

public void setBounds(int x, int y, int width, int height); 
This sets the location and size for the component, as in the next example: 

DButton jbt = new JButton("Help") ; 
jbt.setBounds(10, 10, 40, 20); 

The upper-left corner of the Help button is placed at (10, 10); the button width is 40, and the 
height is 20. 
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Here are the steps of adding a button to a container with a null layout manager: 

1. Specify a null layout manager as follows: 
contai ner . setLayout(null ) ; 

2. Add the component to the container: 
JButton jbt = new J Button ("Help") ; 
container. add(jbt) ; 

3. Specify the location where the component is to be placed, using the setBounds method: 

jbt. setBounds (10, 10, 40, 20); 

Listing 33.3 gives a program that places three buttons, as shown in Figure 33.6(a). 





(a) (b) 

Figure 33.6 (a) The components are placed in the frame using a null layout manager, 
(b) With a null layout manager, the size and positions of the components are fixed. 



Listing 33.3 ShowNoLayout . java 



main method omitted 
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import java.awt.*; 
import javax. swi ng . * ; 

public class ShowNoLayout extends J Applet { 
private JButton jbtRed = new JButton("Red" ); 
private JButton jbtBlue = new JButton("Blue" ); 
private JButton jbtGreen = new JButton("Green" ); 

public ShowNoLayout () { 

// Set foreground color for the buttons 
jbtRed . set Foreground (Col or . RED) ; 
jbtBl ue . set Foreground (Col or . BLUE) ; 
jbtGreen . set Foreground (Col or .GREEN) ; 

// Specify a null layout manager 
setLayout(null) ; 

// Add components to container 
add (jbtRed) ; 
add(jbtBlue) ; 
add(jbtGreen) ; 

// Put components in the right place 
jbtRed. setBounds(150, 50, 100, 50); 
jbtBlue. setBounds (100, 100, 100, 50); 
jbtGreen. setBounds(200, 100, 100, 50); 
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If you run this program on Windows with 1024 X 768 resolution, the layout size is just right. 
When the program is run on Windows with a higher resolution, the components appear very 
small and clump together. When it is run on Windows with a lower resolution, they cannot be 
shown in their entirety. 

If you resize the window, you will see that the location and the size of the components are 
not changed, as shown in Figure 33.6(b). 

# Tip 

Do not use the null-layout-manager to develop platform-independent applications. 

33.4 Creating Custom Layout Managers 

In addition to the layout managers provided in Java, you can create your own. To do so, you 
need to understand how a layout manager lays out components. A container's setLayout 
method specifies a layout manager for the container. The layout manager is responsible for 
laying out the components and displaying them in a desired location with an appropriate size. 
Every layout manager must directly or indirectly implement the LayoutManager interface. 
For instance, FlowLayout directly implements LayoutManager, and Border Layout im- 
plements LayoutManager2, a subclass of LayoutManager. The LayoutManager interface 
provides the following methods for laying out components in a container: 

■ public void addLayoutComponent(Stri ng name, Component comp) 
Adds the specified component with the specified name to the container. 

■ public void 1 ayoutContai ner (Container parent) 

Lays out the components in the specified container. In this method, you should pro- 
vide concrete instructions that specify where the components are to be placed. 

■ public Dimension minimumLayoutSize(Container parent) 

Calculates the minimum size dimensions for the specified panel, given the compo- 
nents in the specified parent container. 

■ public Dimension preferredLayoutSi ze(Contai ner parent) 

Calculates the preferred size dimensions for the specified panel, given the compo- 
nents in the specified parent container. 

■ public void removeLayoutComponent(Component comp) 
Removes the specified component from the layout. 

These methods in LayoutManager are invoked by the methods in the java.awt. Container 
class through the layout manager in the container. Contai ner contains a property named 1 ayout 
(an instance of LayoutManager) and the methods for adding and removing components from the 
container. There are five overloading add methods defined in Contai ner for adding components 
with various options. The remove method removes a component from the container. The add 
method invokes addlmpl , which then invokes the addLayoutComponent method defined in the 
LayoutManager interface. The 1 ayoutContai ner method in the LayoutManager interface is 
indirectly invoked by the val idateO method through several calls. The remove method in- 
vokes removeLayoutComponent in LayoutManager. The val idate method is invoked to re- 
fresh the container after the components it contains have been added to or modified. The 
relationship of Container and LayoutManager is shown in Figure 33.7. 

Let us define a custom layout manager named Diagonal Layout that places the compo- 
nents in a diagonal. To test Diagonal Layout, the example creates an applet with radio 
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Figure 33.7 The add, remove, and val idate methods in Container invoke the meth- 
ods defined in the LayoutManager interface. 

buttons named "FlowLayout," "GridLayout," and "DiagonalLayout," as shown in Figure 33. 
You can dynamically select one of these three layouts in the panel. 



Button 3 



Button 4 



Select a Layout Manager 
O FlowLayout O GridLayout ® DiagonalLayout 



Figure 33.8 The Diagonal Layout manager places the components in a diagonal in the 
container. 



properties 



DiagonalLayout is similar to FlowLayout. DiagonalLayout arranges components 
along a diagonal using each component's natural preferredSize. It contains three con- 
straints, gap, 1 astFil 1 , and majorDi agonal , as shown in Figure 33.9. The source code for 
Diagonal Layout is given in Listing 33.4. 

Listing 33.4 DiagonalLayout. j ava 

import java.awt.*; 
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public class DiagonalLayout implements LayoutManager, 
java.io.Serializable { 

/** Vertical gap between the components */ 
private int gap = 10; 

/** True if components are placed along the major diagonal */ 
private boolean majorDi agonal = true; 

/*True if the last component is stretched to fill the space */ 
private boolean lastFill = false; 

/** Constructor */ 
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15 public Di agonal Layout () { 

16 } 
17 

18 public void addLayoutComponent(Stri ng name, Component comp) { 

19 //TODO: implement this java. awt . LayoutManager method; 

20 } 
21 

22 public void removeLayoutComponent (Component comp) { 

23 //TODO: implement this java. awt. LayoutManager method; 

24 } 
25 

26 public Dimension preferredLayoutSize(Container parent) { 

27 //TODO: implement this java. awt. LayoutManager method; 

28 return minimumLayoutSize(parent) ; 

29 } 
30 

31 public Dimension mi ni mumLayoutSi ze(Contai ner parent) { 

32 //TODO: implement this java. awt . LayoutManager method; 

33 return new Dimension(0, 0); 

34 } 
35 

36 public void 1 ayoutContai ner(Contai ner parent) { layout container 

37 //TODO: implement this java. awt . LayoutManager method; 

38 int numberOfComponents = parent . getComponentCountO ; 
39 

40 Insets insets = parent. getlnsets() ; 

41 int w = parent . getSi ze() .wi dth - insets. left - i nsets . ri ght ; 

42 int h = parent . getSi ze() . hei ght - i nsets . bottom - insets. top; 
43 

44 if (majorDi agonal ) { 

45 int x = 10, y = 10; 
46 

47 for (int j = 0; j < numberOfComponents; j++) { 

48 Component c = parent. getComponent(j) ; 

49 Dimension d = c . getPreferredSi ze() ; 
50 

51 if (c.isVisibleO) 

52 if (lastFill && (j == numberOfComponents - 1)) 

53 c.setBounds(x, y, w - x, h - y); 

54 else 

55 c.setBounds(x, y, d. width, d. height); 

56 x += d. height + gap; 

57 y += d. hei ght + gap; 

58 } 

59 } 

60 else { // It is subdi agonal 

61 int x = w - 10, y = 10; 
62 

63 for (int j = 0; j < numberOfComponents; j++) { 

64 Component c = parent. getComponent(j) ; 

65 Dimension d = c . getPreferredSi ze() ; 
66 

67 if (c.isVisibleO) 

68 if (lastFill & (j == numberOfComponents - 1)) 

69 c.setBounds(0, y, x, h - y) ; 

70 else 

71 c.setBounds(x, d. width, y, d. height); 
72 

73 x -= (d. height + gap); 
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74 y += d. height + gap; 

75 } 

76 } 

77 } 
78 

79 public int getGapO { 

80 return gap; 

81 } 
82 

83 public void setGap(int gap) { 

84 this. gap = gap; 

85 } 
86 

87 public void setMajorDi agonal (boolean newMajorDi agonal ) { 

88 majorDi agonal = newMajorDi agonal ; 

89 } 
90 

91 public boolean i sMajorDi agonal () { 

92 return majorDi agonal ; 

93 } 
94 

95 public void setLastFi 11 (boolean newLastFill) { 

96 lastFill = newLastFill; 

97 } 
98 

99 public boolean isLastFillO { 

100 return lastFill ; 

101 } 

102 } 



«i nterface» 
java.awt.LayoutManager 



3 

1 
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JavaBeans properties with get and set 
methods omitted in the UML diagram. J 


DiagonalLayout 




-gap: int 

-lastFill : boolean 
-majorDi agonal : boolean 






The gap between the components. 

A Boolean value indicating whether the last component in the 
container is stretched to fill the rest of the space. 

A Boolean value indicating whether the components are 
placed along the major diagonal or the subdiagonal. 


+Di agonal Layout () 




Creates a Di agonal Layout. 



Figure 33.9 The Diagonal Layout manager has three properties with the supporting accessor and mutator methods. 



The Diagonal Layout class implements the LayoutManager and Serial izabl e interfaces 
(lines 3-4). The reason to implement Serial izabl e is to make it a JavaBeans component. 

The Insets class describes the size of the borders of a container. It contains the variables 
left, right, bottom, and top, which correspond to the measurements for the left border, 
right border, top border, and bottom border (lines 40-42). 

The Dimension class used in Diagonal Layout encapsulates the width and height of a 
component in a single object. The class is associated with certain properties of components. 
Several methods defined by the Component class and the LayoutManager interface return a 
Dimension object. 

Listing 33.5 gives a test program that uses Diagonal Layout. 
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Listing 33.5 ShowDi agonal Layout . j ava 

1 import javax. swi ng . * ; 

2 import javax. swing. border.*; 

3 import java.awt.*; 

4 import java.awt. event.*; 
5 

6 public class ShowDi agonal Layout extends J Applet { 



7 private FlowLayout flowLayout = new Fl owLayoutO ; 

8 private CridLayout gridLayout = new Gri dLayout(2 , 2); 

9 private Di agonal Layout di agonal Layout = new Di agonal LayoutO ; diagonal layout 
10 

11 private JButton jbtl = new JButton("Button 1"); 

12 private JButton jbt2 = new J Button ("Button 2"); 

13 private JButton jbt3 = new JButton("Button 3"); 

14 private JButton jbt4 = new JButton("Button 4"); 
15 

16 private JRadioButton j rbFlowLayout = 

17 new JRadioButton ("FlowLayout") ; 

18 private JRadioButton j rbCri dLayout = 

19 new J RadioButton ("Gri dLayout") ; 

20 private JRadioButton j rbDi agonal Layout = 

21 new JRadioButton("Diagonal Layout" , true); 
22 

23 private JPanel jPane!2 = new JPanelO; 
24 

25 public ShowDi agonal LayoutO { 

26 // Set default layout in j Panel 2 

27 j Panel 2 . setLayout(di agonal Layout) ; create UI 

28 j Panel 2. add (jbtl) ; 

29 jPanel2.add(jbt2) ; 

30 jPanel2.add(jbt3) ; 

31 jPanel2.add(jbt4) ; 

32 j Panel 2 . setBorder(new Li neBorder(Col or . black)) ; 
33 

34 JPanel j Panel 1 = new JPanelO; 

35 jPanel 1. setBorder(new TitledBorder("Select a Layout Manager")); 

36 jPanell.add(jrbFlowLayout) ; 

37 jPanell.add(jrbGridLayout) ; 

38 j Panel 1. add (j rbDi agonal Layout) ; 
39 

40 ButtonGroup buttonGroupl = new ButtonGroupO ; 

41 buttonGroupl. add(j rbFlowLayout) ; 

42 buttonGroupl. add(j rbGri dLayout) ; 

43 buttonGroupl . add( j rbDi agonal Layout) ; 
44 

45 add(jPanell, BorderLayout . SOUTH) ; 

46 add(jPane!2, BorderLayout . CENTER) ; 
47 

48 jrbFlowLayout.addActionListener(new ActionLi stener() { register listener 

49 public void actionPerformed(ActionEvent e) { 

50 jPanel 2 . setLayout(flowLayout) ; 

51 j Panel 2 . reval i date () ; 

52 } 

53 }); 

54 jrbGridLayout.addActionListener(new ActionLi stener() { register listener 

55 public void actionPerformed(ActionEvent e) { 

56 j Panel 2 . setLayout(gri dLayout) ; 

57 j Panel 2 . reval i date () ; 

58 } 



1 128 Chapter 33 Containers, Layout Managers, and Borders 



register listener 



main method omitted 
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}); 

j rbDi agonal Layout . addActionLi stener(new Action Li stenerO 
public void actionPerformed(ActionEvent e) { 
j Panel 2 . set Layout (di agonal Layout) ; 
j Panel 2 . reval i date () ; 

} 

}); 



} 



The TestDi agonal Layout class enables you to dynamically set the layout in j Panel 2. 
When you select a new layout, the layout manager is set in j Panel 2, and the reval i date () 
method is invoked (lines 51, 57, 63), which in turn invokes the 1 ayoutContainer method in 
the LayoutManager interface to display the components in the container. 

33.5 JScrollPane 

Often you need to use a scroll bar to scroll the contents of an object that does not fit com- 
pletely into the viewing area. JScrollBar and JSlider can be used for this purpose, but 
you have to manually write the code to implement scrolling with them. JScrollPane is a 
component that supports automatic scrolling without coding. It was used to scroll the text area 
in Listing 17.7, TextAreaDemo.java, and to scroll a list in Listing 17.9, ListDemo.java. In 
fact, it can be used to scroll any subclass of ^Component. 

A JScrol 1 Pane can be viewed as a specialized container with a view port for displaying 
the contained component. In addition to horizontal and vertical scroll bars, a JScrol 1 Pane 
can have a column header, a row header, and corners, as shown in Figure 33.10. 



Corner 
Component 



Column 
Header 



Corner 
Component 



Row Header 



Corner 
Component 



JViewport 



Scrollable Component 



Vertical Scroll 
Bars 



Corner 
Component 



Horizontal 
Scroll Bars 

Figure 33.10 A JScrol 1 Pane has a view port, optional horizontal and vertical bars, op- 
tional column and row headers, and optional corners. 



view port The view port is an instance of JViewport through which a scrollable component is dis- 

played. When you add a component to a scroll pane, you are actually placing it in the scroll 
pane's view port. Figure 33.11 shows the frequently used properties, constructors, and meth- 
ods in JScrol 1 Pane. 
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j a vax.s wing. JScrollPane 



#col umnHeader : JViewport 

#rowHeader: JViewport 

#hori zontal Scrol 1 BarPol i cy : i nt 

#vertical Scroll BarPol icy: int 

#viewport: JViewport 
#horizontalScrollBar: JScrollBar 
#vertical Scroll Bar: JScrollBar 
-vi ewportBorder : Border 



+JScrollPane() 

+JScroll Pane(vi ew: Component) 



+JScroll Pane(vi ew: Component, vsbPolicy: 
int, hsbPolicy: int) 

+JScroll Pane(vsbPol i cy : int, hsbPolicy: int) 

+setCorner(key : String, corner: 
Component): void 

+setVi ewportVi ew(vi ew: Component): void 



JavaBeans properties with get and set 
methods omitted in the UML diagram. 



2> 



The column header (default: nul 1 ). 
The row header (default: null). 

The display policy for the horizontal scroll bar (default: 
JScrol 1 Pane . HORIZONTAL_SCROLLBAR_AS_NEEDED). 

The display policy for the horizontal scroll bar (default: 
J Scrol 1 Pane . VERTICAL_SCROLLBAR_AS_NEEDED). 

The scroll pane's view port. 

The scroll pane's horizontal scroll bar. 

The scroll pane's vertical scroll bar. 

The border around the view port. 

Creates an empty JScrol 1 Pane where both horizontal and vertical 

scroll bars appear when needed. 
Creates a JScrol 1 Pane that displays the contents of the specified 

component, where both horizontal and vertical scroll bars 

appear whenever the component's contents are larger than the 

view. 

Creates a JScrol 1 Pane that displays the contents of the specified 
component with the specified horizontal and vertical scroll bar 
policies. 

Creates an empty JScrol 1 Pane with the specified horizontal and 
vertical scroll bar policies. 

Adds a component in one of the scroll pane's corners. 
Adds a view component to the view port. 



Figure 33.1 1 JScrol 1 Pane provides methods for displaying and manipulating the components in a scroll pane. 



The constructor always creates a view port regardless of whether the viewing component is 
specified. Normally, you have the component and you want to place it in a scroll pane. A con- 
venient way to create a scroll pane for a component is to use the JScrol 1 Pane (component) 
constructor. 

The vsbPol icy parameter can be one of the following three values: 

JScrol 1 Pane . VERTICAL_SCROLLBAR_AS_NEEDED 
J Scroll Pane. VERTICAL_SCROLLBAR_NEVER 
JScrol 1 Pane . VERTICAL_SCROLLBAR_ALWAYS 

The hsbPol icy parameter can be one of the following three values: 

JSc roll Pane. HORIZONTAL_SCROLLBAR_AS_NEEDED 
JSc roll Pane. HORIZONTAL_SCROLLBAR_NEVER 
JSc roll Pane. HORIZONTAL„SCROLLBAR_ALWAYS 

To set a corner component, you can use the setCorner(String key, Component cor- 
ner) method. The legal values for the key are: 

J Scroll Pane. LOWER_LEFT_CORNER 
J Scrol 1 Pane . LOWER_RIGHT_CORNER 
JScrol 1 Pane . UPPER_LEFT_CORNER 
JScrol 1 Pane . UPPER_RICHT_CORNER 

Listing 33.6 shows an example that displays a map in a label and places the label in a scroll 
pane so that a large map can be scrolled. The program lets you choose a map from a combo 
box and display it in the scroll pane, as shown in Figure 33.12. 
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Select a map to display 
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(ScrollMap 



Select a map to display 



Ohio 




Figure 33.12 The scroll pane can be used to scroll contents automatically. 



Listing 33.6 Scrol IMap. java 



labels 



create UI 



scroll pane 



1 
2 
3 
4 
5 
6 
7 
8 
9 
10 
11 
12 
13 
14 
15 
16 
17 
18 
19 
20 
21 
22 
23 
24 
25 
26 
27 
28 
29 
30 
31 
32 
33 
34 
35 
36 
37 
38 
39 
40 
41 



import java.awt.*; 
import java. awt . event .* ; 
import javax. swing.*; 
import javax. swing. border.*; 

public class ScrollMap extends JApplet { 
// Create images in labels 
private J Label 1 bl Indi anaMap = new J Label ( 

new ImageIcon(getCl ass O . get Resource ("image/i ndianaMap.gif"))) ; 
private J Label lblOhioMap = new J Label ( 

new ImageIcon(getClass() .getResource("image/ohioMap.gif"))) I 

// Create a scroll pane to scroll map in the labels 

private JScrollPane jspMap = new DScrol 1 Pane(l bl Indi anaMap) ; 

public ScrollMapO { 

// Create a combo box for selecting maps 
JComboBox jcboMap = new JComboBox(new Stri ng [] {"Indiana" , 
"Ohio"}); 

// Panel p to hold combo box 
1 Panel p = new JPanelO; 
p . setLayout(new BorderLayoutO) ; 
p.add(jcboMap) ; 

p . setBorder(new Ti tl edBorder("Sel ect a map to display")); 

// Set row header, column header and corner header 
jspMap.setColumnHeaderView(new DLabel (new ImageIcon(getClass() . 

getResource(" image/horizontal Ruler .gi f ")))) ; 
jspMap.setRowHeaderView(new DLabel(new ImageIcon(getClass() . 

getResource(" image/vertical Ruler .gi f ")))) ; 
jspMap . setCorner CScrol 1 Pane . UPPER_LEFT_C0RNER, 

new CornerPanel CScrol 1 Pane . UPPER_LEFT_C0RNER)) ; 
jspMap . setCorner (Scrol 1 PaneConstants . UPPER_RIGHT_C0RNER, 

new CornerPanel CScrol 1 Pane . UPPER_RIGHT_CORNER) ) ; 
jspMap . setCorner CScrol 1 Pane . L0WER_RIGHT_C0RNER, 

new CornerPanel (D Scrol 1 Pane . L0WER_RIGHT_C0RNER)) ; 
jspMap . setCorner CScrol 1 Pane . L0WER_LEFT_C0RNER , 

new CornerPanel (DScrol 1 Pane . L0WER_LEFT_C0RNER)) ; 

// Add the scroll pane and combo box panel to the frame 
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42 add(jspMap, BorderLayout . CENTER) ; 

43 add(p, BorderLayout . NORTH) ; 
44 

45 // Register listener 

46 jcboMap.addItemListener(new ItemLi stener() { register listener 

47 /** Show the selected map */ 

48 public void i temStateChanged(ItemEvent e) { 

49 String sel ectedltem = (Stri ng)e . getltem() ; 

50 if (selectedltem.equals("lndiana")) { 

51 // Set a new view in the view port 

52 jspMap.setViewportView(lbllndianaMap) ; 

53 } 

54 else if (selectedltem.equals("0hio")) { 

55 // Set a new view in the view port 

56 jspMap.setViewportView(lblOhioMap) ; 

57 } 
58 

59 // Revalidate the scroll pane 

60 jspMap. revalidate () ; 

61 } 

62 }); 

63 } 

64 } main method omitted 
65 

66 // A panel displaying a line used for scroll pane corner 

67 class CornerPanel extends J Panel { 

68 // Line location 

69 private String location; 
70 

71 public CornerPanel (Stri ng location) { 

72 this. location = location; 

73 } 
74 

75 /** Draw a line depending on the location */ 

76 protected void pai ntComponent(Craphi cs g) { 

77 super. pai ntComponents(g) ; 
78 

79 if (location == "UPPER LEFT CORNER") 

80 g.drawLine(0, getHeight(), getWidth(), 0); 

81 else if (location == "UPPER RIGHT CORNER") 

82 g.drawLine(0, 0, getWidth(), getHei ght()) ; 

83 else if (location == "LOWER RIGHT CORNER") 

84 g.drawLine(0, getHeight(), getWidth(), 0); 

85 else if (location == "LOWER LEFT CORNER") 

86 g.drawLine(0, 0, getWidth(), getHei ght()) ; 

87 } 

88 } 

The program creates a scroll pane to view image maps. The images are created from image 
files and displayed in labels (lines 8-11). To view an image, the label that contains the image 
is placed in the scroll pane's view port (line 14). 

The scroll pane has a main view, a header view, a column view, and four corner views. 
Each view is a subclass of Component. Since Imagelcon is not a subclass of Component, it 
cannot be directly used as a view in the scroll pane. Instead the program places an 
Imagelcon to a label and uses the label as a view. 

The CornerPanel (lines 67-88) is a subclass of JPanel that is used to display a line. 
How the line is drawn depends on the location of the corner. The location is a string 
passed in as a parameter in the CornerPanel 's constructor. 
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Whenever a new map is selected, the label for displaying the map image is set to the scroll 
pane's view port. The reval idateO method (line 60) must be invoked to cause the new 
image to be displayed. The reval idateO method causes a container to lay out its subcom- 
ponents again after the components it contains have been added to or modified. 

33.6 JTabbedPane 

JTabbedPane is a useful Swing container that provides a set of mutually exclusive tabs for 
accessing multiple components, as shown in Figure 33.13. 
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Figure 33.13 JTabbedPane displays components through the tabs. 



Usually you place the panels inside a JTabbedPane and associate a tab with each panel. 
JTabbedPane is easy to use, because the selection of the panel is handled automatically by 
clicking the corresponding tab. You can switch between a group of panels by clicking on a tab 
with a given title and/or icon. Figure 33.14 shows the frequently used properties, constructors, 
and methods in JTabbedPane. 



javax. swi ng . JComponent 







#tabPlacement: int 



#selectedComponent: Component 
#selectedlndex: int 



+JTabbedPane() 

+JTabbedPane(tabP1acement: int) 
+getIconAt(index: int): Icon 
+setIconAt(index: int, icon: Icon): void 
+getTabCount() : int 
+getTitleAt(int index): String 
+setTitleAt(index: int, title: String): void 
+getToolTipTextAt(index: int): String 
+setToolTipTextAt(index: int, toolTipText: 

String): void 
+indexOfComponent(component: Component): void 
+i ndexOfTab(i con : Icon): int 
+index0fTab(tit1e: String): int 



JavaBeans properties with get and set 
methods omitted in the UML diagram 



The tab placement for this tabbed pane. Possible values are: 
JTabbedPane .TOP, JTabbedPane . BOTTOM. JTabbedPane . LEFT, 
and JTabbedPane. RIGHT (default: JTabbedPane .TOP). 

The currently selected component for this tabbed pane. 
The currently selected index for this tabbed pane. 

Constructs a JTabbedPane with default tab placement. 

Constructs a JTabbedPane with the specified tab placement. 

Returns the icon at the specified tab index. 

Sets the icon at the specified tab index. 

Returns the number of tabs in this tabbed pane. 

Returns the tab title at the specified tab index. 

Sets the tab title at the specified tab index. 

Returns the tool tip text at the specified tab index. 

Sets the tool tip text at the specified tab index. 

Returns the index of the tab for the specified component. 
Returns the index of the tab for the specified icon. 
Returns the index of the tab for the specified title. 



Figure 33.14 JTabbedPane provides methods for displaying and manipulating the components in the tabbed pane. 
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Listing 33.7 gives an example that uses a tabbed pane with four tabs to display four types 
of figures: line, rectangle, rounded rectangle, and oval. You can select a figure to display by 
clicking the corresponding tab, as shown in Figure 33.13. The FigurePanel class for dis- 
playing a figure was presented in Listing 15.3 FigurePanel.java. You can use the type prop- 
erty to specify a figure type. 

Listing 33.7 DisplayFigure. java 

1 import java.awt.*; 

2 import javax. swing.*; 
3 

4 public class DisplayFigure extends DApplet { 

5 private JTabbedPane jtpFigures = new JTabbedPaneO ; 
private FigurePanel squarePanel = new FigurePanel () ; 
private FigurePanel rectangl ePanel = new Fi gurePanel () ; 
private FigurePanel circlePanel = new FigurePanel () ; 
private FigurePanel oval Panel = new Fi gurePanel () ; 



tabbed pane 



6 

7 

8 

9 
10 
11 
12 
13 
14 
15 
16 
17 
18 
19 
20 
21 
22 
23 
24 
25 
26 
27 

28 } 



public DisplayFigureO { 

squarePanel .setType(FigurePanel .LINE) ; 
rectangl ePanel . setType (FigurePanel .RECTANGLE) ; 
ci rcl ePanel .setType (FigurePanel . ROUND_RECTANGLE) ; 
oval Panel . setType (Fi gurePanel .OVAL) ; 

add(jtpFigures, BorderLayout . CENTER) ; 
jtpFigures . add (squarePanel , "Line") ; 
jtpFigures. add(rectanglePanel , "Rectangle") ; 
jtpFigures. add(ci rclePanel , "Round Rectangle"); 
jtpFigures . add(oval Panel , "Oval ") ; 

jtpFigures. setToolTi pTextAt(0 , "Square") ; 

jtpFigures . setToolTi pTextAt(l, "Rectangle") ; 

jtpFigures . setToolTi pTextAt(2 , "Circle") ; 

jtpFigures.setToolTipTextAt(3, "Oval") ; 



set type 



add tabs 



set tool tips 



main method omitted 



The program creates a tabbed pane to hold four panels, each of which displays a figure. A 
panel is associated with a tab. The tabs are titled Line, Rectangle, Rounded Rectangle, 
and Oval. 

By default, the tabs are placed at the top of the tabbed pane. You can select a different 
placement using the tabPl acement property. 



33.7 JSplitPane 

JSpl itPane is a convenient Swing container that contains two components with a separate 
bar known as a divider, as shown in Figure 33.15. 



H JSplitPane Demo 


-In|x 


Left Component 


Right Component 



I JSpfitPaneDemo 



Top Component 



Bottom Component 



(a) Vertical divider (b) Horizontal divider 

Figure 33.15 JSpl itPane divides a container into two parts. 
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The bar can divide the container horizontally or vertically and can be dragged to change 
the amount of space occupied by each component. Figure 33.16 shows the frequently used 
properties, constructors, and methods in JSpl itPane. 



j avax . swi ng . JComponent 



javax.swing.JSpIitPane 



#conti nuousLayout : boolean 

#dividerSize: int 
#lastDividerLocation: int 
#1 eftComponent : Component 
#oneTouchExpandable: boolean 



#ori entati on: int 



#ri ghtComponent : Component 



+DSplitPane() 

+DSpl i tPane (newOri entati on : i nt) 

+DSpl i tPane (newOri entati on : i nt , 
newConti nuousLayout: boolean) 

+DSpl i tPane (newOri entati on : i nt , 
newConti nuousLayout: boolean, 
newLeftComponent : Component, 
newRi ghtComponent: Component) 

+DSpl i tPane (newOri entati on : i nt , 
newLeftComponent: Component, 
newRi ghtComponent: Component) 



JavaBeans properties with get and set 
methods omitted in the UML diagram. 



A Boolean value indicating whether or not the views are 
continuously redisplayed while resizing. 

Size of the divider. 

Previous location of the divider. 

The left or top component. 

A Boolean property with the default value false. If the property is 
true, the divider has an expanding and contracting look, so that it 
can expand and contract with one touch. 

Specifies whether the container is divided horizontally or vertically. 
The possible values are JSpl i tPane . HORIZONTAL_SPLIT and 
JSpl i tPane . VERTICAL_SPLIT. The default value is 
JSpl i tPane . HORIZONTAL_SPLIT, which divides the container 
into a left part and a right part. 

The right or bottom component. 

Creates a JSpl i tPane configured to arrange the child components 
side by side horizontally with no continuous layout. 

Creates a JSpl i tPane configured with the specified orientation and 
no continuous layout. 

Creates a JSpl i tPane with the specified orientation and continuous 
layout. 

Creates a JSpl i tPane with the specified orientation and continuous 
layout, and the left (top) and right (bottom) components. 



Creates a JSpl i tPane with the specified orientation, and the left (top) 
and right (bottom) components. No continuous layout. 



Figure 33.1 6 JSpl i tPane provides methods to specify the properties of a split pane and for manipulating the compo- 
nents in a split pane. 



Listing 33.8 gives an example that uses radio buttons to let the user select a 
FlowLayout, GridLayout, or BoxLayout manager dynamically for a panel. The panel 
contains four buttons, as shown in Figure 33.17. The description of the currently selected 
layout manager is displayed in a text area. The radio buttons, buttons, and text area are 
placed in two split panes. 



Listing 33.8 ShowLayout . j ava 

1 import java.awt.*; 

2 import java.awt. event.*; 

3 import j avax. swi ng . * ; 
4 

5 public class ShowLayout extends JApplet { 

6 // Get the url for HTML files 
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7 private String flowLayoutDesc = "FlowLayout arranges components " + descriptions 

8 "according to their preferredSize in " + 

9 "a left-to-right flow, much like lines of text in a paragraph."; 

10 private String gri dLayoutDesc = "GridLayout arranges 

11 private String boxLayoutDesc = "BoxLayout arranges 
12 

13 private JRadioButton j rbFlowLayout = radio buttons 

14 new JRadioButton ("FlowLayout") ; 

15 private JRadioButton j rbCri dLayout = 

16 new JRadioButton("GridLayout" , true); 

17 private JRadioButton jrbBoxLayout = 

18 new J RadioButton ("BoxLayout") ; 
19 

20 private JPanel jpComponents = new JPanelO; 

21 private JTextArea jtfDescri ption = new JTextAreaO ; 
22 

23 // Create layout managers 

24 private FlowLayout flowLayout = new Fl owLayout() ; layout managers 

25 private GridLayout gri dLayout = new Gri dLayout(2 , 2, 3, 3); 

26 private BoxLayout boxLayout = 

27 new BoxLayout(jpComponents , BoxLayout .X_AXIS) ; 
28 

29 public ShowLayoutO { 

30 // Create a box to hold radio buttons 

31 Box jpChooseLayout = Box . createVerti cal Box() ; 

32 j pChooseLayout . add ( j rbFl owLayout) ; 

33 jpChooseLayout. add (jrbGri dLayout) ; 

34 jpChooseLayout. add(j rbBoxLayout) ; 
35 

36 // Group radio buttons 

37 ButtonGroup btg = new ButtonGroupO ; 

38 btg. add (j rbFl owLayout) ; 

39 btg. add (jrbGri dLayout) ; 

40 btg. add (j rbBoxLayout) ; 
41 

42 // Wrap lines and words 

43 jtfDescri ption . setLi neWrap(true) ; 

44 jtfDescri ption . setWrapStyl eWord(true) ; 
45 

46 // Add four buttons to jpComponents 

47 jpComponents. add (new JButton("Button 1")); 

48 jpComponents .add (new JButton("Button 2")); 

49 jpComponents .add (new JButton("Button 3")); 

50 jpComponents .add (new JButton("Button 4")); 
51 

52 // Create two split panes to hold jpChooseLayout, jpComponents, 

53 // and jtfDescri ption 

54 JSplitPane jSplitPane2 = new JSplitPane( splitpane 

55 JSplitPane. VERTICAL_SPLIT, jpComponents, 

56 new JScroll Pane(jtfDescription)) ; 

57 JSplitPane jSplitPanel = new JSplitPane( splitpane 

58 JSplitPane.HORIZONTAL_SPLIT, jpChooseLayout, jSplitPane2) ; 
59 

60 // Set FlowLayout as default 

61 j pComponents . setLayout (f 1 owLayout) ; 

62 jpComponents . revalidate() ; 

63 jtfDescri ption . setText (flowLayoutDesc) ; 
64 

65 add(jSplitPanel , BorderLayout . CENTER) ; 
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register listener 



validate 



register listener 



validate 



main method omitted 



66 
67 
68 
69 
70 
71 
72 
73 
74 
75 
76 
77 
78 
79 
80 
81 
82 
83 
84 
85 
86 
87 
88 
89 

90 } 



// Register listeners 

jrbFlowLayout.addActionListener(new ActionLi stenerO { 
public void action Performed (Action Event e) { 
jpComponents . setLayout(f 1 owLayout) ; 
jtfDescri pti on . setText(f 1 owLayoutDesc) ; 
jpComponents . reval idateO ; 

} 

}); 

jrbCridLayout.addActionListener(new ActionLi stenerO { 
public void actionPerformed(ActionEvent e) { 
jpComponents . setLayout(gridLayout) ; 
jtfDescri pti on . setText(gridLayoutDesc) ; 
jpComponents. revalidate() ; 

} 

}); 

j rbBoxLayout . addActi onLi stener(new Acti onLi stenerO { 
public void actionPerformed(ActionEvent e) { 
jpComponents . setLayout(boxLayout) ; 
jtfDescri pti on . setText(boxLayoutDesc) ; 
jpComponents . reval idateO ; 

} 

}); 
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Figure 33.1 7 You can adjust the component size in the split panes. 



Split panes can be embedded. Adding a split pane to an existing split pane results in three split 
panes. The program creates two split panes (lines 54-58) to hold a panel for radio buttons, a 
panel for buttons, and a scroll pane. 

The radio buttons are used to select layout managers. A selected layout manager is used in 
the panel for laying out the buttons (lines 68-88). The scroll pane contains a JTextArea for 
displaying the text that describes the selected layout manager (line 56). 

33.8 Swing Borders 

Swing provides a variety of borders that you can use to decorate components. You learned 
how to create titled borders and line borders in §12.9, "Common Features of Swing GUI 
Components." This section introduces borders in more detail. 

A Swing border is defined in the Border interface. Every instance of ^Component can set 
a border through the border property defined in ^Component. If a border is present, it re- 
places the inset. The AbstractBorder class implements an empty border with no size. This 
provides a convenient base class from which other border classes can easily be defined. There 
are eight concrete border classes, Bevel Border, SoftBevel Border, CompoundBorder, 
EmptyBorder, EtchedBorder, LineBorder, MatteBorder, and TitledBorder, as 
shown in Figure 33.18. 



Border 



AbstractBorder 



— CompoundBorder 



— EmptyBorder 



■ Bevel Border 
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SoftBevel Border 



■ EtchedBorder 



■ Li neBorder 



■ MatteBorder 



■TitledBorder 



Figure 33.18 The Border interface defines Swing borders. 



Bevel Border is a 3D-look border that can be lowered or raised. Bevel Border has 
the following constructors, which create a Bevel Border with the specified 
bevel Type (Bevel Border . LOWERED or Bevel Border . RAISED) and colors: 

Bevel Border(int bevelType) 

Bevel Border(int bevelType, Color highlight, Color shadow) 
Bevel Border(int bevelType, Color highlightOuterColor, 

Color highlightlnnerColor, Color shadowOuterCol or , 

Color shadowInnerColor) 



SoftBevel Border is a raised or lowered bevel 
SoftBevel Border has the following constructors: 



with softened corners. 



SoftBevel Border(int bevelType) 

SoftBevel Border(int bevelType, Color highlight, Color shadow) 
SoftBevel Border(int bevelType, Color highlightOuterColor, 

Color highlightlnnerColor, 

Color shadowOuterColor, 

Color shadowInnerColor) 

EmptyBorder is a border with border space but no drawings. EmptyBorder has 

the following constructors: 

EmptyBorder(Insets borderlnsets) 

EmptyBorder(int top , int left, int bottom, int right) 

EtchedBorder is an etched border that can be etched-in or etched-out. 
EtchedBorder has the property etchType with the value LOWERED or RAISED. 
EtchedBorder has the following constructors: 

EtchedBorderO // Default constructor with a lowered border 
EtchedBorder(Color highlight, Color shadow) 
EtchedBorder(int etchType) 

EtchedBorder(int etchType, Color highlight, Color shadow) 
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■ LineBorder draws a line of arbitrary thickness and a single color around the bor- 
der. LineBorder has the following constructors: 

Li neBorder(Col or color) // Thickness 1 
Li neBorder(Col or color, int thickness) 

Li neBorder(Col or color, int thickness, boolean roundedCorners) 

■ MatteBorder is a mattelike border padded with the icon images. MatteBorder 

has the following constructors: 

MatteBorder(Icon tilelcon) 

MatteBorder(Insets borderlnsets , Color matteColor) 
MatteBorder(Insets borderlnsets, Icon tilelcon) 
MatteBorder(int top, int left, int bottom, int right, Color 
matteCol or) 

MatteBorder(int top, int left, int bottom, int right, Icon 
ti 1 elcon) 

■ CompoundBorder is used to compose two Border objects into a single border by 
nesting an inside Border object within the insets of an outside Border object using 
the following constructor: 

CompoundBorder(Border outsi deBorder , Border i nsi deBorder) 

■ Titl edBorder is a border with a string title in a specified position. 
Titl edBorder can be composed with other borders. Titl edBorder has the fol- 
lowing constructors: 

TitledBorder(String title) 

TitledBorder(Border border) // Empty title on another border 
TitledBorder(Border border, String title) 
TitledBorder(Border border, String title, 

int ti tl eJusti f i cati on , int titlePosition) 
TitledBorder(Border border, String title, 

int ti tl eDusti f i cati on , int titlePosition, 

Font titleFont) 
TitledBorder(Border border, String title, 

int ti tl eJusti f i cati on , 

int titlePosition, Font titleFont, Color 
ti tl eCol or) 

For convenience, Java also provides the javax . swing . Border Factory class, which con- 
tains the static methods for creating borders shown in Figure 33.19. 
For example, to create an etched border, use the following statement: 

Border border = BorderFactory.createEtchedBorderO ; 
||| Note 

All the border classes and interfaces are grouped in the package javax. swing. border except 
javax. swing. Border Factory. 

# Note 

Borders and icons can be shared. Thus you can create a border or icon and use it to set the 
border or icon property for any GUI component. For example, the following statements set a 
border b for two panels pi and p2: 

pi. setBorder(b) ; 
p2 . setBorder(b) ; 
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javax.swing.BorderFactory 


+createBevel Border(type : int): Border 

+createBevel Border(type : int, highlight: Color, shadow: Color): Border 






+createBevel Border(type : int, highlightOuter: Color, highlightlnner: Color, 


shadowOuter: 




Color, shadowlnner: Color): Border 
+createCompoundBorder() : CompoundBorder 

+createCompoundBorder(outsideBorder: Border, insideBorder: Border): CompoundBorder 




+createEmptyBorder() : Border 

+createEmptyBorder(top: int, left: int, bottom: int, right: int): Border 






+createEtchedBorder() : Border 

+createEtchedBorder(highlight: Color, shadow: Color): Border 






+createEtchedBorder(type : int): Border 

+createEtchedBorder(type : int, highlight: Color, shadow: Color): Border 






+createl_ineBorder(color: Color): Border 
+createl_ineBorder(color: Color, thickness: int): Border 






+createLoweredBevel Border() : Border 

+createMatteBorder(top: int, left: int, bottom: int, right: int, color: Color): MatteBorder 


+createMatteBorder(top: int, left: int, bottom: int, right: int, tilelcon: 


Icon): MatteBorder 


+createRai sedBevel Border() : Border 
+createTitledBorder(border: Border): TitledBorder 
+createTitledBorder(border: Border, title: String): TitledBorder 






+createTitledBorder(border: Border, title: String, titleJustification: int, 


titlePosition: 


i nt) : 


TitledBorder 

+createTitledBorder(border: Border, title: String, titleJustification: int, 


titlePosition: 


int, 


titleFont: Font): TitledBorder 
+createTitledBorder(border: Border, title: String, titleJustification: int, 


titlePosition: 


int, 


titleFont: Font, titleColor: Color): TitledBorder 
+createTi tl edBorder(ti tl e : String): TitledBorder 



Figure 33.1 9 BorderFactory contains the static methods for creating various types of borders. 



Listing 33.9 gives an example that creates and displays various types of borders. You can se- 
lect a border with or without a title. For a border without a title, you can choose a border style 
from Lowered Bevel, Raised Bevel, Etched, Line, Matte, or Empty. For a border with a title, 
you can specify the title position and justification. You can also embed another border into a 
titled border. Figure 33.20 displays a sample run of the program. 
Here are the major steps in the program: 

1. Create the user interface. 

a. Create a J Label object and place it in the center of the frame. 

b. Create a panel named jpPosi ton to group the radio buttons for selecting the border 
title position. Set the border of this panel in the titled border with the title "Position". 

c. Create a panel named jpJusti f ication to group the radio buttons for selecting 
the border title justification. Set the border of this panel in the titled border with the 
title "Justification". 

d. Create a panel named jpTitleOptions to hold the jpPosition panel and the 
jpjustification panel. 

e. Create a panel named jpTitle to hold a check box named "Titled" and the 
jpTitleOptions panel. 
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f. Create a panel named jpBorderStyl e to group the radio buttons for selecting bor- 
der styles. 

g. Create a panel named jpAll Choices to hold the panels jpTitle and 
jpBorderStyl e. Place jpAll Choices in the south of the frame. 

2. Process the event. 

Create and register listeners to implement the actionPerformed handler to set the bor- 
der for the label according to the events from the check box, and from all the radio buttons. 
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(a) 

Figure 33.20 The program demonstrates various types of borders. 



(b) 



Listing 33.9 BorderDemo. java 

1 import java.awt.*; 

2 import java.awt. event. Acti onLi stener ; 

3 import java.awt. event. Acti onEvent; 

4 import javax. swi ng . * ; 

5 import javax. swing. border.*; 
6 

7 public class BorderDemo extends JApplet { 

8 // Declare a label for displaying message 

9 private 1 Label j Label 1 = new 1 Label ("Display the border type", 
10 3 Label .CENTER); 

11 

12 // A check box for selecting a border with or without a title 

13 private JCheckBox jchkTitled; 
14 

15 // Radio buttons for border styles 

16 private IRadioButton j rbLoweredBevel , j rbRai sedBevel , 

17 jrbEtched, jrbLine, jrbMatte, jrbEmpty; 
18 

19 // Radio buttons for titled border options 

20 private IRadioButton j rbAboveBottom , jrbBottom, 

21 j rbBel owBottom , jrbAboveTop, jrbTop, jrbBelowTop, 

22 jrbLeft, jrbCenter, jrbRight; 
23 

24 // TitledBorder for the label 

25 private TitledBorder jLabellBorder; 
26 

27 /** Constructor */ 

28 public BorderDemoO { 

create UI 29 // Create a J Label instance and set colors 

30 jLabell.setBackground(Color. yellow) ; 
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31 jLabell.setBorder(jLabellBorder) ; 
32 

33 // Place title position radio buttons 

34 1 Panel jpPosition = new JPanelO; 

35 jpPosition. setLayout(new Gri dLayout(3 , 2)); 

36 jpPosition. add( 

37 j rbAboveBottom = new 1 Radi oButton ("ABOVE_BOTTOM") ) ; 

38 jpPosition.add(jrbAboveTop = new J Radi oButton ("ABOVE TOP")) ; 

39 jpPosi tion. add (jrbBottom = new JRadioButton("B0TT0M")) ; 

40 jpPosi tion. add (jrbTop = new JRadioButton("T0P")) ; 

41 jpPosition. add( 

42 jrbBelowBottom = new 1 Radi oButton ("BEL0W_B0TTOM") ) ; 

43 jpPosition. add(j rbBel owTop = new J Radi oButton ("BEL0W_T0P") ) ; 

44 jpPosition. setBorder(new Ti tl edBorder("Position")) ; 
45 

46 // Place title justification radio buttons 

47 JPanel jpJustification = new JPanelO; 

48 jpJusti fi cati on . setLayout(new Gri dLayout (3 , 1)) ; 

49 jpJustification. add(jrbLeft = new JRadioButton("LEFT")) ; 

50 jpJustification. add(jrbCenter = new JRadioButton("CENTER")) ; 

51 jpJustification. add(jrbRight = new J Radi oButton ("RIGHT")) ; 

52 j pJusti fi cati on . setBorder(new Ti tl edBorder(" Justi fi cati on")) ; 
53 

54 // Create panel jpTitleOptions to hold jpPosition and 

55 // jpJustification 

56 1 Panel jpTitleOptions = new JPanelO; 

57 j pTi tl eOptions . setLayout (new BorderLayoutO) ; 

58 j pTitl eOptions . add(jpPosi tion , BorderLayout . CENTER) ; 

59 j pTitl eOptions . add(jpJusti fi cati on , BorderLayout . EAST) ; 
60 

61 // Create Panel jpTitle to hold a check box and title position 

62 // radio buttons, and title justification radio buttons 

63 J Panel jpTitle = new JPanelO; 

64 jpTitle. setBorder(new Ti tl edBorder("Border Title")); 

65 jpTitle. setLayout(new BorderLayoutO); 

66 jpTitle. add(jchkTitled = new JCheckBox("Titled") , 

67 BorderLayout . NORTH) ; 

68 jpTitle. add(jpTitleOptions, BorderLayout . CENTER) ; 
69 

70 // Group radio buttons for title position 

71 ButtonGroup btgTitlePosition = new ButtonGroupO ; 

72 btgTitlePosition. add (j rbAboveBottom) ; 

73 btgTitlePosi tion. add ( j rbBottom) ; 

74 btgTitlePosition. add(j rbBelowBottom) ; 

75 btgTitlePosition. add(j rbAboveTop) ; 

76 btgTitlePosition. add(jrbTop) ; 

77 btgTitlePosition. add (j rbBel owTop) ; 
78 

79 // Group radio buttons for title justification 

80 ButtonGroup btgTitleJustification = new ButtonGroupO; 

81 btgTitleJustification.add(jrbLeft) ; 

82 btgTitleJustification. add(j rbCenter) ; 

83 btgTitleJustification.add(jrbRight) ; 
84 

85 // Create Panel jpBorderStyle to hold border style radio buttons 

86 JPanel jpBorderStyle = new JPanelO; 

87 j pBorderStyl e . setBorder(new TitledBorder("Border Style")); 

88 jpBorderStyl e . setLayout(new Gri dLayout(6 , 1)); 

89 jpBorderStyle. add(j rbLoweredBevel = 

90 new JRadioButton("Lowered Bevel")); 
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j pBorderStyl e . add(j rbRai sedBevel = 

new JRadioButton ("Raised Bevel")); 
jpBorderStyle.add(jrbEtched = new JRadioButton("Etched")) ; 
jpBorderStyle.add(jrbLine = new JRadioButton("Line")) ; 
jpBorderStyle.add(jrbMatte = new DRadioButton("Matte")) ; 
jpBorderStyle.add(jrbEmpty = new DRadioButton("Empty")) ; 

// Croup radio buttons for border styles 
ButtonCroup btgBorderStyl e = new ButtonGroupO ; 
btgBorderStyl e . add(j rbLoweredBevel ) ; 
btgBorderStyl e . add ( j rbRai sedBevel ) ; 
btgBorderStyle.add(jrbEtched) ; 
btgBorderStyle.add(jrbLine) ; 
btgBorderStyle.add(jrbMatte) ; 
btgBorderStyle.add(jrbEmpty) ; 

// Create Panel jpAHChoices to place jpTitle and jpBorderStyle 

J Panel jpAll Choices = new JPanelO; 

jpAHChoices.setLayout(new BorderLayoutO) ; 

j pAl 1 Choices. add (jpTi tie, BorderLayout . CENTER) ; 

j pAl 1 Choi ces . add(jpBorderStyl e , BorderLayout . EAST) ; 

// Place panels in the frame 
setLayout(new BorderLayoutO); 
add (j Label 1, BorderLayout . CENTER) ; 
add (jpAll Choi ces, BorderLayout . SOUTH) ; 

// Register listeners 

ActionLi stener listener = new EventLi stener() ; 

jchkTi tl ed . addActi on Li stener (1 i stener) ; 

j rbAboveBottom . addActi onLi stener(l i stener) ; 

j rbBottom. addActi on Li stener (1 i stener) ; 

j rbBel owBottom . addActi onLi stener(l i stener) ; 

j rbAboveTop . addActi onLi stener(l i stener) ; 

j rbTop . addActi onLi stener (1 i stener) ; 

j rbBel owTop . addActi onLi stener(l i stener) ; 

j rbLeft . addActi onLi stener(l i stener) ; 

j rbCenter. addActi on Li stener (1 i stener) ; 

j rbRi ght . addActi onLi stener(l i stener) ; 

j rbLoweredBevel .addActionListener(listener) ; 

j rbRai sedBevel . addActi onLi stener(l i stener) ; 

j rbLi ne . addActi onLi stener (1 i stener) ; 

j rbEtched . addActionLi stenerfj i stener) ; 

j rbMatte . addActi onLi stener(l i stener) ; 

j rbEmpty . addActi onLi stener(l i stener) ; 

} 

private class EventLi stener implements Acti onLi stener { 

/** Handle ActionEvents on check box and radio buttons */ 
public void actionPerformed(ActionEvent e) { 

// Get border style 

Border border = new EmptyBorder(2 , 2, 2, 2); 

if (j rbLoweredBevel .isSelectedO) { 

border = new Bevel Border(Bevel Border . LOWERED) ; 
j Label 1. setText(" Lowered Bevel Style"); 

} 

else if (j rbRai sedBevel .isSelectedO) { 

border = new Bevel Border(Bevel Border . RAISED) ; 
j Label l.setText ("Raised Bevel Style"); 
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151 } 

152 else if (jrbEtched.isSelectedO) { 

153 border = new EtchedBorderO ; etchedborder 

154 jLabell.setText("Etched Style"); 

155 } 

156 else if (j rbLi ne . i sSel ectedO) { 

157 border = new LineBorder(Color. black, 5); lineborder 

158 j Label l.setText("Line Style"); 

159 } 

160 else if (jrbMatte.isSel ectedO) { 

161 border = new MatteBorder(15 , 15, 15, 15, matte border 

162 new ImageIcon(getClass() .getResource 

163 ("image/calcon.gif"))); 

164 j Label l.setText ("Matte Style"); 

165 } 

166 else if (j rbEmpty . i sSel ectedO) { 

167 border = new EmptyBorder(2 , 2, 2, 2); empty border 

168 j Label l.setText("Empty Style"); 

169 } 
170 

171 if (jchkTitled.isSelectedO) { 

172 // Get the title position and justification 

173 int titlePosition = Ti tl edBorder . DEFAULT_P0SITI0N ; 

174 int titlelustification = Ti tl edBorder . DEFAULT_JUSTIFICATION ; 
175 

176 if (j rbAboveBottom. i sSel ectedO) 

177 titlePosition = Ti tl edBorder . AB0VE_B0TT0M ; 

178 else if (j rbBottom . i sSel ectedO) 

179 titlePosition = Ti tl edBorder . BOTTOM ; 

180 else if (j rbBel owBottom . i sSel ectedO) 

181 titlePosition = Ti tl edBorder . BEL0W_B0TT0M ; 

182 else if (j rbAboveTop . i sSel ectedO) 

183 titlePosition = TitledBorder.AB0VE_T0P; 

184 else if (jrbTop.isSel ectedO) 

185 titlePosition = TitledBorder.TOP; 

186 else if (j rbBel owTop.isSel ectedO) 

187 titlePosition = TitledBorder.BEL0W_T0P; 
188 

189 if (jrbLeft.isSelectedO) 

190 ti trustification = TitledBorder.LEFT; 

191 else if (jrbCenter.isSelectedO) 

192 titleJustification = TitledBorder. CENTER; 

193 else if (jrbRight.isSelectedO) 

194 titleJustification = TitledBorder. RIGHT; 
195 

196 jLabellBorder = new TitledBorder("A Title"); 

197 jLabellBorder. setBorder(border) ; border on border 

198 j Label lBorder . setTi tl ePosi ti on (ti tl ePosi ti on) ; 

199 j Label lBorder . setTi tl el usti f i cati on (ti tl el usti f i cati on) ; 

200 jLabell.setBorder(jLabellBorder) ; 

201 } 

202 else { 

203 jLabell.setBorder(border) ; 

204 } 

205 } 

206 } 

207 } main method omitted 



This example uses many panels to group UI components to achieve the desired look. Figure 33.20 
illustrates the relationship of the panels. The Border Title panel groups all the options for setting 
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title properties. The position options are grouped in the Position panel. The justification options are 
grouped in the Justification panel. The Border Style panel groups the radio buttons for choosing 
Lowered Bevel, Raised Bevel, Etched, Line, Matte, and Empty borders. 

The label displays the selected border with or without a title, depending on the selection of 
the title check box. The label also displays a text indicating which type of border is being 
used, depending on the selection of the radio button in the Border Style panel. 

The Ti tl edBorder can be mixed with other borders. To do so, simply create an instance 
of Titl edBorder, and use the setBorder method to embed a new border in 
Titl edBorder. 

The MatteBorder can be used to display icons on the border, as shown in Figure 33.20(b). 

Chapter Summary 

1. javax. swing. JRootPane is a lightweight container used behind the scenes by 
Swing's top-level containers, such as J Frame, JApplet, and JDialog. 
javax. swing. J LayeredPane is a container that manages the optional menu bar 
and the content pane. The content pane is an instance of Container. By default, it is 
a JPanel with BorderLayout. This is the container where the user interface compo- 
nents are added. To obtain the content pane in a JFrame or in a JApplet, use the 
getContentPaneO method. You can set any instance of Container to be a new 
content pane using the setContentPane method. 

2 . Every container has a layout manager that is responsible for arranging its components. 
The container's setLayout method can be used to set a layout manager. Certain 
types of containers have default layout managers. 

3 . The layout manager places the components in accordance with its own rules and prop- 
erty settings, and with the constraints associated with each component. Every layout 
manager has its own specific set of rules. Some layout managers have properties that 
can affect the sizing and location of the components in the container. 

4. Java also supports absolute layout, which enables you to place components at fixed lo- 
cations. In this case, the component must be placed using the component's instance 
method set Bounds () (defined in java.awt. Component). Absolute positions and 
sizes are fine if the application is developed and deployed on the same platform, but 
what looks fine on a development system may not look right on a deployment system 
on a different platform. To solve this problem, Java provides a set of layout managers 
that place components in containers in a way that is independent of fonts, screen reso- 
lutions, and operating systems. 

5. In addition to the layout managers provided in Java, you can create custom layout 
managers by implementing the LayoutManager interface. 

6. Java provides specialized containers Box, JScrollPane, JTabbedPane, and 
JSpl i tPane with fixed layout managers. 

7. A Swing border is defined in the Border interface. Every instance of ^Component 
can set a border through the border property defined in ^Component. If a border is 
present, it replaces the inset. There are eight concrete border classes: Bevel Border, 
SoftBevel Border, CompoundBorder, EmptyBorder, EtchedBorder, 
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LineBorder, MatteBorder, and TitledBorder. You can use the constructors of 
these classes or the static methods in javax . swi ng . BorderFactory to create borders. 

Review Questions 

Section 33.2 

33.1 Since JButton is a subclass of Contai ner, can you add a button inside a button? 

33.2 How do you set an image icon in a JFrame's title bar? Can you set an image icon 
in a JAppl et's title bar? 

33.3 Which of the following are the properties in JFrame, JAppl et, and JPanel ? 
contentPane, iconlmage, jMenuBar, resizable, title 

Section 33.3 

33.4 How does the layout in Java differ from those in Visual Basic? 

33.5 Discuss the factors that determine the size of the components in a container. 

33.6 Discuss the properties preferredSize, minimumSize, and maximumSize. 

33.7 Discuss the properties al ignmentX and al ignmentY. 

33.8 What is a CardLayout manager? How do you create a CardLayout manager? 

33.9 Can you use absolute positioning in Java? How do you use absolute positioning? 
Why should you avoid using it? 

33.10 What is BoxLayout? How do you use BoxLayout? How do you use fillers to 
separate the components? 

Sections 33.4-33.7 

33.11 How do you create a custom layout manager? 

33.12 What is JScroll Pane? How do you use JScroll Pane? 

33.1 3 What is JTabbedPane? How do you use JTabbedPane? 

33.14 What is JSpl itPane? How do you use JSpl itPane? 

33.15 Can you specify a layout manager in Box, JScroll Pane, JTabbedPane, and 
JSpl itPane? 

Section 33.8 

33.16 How do you create a titled border, a line border, a bevel border, and an etched border? 

33.1 7 Can you set a border for every Swing GUI component? Can a border object be 
shared by different GUI components? 

33.18 What package contains Border, Bevel Border, CompoundBorder, 
EmptyBorder, EtchedBorder, LineBorder, MatteBorder, TitledBorder, 
and BorderFactory? 

Programming Exercises 

Section 33.3 

33.1 * (Demonstrating FlowLayout properties) Create a program that enables the user to 
set the properties of a Fl owLayout manager dynamically, as shown in Figure 33.21. 
The Fl owLayout manager is used to place 15 components in a panel. You can set the 
al ignment, hgap, and vgap properties of the FlowLayout dynamically. 
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Figure 33.2 1 The program enables you to set the properties of a Fl owLayout manager 
dynamically. 

33.2* (Demonstrating CridLayout properties) Create a program that enables the user 
to set the properties of a CridLayout manager dynamically, as shown in Figure 
33.22(a). The GridLayout manager is used to place 15 components in a panel. 
You can set the rows, columns, hgap, and vgap properties of the GridLayout 
dynamically. 
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Figure 33.22 (a) The program enables you to set the properties of a GridLayout manager 
dynamically, (b) The program enables you to set the properties of a BorderLayout manag- 
er dynamically. 



33.3* (Demonstrating BorderLayout properties) Create a program that enables the 
user to set the properties of a BorderLayout manager dynamically, as shown 
in Figure 33.22(b). The BorderLayout manager is used to place five compo- 
nents in a panel. You can set the hgap and vgap properties of the 
BorderLayout dynamically. 

33.4* (Using CardLayout) Write an applet that does arithmetic on integers and ratio- 
nals. The program uses two panels in a CardLayout manager, one for integer 
arithmetic and the other for rational arithmetic. The program provides a combo 
box with two items Integer and Rational. When the user chooses the Integer item, 
the integer panel is activated. When the user chooses the Rational item, the ratio- 
nal panel is activated (see Figure 33.23). 
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Figure 33.23 CardLayout is used to select panels that perform integer operations and ra- 
tional number operations. 



33.5* (Using null layout) Use a null layout to lay out a calculator, as shown in Figure 
18.18(a). 

Sections 33.4-33.8 

33.6* (Using tabbed panes) Modify Listing 33.7, DisplayFigure.java, to add a panel of 
radio buttons for specifying the tab placement of the tabbed pane, as shown in 
Figure 33.24. 
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Figure 33.24 The radio buttons let you choose the tab placement of the tabbed pane. 



33.7* (Using tabbed pane) Rewrite Exercise 33.4 using tabbed panes instead of 
CardLayout (see Figure 33.25). 
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Figure 33.25 A tabbed pane is used to select panels that perform integer operations and ra- 
tional number operations. 



33.8* (Using JSplitPane) Create a program that displays four figures in split panes, 
as shown in Figure 33.26. Use the FigurePanel class defined in Listing 15.3, 
FigurePanel.java. 
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Figure 33.26 Four figures are displayed in split panes. 

33.9* (Demonstrating JSpl it Pane properties) Create a program that enables the user 
to set the properties of a split pane dynamically, as shown in Figure 33.27. 
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Figure 33.27 The program enables you to set the properties of a split pane dynamically. 

33. 1 0* (Demonstrating Diagonal Layout properties) Rewrite Listing 33.5 ShowDiag- 
onal Layout . j ava to add a panel that shows the properties of a Di agonal Lay- 
out. The panel disappears when the Diagonal Layout radio button is 
unchecked, and reappears when the Diagonal Layout radio button is checked, 
as shown in Figure 33.28. 
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Figure 33.28 The program enables you to set the properties of the Diagonal Layout 

dynamically. 
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Objectives 

■ To create menus using components JMenuBar, JMenu, JMenuItem, 
XheckBoxMenuItem, and JRadioButtonMenuItem (§34.2). 

■ To create popup menus using components JPopupMenu, 

JMenuItem, JCheckBoxMenuItem, and JRadioButtonMenuItem (§34.3). 

■ To use JTool Bar to create toolbars (§34.4). 

■ To use Action objects to generalize the code 
for processing actions (§34.5). 

■ To create standard dialogs using the JOptionPane 

class (§34.6). 

■ To extend the JDi al og class to create custom 
dialogs (§34.7). 

■ To select colors using JCol orChooser (§34.8). 

■ To use JFi 1 eChooser to display Open and Save File 
dialogs (§34.9). 
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34-1 Introduction 

Java provides a comprehensive solution for building graphical user interfaces. This chapter 
introduces menus, popup menus, toolbars, and dialogs. You will also learn how to use 
Action objects to generalize the code for processing actions. 

34-2 Menus 

menu Menus make selection easier and are widely used in window applications. Java provides five 

classes that implement menus: JMenuBar, JMenu, JMenuItem, JCheckBoxMenuItem, and 
JRadioButtonMenuItem. 

JMenuBar is a top-level menu component used to hold the menus. A menu consists of 

menu item menu items that the user can select (or toggle on or off). A menu item can be an instance of 

JMenuItem, JCheckBoxMenuItem, or JRadioButtonMenuItem. Menu items can be asso- 
ciated with icons, keyboard mnemonics, and keyboard accelerators. Menu items can be sepa- 
rated using separators. 

34-2.1 Creating Menus 

The sequence of implementing menus in Java is as follows: 

1. Create a menu bar and associate it with a frame or an applet by using the set JMenuBar 
method. For example, the following code creates a frame and a menu bar, and sets the 
menu bar in the frame: 

JFrame frame = new JFrameO; 
frame.setSize(300, 200); 
frame . setVi si bl e(true) ; 
JMenuBar jmb = new JMenuBarO; 

frame . set JMenuBar(jmb) ; // Attach a menu bar to a frame 

2. Create menus and associate them with the menu bar. You can use the following con- 
structor to create a menu: 

public JMenu(String label) 

Here is an example of creating menus: 

JMenu fileMenu = new JMenu("File") ; 
JMenu helpMenu = new JMenu("Help") ; 

This creates two menus labeled File and Help, as shown in Figure 34.1(a). The 
menus will not be seen until they are added to an instance of JMenuBar, as follows: 

jmb.add(fileMenu) ; 
jmb.add(helpMenu) ; 
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Figure 34.1 (a) The menu bar appears below the title bar on the frame, (b) Clicking a menu 
on the menu bar reveals the items under the menu, (c) Clicking a menu item reveals the sub- 
menu items under the menu item. 
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3. Create menu items and add them to the menus. 

fileMenu.add(new JMenuItem("New")) ; 
fileMenu.add(new JMenuItem("Open")) ; 
f i 1 eMenu . addSeparatorO ; 
fileMenu.add(new JMenuItem("Print")) ; 
f i 1 eMenu . addSeparatorO ; 
fileMenu.add(new JMenuItem("Exit")) ; 

This code adds the menu items New, Open, a separator bar, Print, another separator bar, and 
Exit, in this order, to the File menu, as shown in Figure 34.1(b). The addSeparatorO 
method adds a separator bar in the menu. 

3.1 Creating submenu items. You can also embed menus inside menus so that the em- 
bedded menus become submenus. Here is an example: 

JMenu softwareHel pSubMenu = new JMenu ("Software") ; 

JMenu hardwareHel pSubMenu = new JMenu("Hardware") ; 

hel pMenu . add(softwareHel pSubMenu) ; 

hel pMenu . add(hardwareHel pSubMenu) ; 

softwareHel pSubMenu . add (new DMenuItem("Unix")) ; 

softwareHel pSubMenu. add (new DMenuItem("NT")) ; 

softwareHel pSubMenu .add (new DMenuItem("win95")) ; 

This code adds two submenus, softwareHel pSubMenu and hardwareHel p- 
SubMenu, in helpMenu. The menu items Unix, NT, and Win95 are added to 
softwareHel pSubMenu (see Figure 34.1(c)). 

3.2 Creating check-box menu items. You can also add a JCheckBoxMenuItem to a 
JMenu. JCheckBoxMenuItem is a subclass of JMenuItem that adds a Boolean 
state to the DMenuItem, and displays a check when its state is true. You can click a 
menu item to turn it on or off. For example, the following statement adds the check- 
box menu item Check it (see Figure 34.2(a)). 

hel pMenu . add(new JCheckBoxMenuItem("Check it")); 

3.3 Creating radio-button menu items. You can also add radio buttons to a menu, 
using the JRadioButtonMenuItem class. This is often useful when you have a 
group of mutually exclusive choices in the menu. For example, the following 
statements add a submenu named Color and a set of radio buttons for choosing a 
color (see Figure 34.2(b)): 

JMenu colorHel pSubMenu = new JMenu("Color") ; 
hel pMenu . add(colorHel pSubMenu) ; 

DRadi oButtonMenuItem jrbmiBlue, j rbmi Yellow, jrbmiRed; 
colorHel pSubMenu . add(j rbmi Bl ue = 

new DRadioButtonMenuItem("Blue")) ; 
colorHel pSubMenu . add(j rbmi Yel 1 ow = 

new JRadioButtonMenuItem("Yellow")) ; 
colorHel pSubMenu . add(j rbmi Red = 

new JRadioButtonMenuItem("Red")) ; 

ButtonGroup btg = new ButtonGroupO ; 
btg . add ( j rbmi Blue); 
btg . add ( j rbmi Yel 1 ow) ; 
btg . add ( j rbmi Red) ; 

4. The menu items generate ActionEvent. Your listener class must implement the 
ActionLi stener and the actionPer formed handler to respond to the menu selection. 
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Figure 34.2 (a) A check box menu item lets you check or uncheck a menu item just like a 
check box. (b) You can use JRadioButtonMenuItem to choose among mutually exclusive 
menu choices, (c) You can set image icons, keyboard mnemonics, and keyboard accelerators 
in menus. 



34-2.2 Image Icons, Keyboard Mnemonics, 
and Keyboard Accelerators 

The menu components JMenu, JMenuItem, JCheckBoxMenuItem, and JRadioButton- 

Menultem have the icon and mnemonic properties. For example, using the following code, 
you can set icons for the New and Open menu items, and set keyboard mnemonics for File, 
Help, New, and Open: 

JMenuItem jmiNew, jmiOpen; 

f i 1 eMenu . add(jmi New = new JMenuItem("New")) ; 
fileMenu.add(jmiOpen = new JMenuItem("Open")) ; 
jmi New. setIcon(new Imagelcon ("i mage/new. gif ")) ; 
j mi Open . setlcon (new Imagelcon ("image/open . gi f ") ) ; 
he! pMenu . setMnemoni c( 'H ' ) ; 
f i 1 eMenu . setMnemoni c( ' F' ) ; 
jmi New. setMnemoni c('N') ; 
jmi Open. setMnemoni c('O') ; 

The new icons and mnemonics are shown in Figure 34.2(c). You can also use JMenuItem con- 
structors like the ones that follow to construct and set an icon or mnemonic in one statement. 

public JMenuItem(Stri ng label, Icon icon); 
public JMenuItem(Stri ng label, int mnemonic); 

By default, the text is at the right of the icon. Use setHorizontalTextPosition- 
(SwingConstants . LEFT) to set the text to the left of the icon. 

To select a menu, press the ALT key and the mnemonic key. For example, press ALT+F to 
select the File menu, and then press ALT+O to select the Open menu item. Keyboard 
mnemonics are useful, but they only let you select menu items from the currently open menu, 
accelerator Key accelerators, however, let you select a menu item directly by pressing the CTRL and ac- 

celerator keys. For example, by using the following code, you can attach the accelerator key 
CTRL+O to the Open menu item: 

jmi Open . setAccel erator (Keystroke . getKey Stroke 
(KeyEvent.VK_0, Acti onEvent . CTRL_MASK) ) ; 

The setAccel erator method takes a Keystroke object. The static method getKeyStroke 

in the Keystroke class creates an instance of the keystroke. VK_0 is a constant representing 
the key, and CTRL_MASK is a constant indicating that the CTRL key is associated with the 
keystroke. 
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Note 

As shown in Figure 1 7.1, AbstractButton is the superclass for JButton and JMenuItem, and 
JMenuItem is a superclass for JCheckBoxMenuItem, "JMenu, and JRadioButtonMenuItem 

The menu components are very similar to buttons. 

34-2.3 Example: Using Menus 

This section gives an example that creates a user interface to perform arithmetic. The interface 
contains labels and text fields for Number 1, Number 2, and Result. The Result text field dis- 
plays the result of the arithmetic operation between Number 1 and Number 2. Figure 34.3 
contains a sample run of the program. 
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Multiply Ctrl-M 
Divide ctri-D 
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Add Subtract Multiply Divide 







Figure 34.3 Arithmetic operations can be performed by clicking buttons or by choosing 
menu items from the Operation menu. 

Here are the major steps in the program (Listing 34.1): 

1. Create a menu bar and set it in the applet. Create the menus Operation and Exit, and add 
them to the menu bar. Add the menu items Add, Subtract, Multiply, and Divide under 
the Operation menu, and add the menu item Close under the Exit menu. 

2. Create a panel to hold labels and text fields, and place the panel in the center of the applet. 

3. Create a panel to hold the four buttons labeled Add, Subtract, Multiply, and Divide. 
Place the panel in the south of the applet. 

4. Implement the actionPerformed handler to process the events from the menu items 
and the buttons. 

Listing 34. 1 MenuDemo . j ava 

1 import java.awt.*; 

2 import java.awt. event.*; 

3 import javax. swing.*; 
4 

5 public class MenuDemo extends DApplet { 

6 // Text fields for Number 1, Number 2, and Result 

7 private JTextField jtfNuml, jtfNum2, jtfResult; 
8 

9 // Buttons "Add", "Subtract", "Multiply" and "Divide" 
10 private "JButton jbtAdd, jbtSub, jbtMul , jbtDiv; 
11 

12 // Menu items "Add", "Subtract", "Mul ti ply" , "Di vi de" and "Close" 

13 private JMenuItem jmiAdd, jmiSub, jmiMul, jmiDiv, jmiClose; 
14 

15 public MenuDemoO { 

16 // Create menu bar 

17 IMenuBar jmb = new IMenuBarO ; menubar 
18 
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// Set menu bar to the applet 
setJMenuBar(jmb) ; 

// Add menu "Operation" to menu bar 

JMenu operati onMenu = new JMenu ("Operation") ; 

ope rati onMenu . setMnemoni c( '0 ' ) ; 

jmb . add(operati onMenu) ; 

// Add menu "Exit" to menu bar 
JMenu exitMenu = new JMenu("Exit") ; 
exitMenu.setMnemonic('E') ; 
jmb . add(exi tMenu) ; 

// Add menu items with mnemonics to menu "Operation" 
operationMenu.add(jmiAdd= new JMenuItem("Add" , 'A')); 
operationMenu.add(jmiSub = new JMenuItem("Subtract" , 'S')); 
operationMenu.add(jmiMul = new JMenuItem("Multiply", 'M')); 
operationMenu.add(jmiDiv = new JMenuItem("Divide" > 'D')); 
exitMenu . add (jmi Close = new JMenuItem("Close" , 'C')); 



// Set keyboard accelerators 
jmi Add . setAccel erator ( 

Keystroke . getKeySt roke (Key Event . VK_A, 
jmi Sub . setAccel erator ( 

Keystroke . getKeySt roke (Key Event . VK_S , 
jmiMul .setAccelerator( 

Keystroke . getKeySt roke (Key Event . VK_M , 
j mi Div. setAccel erator ( 

Keystroke .getKeySt roke (Key Event .VK_D, 



Acti onEvent . CTRL_MASK)) 
Acti onEvent . CTRL_MASK)) 
Acti onEvent . CTRL_MASK)) 
Acti onEvent . CTRL_MASK)) 



// Panel pi to hold text fields and labels 
JPanel pi = new JPanel (new FlowLayoutO) ; 
pl.add(new JLabel ("Number 1")); 
pl.add(jtfNuml = new JTextField(3)) ; 
pl.add(new JLabel ("Number 2")); 
pl.add(jtfNum2 = new JTextField(3)) ; 
pl.add(new JLabel ("Result")) ; 
pl.add(jtfResult = new JTextFi el d(4)) ; 
jtfResult.setEditable(false) ; 

// Panel p2 to hold buttons 

JPanel p2 = new JPanel(new FlowLayoutO); 

p2.add(jbtAdd = new JButton("Add")) ; 

p2 .add(jbtSub = new JButton("Subtract")) ; 

p2 .add(jbtMul = new JButton("Multiply")) ; 

p2 .add(jbtDiv = new JButton("Divide")) ; 

// Add panels to the frame 
setLayout(new BorderLayoutO) ; 
add(pl, BorderLayout. CENTER) ; 
add(p2, BorderLayout. SOUTH) ; 

// Register listeners 

jbtAdd . addActionLi stener(new ActionLi stener() { 
public void acti onPerformed(Acti onEvent e) { 
calculate('+') ; 

} 

}); 

jbtSub.addActionListener(new ActionLi stener() { 
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78 public void acti onPerformed(Acti onEvent e) { 

79 calculateC-') ; 

80 } 

81 }); 

82 jbtMul . addActionLi stener(new ActionLi stenerO { register listener 

83 public void acti onPerformed(Acti onEvent e) { 

84 calculateC-'); 

85 } 

86 }); 

87 jbtDiv. addActionLi stener(new ActionLi stenerO { register listener 

88 public void acti on Performed (Acti onEvent e) { 

89 calculateC/') ; 

90 } 

91 }); 

92 jmiAdd . addActionLi stener(new ActionLi stenerO { register listener 

93 public void acti onPerformed (Acti onEvent e) { 

94 calculate('+') ; 

95 } 

96 }); 

97 jmiSub.addActionListener(new ActionLi stenerO { register listener 

98 public void acti onPerformed (Acti onEvent e) { 

99 calculateC-'); 

100 } 

101 }); 

102 jmiMul . addActionLi stener(new ActionLi stenerO { register listener 

103 public void acti onPerformed (Acti onEvent e) { 

104 calculateC-'); 

105 } 

106 }) ; 

107 jmiDiv.addActionListener(new ActionLi stenerO { register listener 

108 public void acti onPerformed (Acti onEvent e) { 

109 calculate(V') ; 

110 } 

in }); 

112 jmi CI ose . addActi onLi stener(new Acti onLi stenerO { register listener 

113 public void acti onPerformed (Acti onEvent e) { 

114 System. exi t(0) ; 

115 } 

116 }); 

117 } 
118 

119 /** Calculate and show the result in jtf Result */ 

120 private void cal cul ate (char operator) { calculator 

121 // Obtain Number 1 and Number 2 

122 int numl = (Integer. parseInt(jtfNuml. getText() .trim())) ; 

123 int num2 = (Integer. parseInt(jtfNum2 . getText() .trim())) ; 

124 int result = 0; 
12 5 

126 // Perform selected operation 

127 switch (operator) { 

128 case '+': result = numl + num2; 

129 break; 

130 case '-': result = numl - num2; 

131 break; 

132 case '-': result = numl * num2; 

133 break; 

134 case '/' : result = numl / num2; 

135 } 
136 
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137 // Set result in jtfResult 

138 jtfResult. setTextCStn'ng.valueOf (result)) ; 

139 } 

main method omitted 140 } 

The program creates a menu bar, jmb, which holds two menus: operationMenu and 
exitMenu (lines 17-30). The operationMenu contains four menu items for doing arith- 
metic: Add, Subtract, Multiply, and Divide. The exitMenu contains the menu item Close for 
exiting the program. The menu items in the Operation menu are created with keyboard 
mnemonics and accelerators. 

The user enters two numbers in the number fields. When an operation is chosen from the 
menu, its result, involving two numbers, is displayed in the Result field. The user can also 
click the buttons to perform the same operation. 

The private method cal cul ate(char operator) (lines 120-139) retrieves operands 
from the text fields in Number 1 and Number 2, applies the binary operator on the operands, 
and sets the result in the Result text field. 

|j| Note 

The menu bar is usually attached to the window using the set JMenuBar method. However, like 
placing menus any other component, it can be placed in a container. For instance, you can place a menu bar in 

the south of the container with BorderLayout. 

34-3 Popup Menus 

popup menu A popup menu, also known as a context menu, is like a regular menu, but does not have a 

menu bar and can float anywhere on the screen. Creating a popup menu is similar to creat- 
ing a regular menu. First, you create an instance of JPopupMenu, then you can add 
JMenuItem, JCheckBoxMenuItem, JRadioButtonMenuItem, and separators to the 
popup menu. For example, the following code creates a JPopupMenu and adds 
JMenuItems into it: 

JPopupMenu jPopupMenu = new JPopupMenuO; 
jPopupMenu.add(new JMenuItem("New")) ; 
jPopupMenu. add (new JMenuItem("Open")) I 

A regular menu is always attached to a menu bar using the setJMenuBar method, but a 
popup menu is associated with a parent component and is displayed using the show method in 
the JPopupMenu class. You specify the parent component and the location of the popup 
menu, using the coordinate system of the parent like this: 

j PopupMenu . show(component , x, y) ; 

Customarily, you display a popup menu by pointing to a GUI component and clicking a cer- 
popup trigger tain mouse button, the so-called popup trigger. Popup triggers are system dependent. In Win- 

dows, the popup menu is displayed when the right mouse button is released. In Motif, the 
popup menu is displayed when the third mouse button is pressed and held down. 

Listing 34.2 gives an example that creates a text area in a scroll pane. When the mouse points 
to the text area, clicking a mouse button displays a popup menu, as shown in Figure 34.4. 

Here are the major steps in the program (Listing 34.2): 

1. Create a popup menu using JPopupMenu. Create menu items for New, Open, Print, and 
Exit using JMenuItem. For the menu items with both labels and icons, it is convenient 
to use the JMenuItem (1 abel , icon) constructor. 

2. Add the menu items into the popup menu. 
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Figure 34-4 A popup menu is displayed when the popup trigger is issued on the text area. 

3. Create a scroll pane and add a text area into it. Place the scroll pane in the center of the 
applet. 

4. Implement the actionPerformed handler to process the events from the menu items. 

5. Implement the mousePressed and mouseRel eased methods to process the events for 
handling popup triggers. 

Listing 34-2 PopupMenuDemo . j ava 

1 import javax. swing.*; 

2 import java.awt.*; 

3 import java.awt. event.*; 
4 

5 public class PopupMenuDemo extends DApplet { 



6 private JPopupMenu jPopupMenul = new JPopupMenuO ; popup menu 

7 private JMenuItem jmiNew = new JMenuItem("New" , 

8 new ImageIcon(getClass() . getResource("image/new.gif"))) ; 

9 private JMenuItem jmiOpen = new JMenuItem("Open" , 

10 new ImageIcon(getClass() .getResource("image/open.gif"))) ; 

11 private JMenuItem jmi Print = new JMenuItem("Print" , 

12 new ImageIcon(getClass() .getResource("image/print.gif"))) ; 

13 private JMenuItem jmiExit = new JMenuItem("Exit") ; 

14 private JTextArea jTextAreal = new JTextAreaO ; 
15 

16 public PopupMenuDemoO { 

17 jPopupMenul.add(jmiNew) ; add menu items 

18 jPopupMenul.add(jmiOpen) ; 

19 jPopupMenul.addSeparatorO ; 

20 j PopupMenul. add(jmi Pri nt) ; 

21 jPopupMenul.addSeparatorO; 

22 jPopupMenul.add(jmiExit) ; 

23 jPopupMenul.add(jmiExit) ; 
24 

25 add(new JScroll Pane (jTextAreal) , BorderLayout . CENTER) ; 
26 

27 jmiNew. addActi onLi stener(new Acti onLi stener() { register listener 

28 public void actionPerformed(ActionEvent e) { 

29 System. out. pri ntln ("Process New"); 

30 } 

31 }); 

32 jmiOpen . addActionLi stener(new ActionLi stener() { register listener 

33 public void actionPerformed(ActionEvent e) { 

34 System. out. pri ntln ("Process Open"); 

35 } 

36 }); 

37 jmi Pri nt . addActi onLi stener(new Acti onLi stener() { register listener 

38 public void actionPerformed(ActionEvent e) { 
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39 System . out . pri ntl n ("Process Print"); 

40 } 

41 }); 

42 jmiExit.addAct"ionListener(new ActionLi stenerO { 

43 public void actionPerformed(ActionEvent e) { 

44 System. exit (0) ; 

45 } 

46 }); 

47 jTextAreal.addMouseListener(new MouseAdapterO { 

48 public void mousePressed(MouseEvent e) { // For Motif 

49 showPopup(e) ; 

50 } 
51 

52 public void mouseRel eased(MouseEvent e) { // For Windows 

53 showPopup(e) ; 

54 } 

55 }); 

56 } 
57 

58 /** Display popup menu when triggered */ 

59 private void showPopup(java.awt. event. MouseEvent evt) { 

60 if (evt . i sPopupTri ggerO ) 

61 jPopupMenul.show(evt.getComponentO , evt.getXO, evt.getYO); 

62 } 

63 } 

The process of creating popup menus is similar to the process for creating regular menus. To 
create a popup menu, create a JPopupMenu as the basis (line 6) and add JMenuItems to it 
(lines 17-23). 

To show a popup menu, use the show method by specifying the parent component and the 
location for the popup menu (line 61). The show method is invoked when the popup menu is 
triggered by a particular mouse click on the text area. Popup triggers are system dependent. 
The listener implements the mouseRel eased handler for displaying the popup menu in Win- 
dows (lines 52-54) and the mousePressed handler for displaying the popup menu in Motif 
(lines 48-50). 

# Tip 

Java provides a new setComponentPopupMenu(JPopupMenu) method in the ^Component 

simplify popup menu class, which can be used to add a popup menu on a component. This method automatically handles 

mouse listener registration and popup display. Using this method, you may delete the showPopup 
method in lines 59-62 and replace the code in lines 47-55 with the following statement: 

jTextAreal. setComponentPopupMenu ( j PopupMenul) ; 



34 4 JToolBar 

In user interfaces, a toolbar is often used to hold commands that also appear in the menus. 
Frequently used commands are placed in a toolbar for quick access. Clicking a command in 
toolbar the toolbar is faster than choosing it from the menu. 

Swing provides the JTool Bar class as the container to hold toolbar components. 
JTool Bar uses BoxLayout to manage components by default. You can set a different layout 
manager if desired. The components usually appear as icons. Since icons are not components, 
they cannot be placed into a toolbar directly. Instead you place buttons into the toolbar and set 



register listener 

register listener 
show popup menu 

show popup menu 



main method omitted 



34 4 JTool Bar I 

the icons on the buttons. An instance of JTool Bar is like a regular container. Often it is 
placed in the north, west, or east of a container of Border Layout. 
The following properties in the JTool Bar class are often useful: 

■ orientation specifies whether the items in the toolbar appear horizontally or verti- 
cally. The possible values are JTool Bar . HORIZONTAL and JTool Bar .VERTICAL. 
The default value is JTool Bar . HORIZONTAL. 

■ f 1 oatabl e is a bool ean value that specifies whether the toolbar can be floated. By 
default, a toolbar is floatable. 

Listing 34.3 gives an example that creates a JTool Bar to hold three buttons with the icons 
representing the commands New, Open, and Print, as shown in Figure 34.5. 



PToolBarDemo 
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Figure 34.5 The toolbar contains the icons representing the commands New, Open, and 
Print. 

Listing 34-3 Tool BarDemo . j ava 

1 import javax. swing.*; 

2 import java.awt.*; 

3 

4 public class ToolBarDemo extends JApplet { 

5 private JButton jbtNew = new JButton( 

6 new ImageIcon(getClass() .getResource("image/new.gif"))) ; 

7 private JButton jbtOpen = new JButton( 

8 new ImageIcon(getClass() .getResource("image/open.gif"))) ; 

9 private JButton jbPrint = new JButton( 
10 new ImageIcon(getClass() .getResource("image/print.gif"))) ; 
11 

12 public Tool BarDemoO { 

13 JToolBar jToolBarl = new JToolBar("My Toolbar"); 

14 jToolBarl. setFl oatabl e (true) ; 

15 jToolBarl. add (jbtNew) ; 

16 jToolBarl. add(jbtOpen) ; 

17 jToolBarl. add(jbPrint) ; 
18 

19 jbtNew. setToolTipText ("New") ; 

20 jbtOpen.setToolTipText("Open") ; 

21 jbPrint.setToolTipText("Print") ; 

22 

23 jbtNew. setBorderPainted(false) ; 

24 jbtOpen.setBorderPainted(false) ; 

25 jbPrint.setBorderPainted(false) ; 

26 

27 add (jToolBarl, BorderLayout . NORTH) ; 

28 } 

29 } 



buttons 



toolbar 



add toolbar 

main method omitted 
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A JToolBar is created in line 13. The toolbar is a container with BoxLayout by default. 
Using the orientation property, you can specify whether components in the toolbar are or- 
ganized horizontally or vertically. By default, it is horizontal. 

By default, the toolbar is floatable, and a floatable controller is displayed in front of its 
components. You can drag the floatable controller to move the toolbar to different locations of 
the window or can show the toolbar in a separate window, as shown in Figure 34.6. 




Figure 34.6 The toolbar buttons are floatable. 



You can also set a title for the floatable toolbar, as shown in Figure 34.7(a). To do so, cre- 
ate a toolbar using the JTool Bar (St ring title) constructor. If you set fl oatabl e false, 
the floatable controller is not displayed, as shown in Figure 34.7(b). If you set a border (e.g., 
a line border), as shown in Figure 34.7(c), the line border is displayed and the floatable con- 
troller is not displayed. 
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Figure 34.7 The toolbar buttons can be customized in many forms. 



Tip 

For the floatable feature to work properly, do the following: ( I ) place a toolbar to one side of the 
container of BorderLayout and add no components to the other sides; (2) don't set border on 
a toolbar. Setting a border would make it non-floatable. 



34-5 Processing Actions Using the Action Interface 

Often menus and toolbars contain some common actions. For example, you can save a file by 
choosing File, Save, or by clicking the save button in the toolbar. Swing provides the Action 
interface, which can be used to create action objects for processing actions. Using Action 
objects, common action processing can be centralized and separated from the other applica- 
tion code. 

The Action interface is a subinterface of ActionLi stener, as shown in Figure 34.8. Ad- 
ditionally, it defines several methods for checking whether the action is enabled, for enabling 
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«i nterface» 
java.awt. event . Acti onLi stene r 



1 




«interface» 




javax.swing. Action 


+getValue(key. 


String) : Object 


+isEnabled() : 


boolean 


+putValue(key. 


String, value: Object): void 


+setEnabled(b. 


boolean): void 


i 



javax.swing. AbstractAction 



+AbstractActionO 




+Abst ractActi on (name : 


Stri ng) 


+Abst ractActi on (name : 


String, icon: Icon) 


+getKeys(): Object [] 





Gets one of this object's properties using the associated key. 
Returns true if action is enabled. 
Associates a key/value pair with the action. 
Enables or disables the action. 



Defines an Acti on object with a default description string and 
default icon. 

Defines an Acti on object with the specified description string 

and a default icon. 
Defines an Acti on object with the specified description string 

and the specified icon. 

Returns an array of objects which are keys for which values 
have been set for this AbstractAction, or nul 1 if no 
keys have values set. 



Figure 34.8 The Action interface provides a useful extension to the ActionLi stener interface in cases where the 
same functionality may be accessed by several controls. The AbstractAction class provides a default implementation 
for Action. 



and disabling the action, and for retrieving and setting the associated action value using a key. 
The key can be any string, but four keys have predefined meanings: 



Key 



Description 



Action. NAME 
Action. SMALL_ICON 
Action. SHORT_DESCRIPTION 
Action . LONC_DESCRIPTION 



A name for the action 

A small icon for the action 

A tool tip for the action 

A description for online help 



AbstractAction is a default implementation of the Action interface, as shown in Figure 
34.8. It implements all the methods in the Action interface except the actionPerformed 
method. Additionally, it defines the getKeysO method. 

Since AbstractAction is an abstract class, you cannot create an instance using its con- 
structor. However, you can create a concrete subclass of AbstractAction and implement 
the actionPerformed method. This subclass can be conveniently defined as an anony- 
mous inner class. For example, the following code creates an Action object for terminating 
a program. 

Action exitAction = new AbstractAction("Exit") { 
public void actionPerformed(ActionEvent e) { 
System.exit(O) ; 

} 

}; 
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Certain containers, such as JMenu and JTool Bar, know how to add an Action object. When 
an Action object is added to such a container, the container automatically creates an appro- 
priate component for the Action object and registers a listener with the Action object. Here 
is an example of adding an Action object to a menu and a toolbar: 

jMenu.add(exitAction) ; 
jTool Bar . add(exi tActi on) ; 

Several Swing components, such as JButton, JRadioButton, and JCheckBox, contain con- 
structors to create instances from Action objects. For example, you can create a JButton 
from an Action object, as follows: 

DButton jbt = new J Button (exi tActi on) ; 

Action objects can also be associated with mnemonic and accelerator keys. To associate ac- 
tions with a mnemonic key (e.g., ALT+E), use the following statement: 

exi tActi on . putVal ue(Acti on .MNEMONIC_KEY, new Integer (KeyEvent . VK_E)) ; 

To associate actions with an accelerator key (e.g., CTRL+E), use the following statement: 

Keystroke exitKey = 

Keystroke . getKeyStroke(KeyEvent . VK_E , KeyEvent . CTRL_MASK) ; 
exi tActi on . putVal ue (Acti on . ACCELERATOR_KEY , exi tKey) ; 

Listing 34.4 gives an example that creates three menu items, Left, Center, and Right, three 
toolbar buttons, Left, Center, and Right, and three regular buttons, Left, Center, and Right, in 
a panel, as shown in Figure 34.9. The panel that holds the buttons uses the Fl owLayout. The 
actions of the left, center, and right buttons set the alignment of the Fl owLayout to left, right, 
and center, respectively. The actions of the menu items, the toolbar buttons, and the buttons in 
the panel can be processed through common action handlers using the Action interface. 



Actio n I n tetfaceOem □ 



Alighnment 



B: Left Ctrl-L 

■ Center ctri-c 
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M Right 



Right alignment for the buttons in the panel 



Figure 34.9 Left, Center, and Right appear in the menu, in the toolbar, and in regular buttons. 



Listing 34.4 ActionlnterfaceDemo. java 

1 import java.awt.*; 

2 import java.awt. event.*; 

3 import javax. swi ng . * ; 
4 

5 public class ActionlnterfaceDemo extends DApplet { 

6 private JPanel buttonPanel = new DPanelO; 

7 private FlowLayout flowLayout = new Fl owLayout() ; 
8 

9 public ActionlnterfaceDemoO { 

10 // Create image icons 
imageicon 11 Imagelcon 1 eftlmagelcon = new ImageIcon(getClass() .getResource( 



34.5 Processing Actions Using the Action Interface 1 163 



12 "image/leftAlignment.png")) ; 

13 Imagelcon centerlmagelcon = new ImageIcon(getClass() . getResource( 

14 "image/centerAl ignment . png")) ; 

15 Imagelcon ri ghtlmagelcon = new ImageIcon(getClass() .getResource( 

16 "image/rightAlignment.png")) ; 
17 

18 // Create actions 

19 Action leftAction = new MyActi on ("Left" , leftlmagelcon , create action 

20 "Left alignment for the buttons in the panel", 

21 new Integer(KeyEvent . VK_L) , 

22 Keystroke. getKeyStroke(KeyEvent . VK_L , Action Event. CTRLJ^IASK)) ; 

23 Action centerAction = new MyActi on("Center" , centerlmagelcon, 

24 "Center alignment for the buttons in the panel", 

25 new Integer(KeyEvent.VK_C) , 

26 Keystroke. getKeyStroke(KeyEvent.VK_C, Acti onEvent . CTRL_MASK) ) ; 

27 Action rightAction = new MyAction("Right" , ri ghtlmagelcon , 

28 "Right alignment for the buttons in the panel", 

29 new Integer (KeyEvent.VK_R) , 

30 Keystroke. getKeyStroke(KeyEvent.VK_R, Acti onEvent. CTRL_MASK)) ; 
31 

32 // Create menus 

33 JMenuBar jMenuBarl = new JMenuBarO; menu 

34 JMenu jmenuAl ignment = new JMenu("Alighnment") ; 

35 setJMenuBar(jMenuBarl) ; 

36 jMenuBarl. add (jmenuAl ignment) ; 
37 

38 // Add actions to the menu 

39 jmenuAlignment.add(leftAction) ; 

40 jmenuAlignment.add(centerAction) ; 

41 jmenuAlignment.add(rightAction) ; 
42 

43 // Add actions to the toolbar 

44 JToolBar jToolBarl = new JTool Bar (DTool Bar. VERTICAL) ; toolbar 

45 jTool Barl. setBorder (Border Facto ry. createLi neBorder (Col or . red)) ; 

46 jToolBarl. add(leftAction) ; 

47 jToolBarl. add(centerAction) ; 

48 jToolBarl. add(rightAction) ; 
49 

50 // Add buttons to the button panel 

51 buttonPanel . setLayout(flowLayout) ; 

52 JButton jbtLeft = new JButton(leftAction) ; button 

53 JButton jbtCenter = new JButton(centerAction) ; 

54 JButton jbtRight = new JButton(rightAction) ; 

55 buttonPanel .add(jbtLeft) ; 

56 buttonPanel .add(jbtCenter) ; 

57 buttonPanel .add(jbtRight) ; 
58 

59 // Add toolbar to the east and panel to the center 

60 add(jToolBarl, BorderLayout . EAST) ; 

61 add(buttonPanel , BorderLayout . CENTER) ; 

62 } 
63 

64 private class MyAction extends AbstractActi on { customaction 

65 String name; 
66 

67 MyActi on (St ring name, Icon icon) { constructor 

68 super (name, icon); 

69 this. name = name; 

70 } 
71 
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main method omitted 



MyAction(String name, Icon icon, String desc, Integer mnemonic, 
Keystroke accelerator) { 
super(name, icon); 

putValue(Action.SHORT_DESCRIPTION, desc) ; 
putVa"lue(Action.MNEMONIC_KEY, mnemonic) ; 
putVal ue (Acti on . ACCELERATOR_KEY , accelerator) ; 
this. name = name; 

} 

public void acti on Performed (Acti onEvent e) { 
if (name.equals("Left")) 

f 1 owLayout . setAl ignment(FlowLayout . LEFT) ; 
else if (name.equals("Center")) 

f 1 owLayout . setAl i gnment (Fl owLayout . CENTER) ; 
else if (name.equals("Right")) 

f 1 owLayout . setAl i gnment (Fl owLayout . RIGHT) ; 

buttonPanel . reval i date() ; 
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80 
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88 
89 

90 } 

91 } 

92 } 

The inner class MyAction extends AbstractAction with a constructor to construct an action 
with a name and an icon (lines 67-70) and another constructor to construct an action with a 
name, icon, description, mnemonic, and accelerator (lines 72-79). The constructors invoke the 
putVal ue method to associate the name, icon, description, mnemonic, and accelerator. It im- 
plements the actionPerformed method to set a new alignment in the panel of the 
Fl owLayout (line 81-90). The reval i date () method validates the new alignment (line 89). 

Three actions, leftAction, centerAction, and rightAction, were created from the 
MyAction class (lines 19-30). Each action has a name, icon, description, mnemonic, and ac- 
celerator. The actions are for the menu items and the buttons in the toolbar and in the panel. 
The menu and toolbar know how to add these objects automatically (lines 39^-1, 46-48). 
Three regular buttons are created with the properties taken from the actions (lines 51-54). 



34-6 JOptionPane Dialogs 

You have used JOptionPane to create input and output dialog boxes. This section provides a 
comprehensive introduction to JOptionPane and other dialog boxes. A dialog box is nor- 
mally used as a temporary window to receive additional information from the user or to pro- 
vide notification that some event has occurred. Java provides the JOptionPane class, which 
can be used to create standard dialogs. You can also build custom dialogs by extending the 
JDial og class. 

The JOptionPane class can be used to create four kinds of standard dialogs: 

■ Message dialog shows a message and waits for the user to click OK. 

■ Conf i rmation dial og shows a question and asks for confirmation, such as OK or 
Cancel. 

■ Input dialog shows a question and gets the user's input from a text field, combo 
box, or list. 

■ Option dial og shows a question and gets the user's answer from a set of options. 

These dialogs are created using the static methods showXxxDialog and generally appear as 
shown in Figure 34.10(a). 
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Figure 34.10 (a) A JOptionPane dialog can display an icon, a message, an input, and op- 
tion buttons, (b) The message dialog displays a message and waits for the user to click OK. 



For example, you can use the following method to create a message dialog box, as shown 
in Figure 34.10(b): 

JOptionPane. showMessageDialog(null , "SSN not found", 

"For Your Information", JOpti onPane . INF0RMATI0N_MESSAGE) ; 

34-6.1 Message Dialogs 

A message dialog box displays a message that alerts the user and waits for the user to click the 
OA' button to close the dialog. The methods for creating message dialogs are: 

public static void showMessageDialog (Component parentComponent , 

Object message) 

public static void showMessageDialog (Component parentComponent, 

Object message, 
String title, 
int messageType) 

public static void showMessageDialog (Component parentComponent, 

Object message, 
String title, 
int messageType, 
Icon icon) 

The parentComponent can be any component or nul 1 . The message is an object, but often 
a string is used. These two parameters must always be specified. The title is a string dis- 
played in the title bar of the dialog with the default value "Message". 
The messageType is one of the following constants: 

JOptionPane. ERR0R_MESSAGE 
JOpti onPane . INF0RMATI0N_MESSACE 
JOpti onPane . P LAI N_MES SAGE 
JOpti onPane . WARNING_MESSAGE 
JOpti onPane . QUESTION_MESSAGE 

By default, messageType is JOptionPane. INF0RMATI0N_MESSACE. Each type has an 
associated icon except the PLAIN_MESSAGE type, as shown in Figure 34.11. You can also 
supply your own icon in the i con parameter. 

The message parameter is an object. If it is a GUI component, the component is displayed. 
If it is a non-GUI component, the string representation of the object is displayed. For example, 
the following statement displays a clock in a message dialog, as shown in Figure 34.12. 
Still Clock was defined in Listing 15.10. 

JOpti onPane. showMessageDialog (nul 1 , new Still CI ock() , 
"Current Time", JOpti onPane . PLAIN_MESSAGE) ; 
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3 This is a printer 
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Figure 34.1 1 There are five types of message dialog boxes. 




Figure 34.12 A clock is displayed in a message dialog. 



34-6.2 Confirmation Dialogs 

A message dialog box displays a message and waits for the user to click the OK button to dis- 
miss the dialog. The message dialog does not return any value. A confirmation dialog asks a 
question and requires the user to respond with an appropriate button. The confirmation dialog 
returns a value that corresponds to a selected button. 
The methods for creating confirmation dialogs are: 

public static int showConfi rmDialog (Component parentComponent , 

Object message) 

public static int showConfi rmDialog (Component parentComponent, 

Object message, 
String title, 
int optionType) 

public static int showConfi rmDialog (Component parentComponent, 

Object message, 

String title, 

int optionType, 

int messageType) 
public static int showConfi rmDialog (Component parentComponent, 

Object message, 

String title, 

int optionType, 

int messageType, 

Icon icon) 
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The parameters parentComponent, message, title, icon, and messageType are the 
same as in the showMessageDial og method. The default value for ti tl e is "Select an Op- 
tion" and for messageType is QUESTION_MESSAGE. The optionType determines which 
buttons are displayed in the dialog. The possible values are: 

lOpti onPane. YES_NO_OPTION 

lOpti onPane . YES_NO_CANCEL_OPTION 

lOpti onPane . OK_CANCEL_OPTION 

Figure 34.13 shows the confirmation dialogs with these options. 
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YES NO OPTION 



Confirm? 



Yes 



No 
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YES NO OPTION 



Confirm? 



OK 
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Figure 34.1 3 The confirmation dialog displays a question and three types of option but- 
tons, and requires responses from the user. 



The showConf i rmDi al og method returns one of the following i nt values corresponding 
to the selected option: 



lOpt 
lOpt 
lOpt 
lOpt 



onPane. YES_OPTION 
onPane. NOJDPTION 
onPane. CANCEL_OPTION 
onPane.OK_OPTION 



JOpti onPane . CL0SEDJ3PTI0N 

These options correspond to the button that was activated, except for the CLOSED_OPTION, 
which implies that the dialog box is closed without buttons activated. 



34-6.3 Input Dialogs 

An input dialog box is used to receive input from the user. The input can be entered from a 
text field or selected from a combo box or a list. Selectable values can be specified in an array, 
and one of them can be designated as the initial selected value. If no selectable value is spec- 
ified when an input dialog is created, a text field is used for entering input. If fewer than twen- 
ty selection values are specified, a combo box is displayed in the input dialog. If twenty or 
more selection values are specified, a list is used in the input dialog. 
The methods for creating input dialogs are shown below: 

public static String showInputDialog (Object message) 
public static String showInputDialog (Component parentComponent, 

Object message) 

public static String showInputDialog (Component parentComponent, 

Object message, 
String title, 
int messageType) 

public static Object showInputDialog (Component parentComponent, 

Object message, 
int messageType, 
Icon icon, 

Object [] selecti onValues, 
Object initialSelectionValue) 



1 168 Chapter 34 Menus, Toolbars, and Dialogs 



The first three methods listed above use a text field for input, as shown in Figure 34.14(a) . 
The last method listed above specifies an array of Object type as selection values in addition 
to an object specified as an initial selection. The first three methods return a String that is 
entered from the text field in the input dialog. The last method returns an Object selected 
from a combo box or a list. The input dialog displays a combo box if there are fewer than 
twenty selection values, as shown in Figure 34.14(b); it displays a list if there are twenty or 
more selection values, as shown in Figure 34.14(c). 
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Figure 34.14 (a) When creating an input dialog without specifying selection values, the input dialog displays a text 
field for data entry, (b) When creating an input dialog with selection values, the input dialog displays a combo box if 
there are fewer than twenty selection values, (c) When creating an input dialog with selection values, the input dialog dis- 
plays a list if there are twenty or more selection values. 



f|| Note 

The showInputDialog method does not have the optionType parameter. The buttons for 
input dialog are not configurable. The OK and Cancel buttons are always used. 

34-6.4 Option Dialogs 

An option dialog allows you to create custom buttons. You can create an option dialog using 
the following method: 

public static int showOpti onDi al og(Component parentComponent , 

Object message, 
String title, 
int optionType, 
int messageType, 
Icon icon, 
Object [] options, 
Object initial Value) 

The buttons are specified using the options parameter. The initialValue parameter al- 
lows you to specify a button to receive initial focus. The showOpti onDial og method returns 
an int value indicating the button that was activated. For example, here is the code that cre- 
ates an option dialog, as shown in Figure 34.15: 

int value = 

JOptionPane. showOpti onDialog (null , "Select a button", 
"Option Dialog", JOptionPane. DEFAULT_OPTION , 
JOptionPane. PLAIN_MESSAGE , null , 
new Object [] {"Button 0", "Button 1", "Button 2"}, "Button 1"); 
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Select a button 
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Figure 34.15 The option dialog displays the custom buttons. 



34-6.5 Example: Creating JOptionPane Dialogs 

This section gives an example that demonstrates the use of JOptionPane dialogs. The pro- 
gram prompts the user to select the annual interest rate from a list in an input dialog, the num- 
ber of years from a combo box in an input dialog, and the loan amount from an input dialog, 
and it displays the loan payment schedule in a text area inside a JScrol 1 Pane in a message 
dialog, as shown in Figure 34.16. 
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Figure 34.1 6 The input dialogs can contain a list or a combo box for selecting input, and 
the message dialogs can contain GUI objects like JScrol 1 Pane. 



Here are the major steps in the program (Listing 34.5): 

1 . Display an input dialog box to let the user select an annual interest rate from a list. 

2. Display an input dialog box to let the user select the number of years from a combo box. 
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3. Display an input dialog box to let the user enter the loan amount. 

4. Compute the monthly payment, total payment, and loan payment schedule, and display 
the result in a text area in a message dialog box. 

Listing 34.5 JOptionPaneDemo. java 

1 import javax. swing.*; 
2 

3 public class DOpti onPaneDemo { 

4 public static void main(String args[]) { 

5 // Create an array for annual interest rates 

6 0bject[] rateList = new Object[25]; 

7 int i = 0; 

8 for (double rate = 5; rate <= 8; rate += 1.0 / 8) 

9 rateList[i++] = new Double (rate) ; 
10 

11 // Prompt the user to select an annual interest rate 

inputdialog 12 Object annual InterstRateObj ect = 10ptionPane.showInputDialog( 

13 null, "Select annual interest rate:", "JOptionPaneDemo" , 

14 DOpti onPane . QUESTION_MESSACE , null, rateList, null); 

15 double annual InterestRate = 

16 ((Double)annuallnterstRateObject) . doubl eVal ue() ; 
17 

18 // Create an array for number of years 

19 0bject[] yearList = {new Integer(7), new Integer(lS), 

20 new Integer(30) } ; 
21 

22 // Prompt the user to enter number of years 

inputdialog 23 Object numberOfYearsObject = 10ptionPane.showInputDialog(null , 

24 "Select number of years:", "JOptionPaneDemo" , 

2 5 DOpti onPane . QUESTI0N_MESSACE , null, yearList, null); 

26 int numberOfYears = ((Integer)numberOfYearsObject) . i ntVal ue() ; 
27 

28 // Prompt the user to enter loan amount 

inputdialog 29 String loanAmountString = 10ptionPane.showInputDialog(null , 

30 "Enter loan amount, \nf or example, 150000 for $150000", 

31 "JOptionPaneDemo", JOpti onPane . QUESTI0N_MESSAGE) ; 

32 double loanAmount = Double. parseDouble(loanAmountString) ; 
33 

34 // Obtain monthly payment and total payment 

35 Loan loan = new Loan( 

36 annual InterestRate , numberOfYears, loanAmount); 

37 double monthl yPayment = loan.getMonthlyPayment() ; 

38 double total Payment = 1 oan . getTotal Payment () ; 
39 

40 // Prepare output string 

41 String output = "Interest Rate: " + annual InterestRate + "%" + 

42 " Number of Years: " + numberOfYears + " Loan Amount: $" 

43 + loanAmount; 

44 output += "\nMonthly Payment: " + "$" + 

45 (int) (monthl yPayment * 100) / 100.0; 

46 output += "\nTotal Payment: $" + 

47 (int) (monthl yPayment * 12 * numberOfYears * 100) / 100.0 + "\n"; 
48 

49 // Obtain monthly interest rate 

50 double monthl ylnterestRate = annual InterestRate / 1200; 
51 
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52 double balance = "loanAmount; 

53 double interest; 

54 double principal; 
55 

56 // Display the header 

57 output += "\nPayment#\tInterest\tPrincipal\tBalance\n" ; 

58 

59 for (i =1; i <= numberOfYears * 12; i++) { 

60 interest = (int) (monthlylnterestRate * balance * 100) / 100.0; 

61 principal = (int) ((monthlyPayment - interest) * 100) / 100.0; 

62 balance = (int) ((balance - principal) * 100) / 100.0; 

63 output += i + "\t" + interest + "\t" + principal + "\t" + 

64 balance + "\n"; 

65 } 
66 

67 // Display monthly payment and total payment 

68 JScrollPane jsp = new J Scroll Pane (new JTextArea(output)) ; 

69 jsp.setPreferredSize(new java.awt.Dimension(400, 200)); 

70 10ptionPane.showMessageDialog(null , jsp, message dialog 

71 "JOptionPaneDemo", JOpti onPane . INF0RMATI0N_MESSAGE , null); 



72 } 

73 } 

The JOptionPane dialog boxes are modal, which means that no other window can be ac- 
cessed until a dialog box is dismissed. 

You have used the input dialog box to enter input from a text field. This example shows 
that input dialog boxes can also contain a list (lines 12-14) or a combo box (lines 23-25) to 
list input options. The elements of the list are objects. The return value from these input dia- 
log boxes is of the Obj ect type. To obtain a doubl e value or an i nt value, you have to cast 
the return object into Doubl e or Integer, then use the doubl eVal ue or i ntVal ue method 
to get the doubl e or i nt value (lines 15-16 and 26). 

You have already used the message dialog box to display a string. This example shows that 
the message dialog box can also contain GUI objects. The output string is contained in a text 
area, the text area is inside a scroll pane, and the scroll pane is placed in the message dialog 
box (lines 68-71). 

34-7 Creating Custom Dialogs 

Standard JOptionPane dialogs are sufficient in most cases. Occasionally, you need to create 
custom dialogs. In Swing, the JDial og class can be extended to create custom dialogs. 

As with JFrame, components are added to the contentPane of JDial og. Creating a cus- 
tom dialog usually involves laying out user interface components in the dialog, adding buttons 
for dismissing the dialog, and installing listeners that respond to button actions. 

The standard dialog is modal, which means that no other window can be accessed before 
the dialog is dismissed. However, the custom dialogs derived from JDial og are not modal by 
default. To make a dialog modal, set its modal property to true. To display an instance of 
JDial og, set its visible property to true. 

Let us create a custom dialog box for choosing colors, as shown in Figure 34.17(a). Use 
this dialog to choose the color for the foreground of the button, as shown in Figure 34.17(b). 
When the user clicks the Change Button Text Color button, the Choose Color dialog box is 
displayed. 

Create a custom dialog component named ColorDialog by extending JDial og. Use 
three sliders to specify red, green, and blue components of a color. The program is given in 
Listing 34.6. 
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Figure 34.1 7 The custom dialog allows you to choose a color for the label's foreground. 



Listing 34.6 ColorDialog. java 



color value 



sliders 



buttons 



constructor 



constructor 
create UI 



1 
2 
3 
4 
5 
6 
7 
8 
9 
10 
11 
12 
13 
14 
15 
16 
17 
18 
19 
20 
21 
22 
23 
24 
25 
26 
27 
28 
29 
30 
31 
32 
33 
34 
35 
36 
37 
38 
39 
40 
41 
42 
43 
44 
45 
46 



import java.awt.*; 
import java.awt. event.*; 
import javax. swi ng . * ; 
import javax. swing. event.-; 

public class ColorDialog extends DDialog { 

// Declare color component values and selected color 
private int redValue, greenValue, blueValue; 
private Color color = null; 

// Create sliders 

private JSlider jslRed = new DSlider(0, 128); 
private JSlider jslGreen = new DSlider(0, 128); 
private JSlider jslBlue = new JSlider(0, 128); 

// Create two buttons 

private JButton jbtOK = new ]Button("0K") ; 
private JButton jbtCancel = new D Button ("Cancel ") ; 

// Create a panel to display the selected color 
private JPanel jpSelectedColor = new JPanelO; 

public ColorDialogO { 
this(null , true) ; 

} 

public ColorDialog(java.awt. Frame parent, boolean modal) { 
super (parent , modal); 
setTitle("Choose Color"); 

// Croup two buttons OK and Cancel 
1 Panel jpButtons = new ] Panel (); 
j pButtons . add ( j btOK) ; 
jpButtons. add (jbtCancel) ; 

// Croup labels 

J Panel jpLabels = new JPanelO; 
jpLabel s . setLayout(new GridLayout(3 , 0)); 
jpLabels .add (new JLabel ("Red")) ; 
j pLabel s . add (new J Label ("Green") ) ; 
jpLabels. add (new JLabel ("Blue")) ; 

// Group sliders for selecting red, green, and blue colors 
IPanel jpSliders = new IPanelO; 
j pSl i ders . setLayout(new Gri dLayout(3 , 0)); 
jpSliders.add(jslRed) ; 
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47 j pSliders. add (j si Green) ; 

48 jpSliders.add(jslBlue) ; 
49 

50 // Group jpLabels and jpSliders 

51 JPanel jpSelectColor = new DPanelO; 

52 jpSelectColor. setLayout(new BorderLayoutO); 

53 jpSelectColor. setBorder( 

54 BorderFactory.createTitledBorder("Select Color")); 

55 jpSelectColor. add(jpLabels, BorderLayout .WEST) ; 

56 j pSel ectColor . add(jpSl iders , BorderLayout . CENTER) ; 
57 

58 // Group jpSelectColor and jpSelectedColor 

59 J Panel jpColor = new JPanelO; 

60 j pCol or . setLayout(new BorderLayoutO); 

61 jpColor. add(jpSelectColor, BorderLayout . SOUTH) ; 

62 jpColor.add(jpSelectedColor, BorderLayout . CENTER) ; 
63 

64 // Place jpButtons and jpColor into the dialog box 

65 add(jpButtons, BorderLayout . SOUTH) ; 

66 add(jpColor, BorderLayout . CENTER) ; 

67 pack() ; 
68 

69 jbtOK.addActionListener(new Acti onLi stener() { listeners 

70 public void actionPerformed(ActionEvent e) { 

71 setVi si ble (false) ; 

72 } 

73 }); 
74 

75 jbtCancel . addActionLi stener(new ActionLi stener() { 

76 public void acti onPerformed(Acti onEvent e) { 

77 color = null ; 

78 setVisible(false) ; 

79 } 

80 }); 
81 

82 jsl Red . addChangeLi stener(new ChangeLi stener() { 

83 public void stateChanged(ChangeEvent e) { 

84 redValue = jslRed.getValue() ; 

85 color = new Col or(redVal ue , greenValue, blueValue); 

86 jpSelectedColor. setBackground(color) ; 

87 } 

88 }); 
89 

90 jslGreen.addChangeListener(new ChangeLi stener() { 

91 public void stateChanged(ChangeEvent e) { 

92 greenValue = jslGreen.getValueO ; 

93 color = new Col or(redVal ue , greenValue, blueValue); 

94 jpSelectedColor. setBackground(color) ; 

95 } 

96 }); 
97 

98 j si Bl ue . addChangeLi stener(new ChangeLi stener() { 

99 public void stateChanged(ChangeEvent e) { 

100 blueValue = jslBlue.getValue() ; 

101 color = new Col or(redVal ue , greenValue, blueValue); 

102 jpSelectedColor. setBackground(color) ; 

103 } 

104 }) ; 



105 } 
106 
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listener 



main method omitted 



107 
108 
109 
110 
111 
112 
113 
114 
115 } 



public Dimension getPreferredSi ze() { 
return new java.awt. Dimension (200, 200); 

} 

/** Return color */ 
public Color getColorO { 
return color; 

} 



Create a test class to use the color dialog to select the color for the foreground color of the but- 
ton in Listing 34.7. 

Listing 34-7 TestColorDialog. java 



1 

2 

3 

4 

5 

6 

7 

8 

9 
10 
11 
12 
13 
14 
15 
16 
17 
18 
19 
20 
21 
22 } 



import javax. swi ng . * ; 
import java.awt.*; 
import java. awt . event .* ; 

public class TestColorDialog extends DApplet { 

private ColorDialog colorDialogl = new ColorDialogO ; 
private JButton jbtChangeCol or = new J Button ("Choose color"); 

public TestColorDialogO { 

set Layout (new java . awt . FlowLayoutO) ; 
j btChangeCol or. setText ("Change Button Text Color"); 
jbtChangeColor.addActionListener(new Acti onLi stener() { 
public void actionPerformed(ActionEvent e) { 
col orDi al ogl. setVi si bl e(true) ; 

if (colorDialogl. getColorO != null) 

jbtChangeCol or. set Foreground (col orDial ogl. getColorO) ; 



} 

}); 

add(jbtChangeColor) ; 



The custom dialog box allows the user to use the sliders to select colors. The selected color is 
stored in the color variable. When the user clicks the Cancel button, color becomes null, 
which implies that no selection has been made. 

The dialog box is displayed when the user clicks the Change Button Text Color button and 
is closed when the OK button or the Cancel button is clicked. 



Tip 

Not setting the dialog modal when needed is a common mistake. In this example, the dialog is set 
modal in line 24 in ColorDialog.java (Listing 34.6). If the dialog is not modal, all the statements in 
the Change Button Text Color button handler are executed before the color is selected from the 
dialog box. 



34 8 JColorChooser 

You created a color dialog in the preceding example as a subclass of JDi al og, which is a sub- 
class of java. awt. Dialog (a top-level heavy-weight component). Therefore, it cannot be 
added to a container as a component. Color dialogs are commonly used in GUI programming. 
Swing provides a convenient and versatile color dialog named j avax. swing. JCol or - 
Chooser. JColorChooser is a lightweight component inherited from ^Component. It can 
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be added to any container. For example, the following code places a JColorChooser in an 
applet, as shown in Figure 34.18. 
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Figure 34.18 An instance of JColorChooser is displayed in an applet. 



public class JCol orChooserDemo extends javax. swing. JApplet { 
public JCol orChooserDemoO { 

this.add(new javax. swi ng . JCol orChooser() ) ; 

} 

} 

Often an instance of JColorChooser is displayed in a dialog box using JColorChooser's 
static showDialog method: 

public static Color showDialog (Component parentComponent , 

String title, 
Color initialColor) 

For example, the following code displays a JColorChooser, as shown in Figure 34.19. 

Color color = IColorChooser. showDialog (this, "Choose a color", 
Col or. YELLOW); 

The showDi al og method creates an instance of JDi al og with three buttons, OK, Cancel, and 
Reset, to hold a JColorChooser object, as shown in Figure 34.19(a). The method displays a 
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Figure 34.19 An instance of JColorChooser is displayed in a dialog box with the OK, 
Cancel, and Reset buttons. 
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modal dialog. If the user clicks the OK button, the method dismisses the dialog and returns the 
selected color. If the user clicks the Cancel button or closes the dialog, the method dismisses 
the dialog and returns nul 1 . 

JCol orChooser consists of a tabbed pane and a color preview panel. The tabbed pane has 
three tabs for choosing colors using Swatches, HSB, and RGB, as shown in Figure 34.19(b). 
The preview panel shows the effect of the selected color. 

Ip Note 

JCol orChooser is very flexible. It allows you to replace the tabbed pane or the color preview 
panel with custom components. The default tabbed pane and the color preview panel are suffi- 
cient. You rarely need to use custom components. 



34-9 JFileChooser 

The javax. swing . JFil eChooser class displays a dialog box from which the user can nav- 
igate through the file system and select files for loading or saving, as shown in Figure 34.20. 
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Figure 34-20 The Swing JFileChooser shows files and directories, and enables the user 
to navigate through the file system visually. 



Like JCol orChooser, JFileChooser is a lightweight component inherited from 
^Component. It can be added to any container if desired, but often you create an instance of 
JFileChooser and display it standalone. 

JFileChooser is a subclass of ^Component. There are several ways to construct a file 
dialog box. The simplest is to use JFileChooser's no-arg constructor. 

The file dialog box can appear in two types: open and save. The open type is for opening a 
file, and the save type is for storing a file. To create an open file dialog, use the following 
method: 

public int showOpenDi a~l og (Component parent) 

This method creates a dialog box that contains an instance of JFileChooser for opening a 
file. The method returns an int value, either APPR0VE_0PTI0N or CANCEL_0PTI0N, which 
indicates whether the Open button or the Cancel button was clicked. 

Similarly, you can use the following method to create a dialog for saving files: 

public int showSaveDi al og(Component parent) 
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The file dialog box created with showOpenDial og or showSaveDialog is modal. The 
JFileChooser class has the properties inherited from ^Component. It also has the follow- 
ing useful properties: 

■ dialogType specifies the type of this dialog. Use OPEN_DIALOG when you want to 
bring up a file chooser that the user can use to open a file. Likewise, use SAVE_DIALOG 
to let the user choose a file for saving. 

■ dial ogTi tl e is the string that is displayed in the title bar of the dialog box. 

■ currentDi rectory is the current directory of the file. The type of this property is 
java. io. File. If you want the current directory to be used, use setCurrent- 
Directory(new File("."))- 

■ selectedFile is the file you have selected. You can use getSelectedFileO to 

return the selected file from the dialog box. The type of this property is java.io. 
File. If you have a default file name that you expect to use, use setSelected- 
File(new File(filename)). 

■ multiSelectionEnabled is a boolean value indicating whether multiple files 
can be selected. By default, it is f al se. 

■ sel ectedFi 1 es is a list of the files selected if the file chooser is set to allow multi- 
selection. The type of this property is Fil e[] . 

Let us create an example of a simple text editor that uses Swing menus, toolbar, file chooser, 
and color chooser, as shown in Figure 34.21, which allows the user to open and save text files, 
clear text, and change the color and font of the text. Listing 34.8 shows the program. 
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Figure 34.2 1 The editor enables you to open and save text files from the File menu or from 
the toolbar, and to change the color and font of the text from the Edit menu. 



Listing 34-8 TextEdi tor. java 

1 i mpor t j ava . i o . * ; 

2 import java.awt.*; 

3 import java.awt. event.*; 

4 import javax. swi ng . * ; 
5 

6 public class TextEditor extends DApplet { 

7 // Declare and create image icons 

8 private Imagelcon openlmagelcon = 

9 new Imagelcon (getCl ass O .getResource("image/open.gif")) I 

10 private Imagelcon savelmagelcon = 

11 new ImageIcon(getClass() .getResource("image/save.gif")) I 
12 



1178 Chapter 34 



Menus, Toolbars, and Dialogs 



13 // Create menu items 

14 private JMenuItem jmiOpen = new JMenuItem("Open" , openlmagelcon) ; 

15 private JMenuItem jmiSave = new JMenuItem("Save" , savelmagelcon) ; 

16 private JMenuItem jmiClear = new JMenuItem("Clear") ; 

17 private JMenuItem jmiExit = new JMenuItem("Exit") ; 

18 private JMenuItem jmi Foreground = new JMenuItem("Foreground") ; 

19 private JMenuItem jmi Background = new JMenuItem("Background") ; 
20 

21 // Create buttons to be placed in a toolbar 

22 private JButton jbtOpen = new JButton(openlmagelcon) ; 

23 private JButton jbtSave = new JButton(savelmagelcon) ; 

24 private J Label jlbl Status = new JLabelO; 
25 

26 // Create a JFileChooser with the current directory 

27 private JFileChooser j Fi 1 eChooserl 

28 = new JFileChooser(new File(".")); 
29 

30 // Create a text area 

31 private JTextArea jta = new JTextAreaO ; 
32 

create UI 33 public TextEditorO { 

34 // Add menu items to the menu 

35 JMenu jMenul = new JMenu("File") ; 

36 jMenul. add(jmiOpen) ; 

37 jMenul. add(jmiSave) ; 

38 jMenul. add(jmiClear) ; 

39 jMenul . addSeparatorO ; 

40 jMenul. add(jmi Exit) ; 
41 

42 // Add menu items to the menu 

43 JMenu jMenu2 = new JMenu("Edit") ; 

44 jMenu2 .add(jmi Foreground) ; 

45 jMenu2 . add(jmi Background) ; 
46 

47 // Add menus to the menu bar 

48 JMenuBar jMenuBarl = new JMenuBar(); 

49 jMenuBarl. add(jMenul) ; 

50 jMenuBarl. add(jMenu2) ; 
51 

52 // Set the menu bar 

53 setJMenuBar(jMenuBarl) ; 
54 

55 // Create toolbar 

56 JToolBar jToolBarl = new JToolBarO; 

57 jToolBarl. add(jbtOpen) ; 

58 jToolBarl. add(jbtSave) ; 
59 

60 jmiOpen . addActionLi stener(new ActionLi stener() { 

61 public void actionPerformed(ActionEvent e) { 

62 open(); 

63 } 

64 }); 
65 

66 jmiSave.addActionListener(new ActionLi stener() { 

67 public void actionPerformed(ActionEvent evt) { 

68 save(); 

69 } 

70 }); 
71 

72 jmiClear.addActionListener(new Acti onLi stenerQ { 
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73 public void acti onPerformed(Acti onEvent evt) { 

74 jta.setText(null) ; 

75 } 

76 }); 
77 

78 jmi Exi t . addActi onLi stener(new Acti onLi stener() { 

79 public void acti onPerformed(Acti onEvent evt) { 

80 System. exi t(0) ; 

81 } 

82 }); 
83 

84 jmi Foreground . addActi onLi stener(new ActionLi stenerO { 

85 public void acti onPerformed(Acti onEvent evt) { 

86 Color sel ectedCol or = 

87 JColorChooser.showDialog(null , "Choose Foreground Color", colorchooser 

88 jta.getForegroundO) ; 

89 

90 if (sel ectedCol or != null) 

91 jta.setForeground(selectedColor) ; 

92 } 

93 }); 
94 

95 jmi Background . addActi onLi stener(new ActionLi stenerO { 

96 public void acti onPerformed(Acti onEvent evt) { 

97 Color sel ectedCol or = 

98 JColorChooser.showDialog(null , "Choose Background Color", colorchooser 

99 jta.getForegroundO); 
100 

101 if (sel ectedCol or != null) 

102 jta.setBackground(selectedColor) ; 

103 } 

104 }) ; 
105 

106 jbtOpen . addActi onLi stener(new ActionLi stenerO { 

107 public void acti onPerformed(Acti onEvent evt) { 

108 open(); 

109 } 

110 }) ; 
111 

112 jbtSave.addActionListener(new ActionLi stenerO { 

113 public void acti onPerformed(Acti onEvent evt) { 

114 save(); 

115 } 

116 }); 
117 

118 add(jToolBarl, BorderLayout . NORTH) ; 

119 add(jlblStatus, BorderLayout . SOUTH) ; 

120 add(new JScroll Pane(jta) , BorderLayout . CENTER) ; 

121 } 
122 

123 /** Open file */ 

124 private void open() { 

125 if (jFileChooserl.showOpenDialog(this) == file chooser 

126 JFileChooser.APPR0VE_0PTI0N) 

127 open(jFileChooserl.getSelectedFileO) ; 

128 } 
129 

130 /** Open file with the specified File instance */ 

131 private void open(File file) { 

132 try { 



1 180 Chapter 34 Menus, Toolbars, and Dialogs 



133 // Read from the specified file and store it in jta 

134 Buff eredlnputStream in = new BufferedInputStream( 

135 new FilelnputStream(file)) ; 

136 byte[] b = new byte[in.available()] ; 

137 in.read(b, 0, b. length); 

138 jta. append (new String(b, 0, b. length)); 

139 in.closeO; 
140 

141 // Display the status of the Open file operation in jlbl Status 

142 jlbl Status. setText(file.getName() + " Opened"); 

143 } 

144 catch (IOException ex) { 

145 jlblStatus.setText("Error opening " + file.getNameO) ; 

146 } 

147 } 
148 

149 /** Save file */ 

150 private void save() { 

151 if (jFileChooserl.showSaveDialog(this) == 

152 JFileChooser.APPR0VE_0PTI0N) { 

153 save(jFileChooserl.getSelectedFileO) ; 

154 } 

155 } 
156 

157 /** Save file with specified File instance */ 

158 private void save (File file) { 

159 try { 

160 // Write the text in jta to the specified file 

161 BufferedOutputStream out = new Buffered0utputStream( 

162 new Fi 1 e0utputStream(fi 1 e)) ; 

163 byte[] b = (jta.getTextO) .getBytesO ; 

164 out.write(b, 0, b. length); 

165 out.close(); 
166 

167 // Display the status of the save file operation in jlbl Status 

168 jlbl Status. setText (file.getNameO + " Saved "); 

169 } 

170 catch (IOException ex) { 

171 jlblStatus.setText("Error saving " + file.getNameO); 

172 } 

173 } 



main method omitted 174 } 

The program creates the File and Edit menus (lines 34^-5). The File menu contains the menu 
commands Open for loading a file, Save for saving a file, Clear for clearing the text editor, and 
Exit for terminating the program. The Edit menu contains the menu commands Foreground Color 
and Background Color for setting foreground color and background color in the text. The Open 
and Save menu commands can also be accessed from the toolbar, which is created in lines 56-58. 
The status of executing Open and Save is displayed in the status label, which is created in line 24. 

jFileChooserl, an instance of JFileChooser, is created for displaying the file dialog 
box to open and save files (lines 27-28). new Fil e(" . ") is used to set the current directory 
to the directory where the class is stored. 

The open method is invoked when the user clicks the Open menu command or the Open 
toolbar button (lines 62, 108). The showOpenDialog method (line 125) displays an Open di- 
alog box, as shown in Figure 34.20. Upon receiving the selected file, the method open(f ile) 
(line 127) is invoked to load the file to the text area using a Buf feredlnputStream wrapped 
on a FilelnputStream. 
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The save method is invoked when the user clicks the Save menu command or the Save 
toolbar button (lines 68, 114). The showSaveDialog method (line 151) displays a Save dia- 
log box. Upon receiving the selected file, the method save(file) (line 153) is invoked to 
save the contents from the text area to the file, using a BufferedOutputStream wrapped on 
a FileOutputStream. 

The color dialog is displayed using the static method showDialog (lines 87, 98) of 
JColorChooser. Thus you don't need to create an instance of JFil eChooser. The 
showDialog method returns the selected color if the OK button is clicked after a color is 
selected. 

Chapter Summary 

1 . Menus make selection easier and are widely used in window applications. Java pro- 
vides five classes that implement menus: JMenuBar, JMenu, JMenuItem, 
JCheckBoxMenuItem, and JRadioButtonMenuItem. These classes are subclasses 
of AbstractButton. They are very similar to buttons. 

2. JMenuBar is a top-level menu component used to hold menus. A menu consists of 
menu items that the user can select (or toggle on or off). A menu item can be an in- 
stance of JMenuItem, JCheckBoxMenuItem, or JRadioButtonMenuItem. Menu 
items can be associated with icons, keyboard mnemonics, and keyboard accelerators. 
Menu items can be separated using separators. 

3. A popup menu, also known as a context menu, is like a regular menu, but does not have 
a menu bar and can float anywhere on the screen. Creating a popup menu is similar to 
creating a regular menu. First, you create an instance of JPopupMenu, then you can 
add JMenuItem, JCheckBoxMenuItem, JRadioButtonMenuItem, and separators 
to the popup menu. 

4. Customarily, you display a popup menu by pointing to a GUI component and clicking 
a certain mouse button, the so-called popup trigger. Popup triggers are system depen- 
dent. In Windows, the popup menu is displayed when the right mouse button is re- 
leased. In Motif, the popup menu is displayed when the third mouse button is pressed 
and held down. 

5. Swing provides the JToolBar class as the container to hold toolbar components. 
JTool Bar uses BoxLayout to manage components. The components usually appear 
as icons. Since icons are not components, they cannot be placed into a toolbar direct- 
ly. Instead you place buttons into the toolbar and set the icons on the buttons. An in- 
stance of JTool Bar is like a regular container. Often it is placed in the north, west, or 
east of a container of BorderLayout. 

6. Swing provides the Action interface, which can be used to create action objects for 
processing actions. Using Action objects, common action processing for menu 
items and toolbar buttons can be centralized and separated from the other application 
code. 

7. The JOptionPane class contains the static methods for creating message dialogs, 
confirmation dialogs, input dialogs, and option dialogs. You can also create custom di- 
alogs by extending the JDialog class. 
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8. Swing provides a convenient and versatile color dialog named javax. swing . - 
JColorChooser. Like JOptionPane, JColorChooser is a lightweight component 
inherited from ^Component. It can be added to any container. 

9. Swing provides the javax. swing. JFileChooser class that displays a dialog box 
from which the user can navigate through the file system and select files for loading or 
saving. 

Review Questions 

Section 34-2 

34-1 How do you create a menu bar? 

34-2 How do you create a submenu? How do you create a check-box menu item? How 
do you create a radio-button menu item? 

34-3 How do you add a separator in a menu? 

34-4 How do you set an icon and a text in a menu item? How do you associate keyboard 
mnemonics and accelerators in a menu item? 

Section 34-3 

34.5 How do you create a popup menu? How do you show a popup menu? 

34.6 Describe a popup trigger. 

Section 34-4 

34 • 7 What is the layout manager used in JTool Bar? Can you change the layout manager? 

34-8 How do you add buttons into a JTool Bar? How do you add a JTool Bar into a 
frame or an applet? 

Section 34-5 

34.9 What is the Action interface for? 

34-10 How do you add an Action object to a JTool Bar, JMenu, JButton, 
JRadioButton, and JCheckBox? 

Section 34-6 

34- 1 I Describe the standard dialog boxes created using the JOptionPane class. 

34*12 How do you create a message dialog? What are the message types? What is the 
button in the message dialog? 

34. 1 3 How do you create a confirmation dialog? What are the button option types? 

34. 1 4 How do you create an input dialog with a text field for entering input? How do you 
create a combo box dialog for selecting values as input? How do you create a list 
dialog for selecting values as input? 

Sections 34.7-34.10 

34- 1 5 How do you show an instance of JDi al og? Is a standard dialog box created using 
the static methods in JOptionPane modal? Is an instance of JDialog modal? 

34*1 6 How do you display an instance of JColorChooser? Is an instance of 
JColorChooser modal? How do you obtain the selected color? 

34.17 How do you display an instance of JFileChooser? Is an instance of 
JFileChooser modal? How do you obtain the selected file? What is the return 
type for getSelectedFileO and getSelectedDi rectory ()? How do you 
set the current directory as the default directory for a JFi 1 eChooser dialog? 
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Sections 34-2-34-3 

34 - 1 * (Creating an investment value calculator) Write a program that calculates the fu- 
ture value of an investment at a given interest rate for a specified number of years. 
The formula for the calculation is as follows: 

futu revalue = i nvestmentAmount x (1 + monthtyInterestRate) years><12 

Use text fields for interest rate, investment amount, and years. Display the future 
amount in a text field when the user clicks the Calculate button or chooses Calcu- 
late from the Operation menu (see Figure 34.22). Show a message dialog box 
when the user clicks the About menu item from the Help menu. 
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Figure 34-22 The user enters the investment amount, years, and interest rate to compute 
future value. 



34-2* (Using popup menus) Modify Listing 34.1, MenuDemo.java, to create a popup 
menu that contains the menus Operations and Exit, as shown in Figure 34.23. The 
popup is displayed when you click the right mouse button on the panel that con- 
tains the labels and the text fields. 
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Figure 34-23 The popup menu contains the commands to perform arithmetic operations. 



Sections 34-4-34-5 

34-3* *(A paint utility) Write a program that emulates a paint utility. Your program 
should enable the user to choose options and draw shapes or get characters from 
the keyboard based on the selected options (see Figure 34.24). The options are 
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Figure 34-24 This exercise produces a prototype drawing utility that enables you to draw 
lines, rectangles, ovals, and characters. 
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displayed in a toolbar. To draw a line, the user first clicks the line icon in the tool- 
bar and then uses the mouse to draw a line in the same way you would draw using 
Microsoft Paint. 

34-4* (Using actions) Write a program that contains the menu items and toolbar buttons 
that can be used to select flags to be displayed in an ImageViewer, as shown in 
Figure 34.25. Use the Action interface to centralize the processing for the actions. 
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Figure 34-25 The menu items and tool buttons are used to display selected images in the 
ImageViewer. 



Sections 34.6-34.10 

34-5* (Demonstrating JOptionPane) Write a program that creates option panes of all 
types, as shown in Figure 34.26. Each menu item invokes a static showXxxDialog 
method to display a dialog box. 
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Figure 34-26 You can display a dialog box by clicking a menu item. 



34.6* (Creating custom dialog) Write a program that creates a custom dialog box to 
gather user information, as shown in Figure 34.27(a). 




OK 



Cancel 



B E>icra5c34_7 


-!□!>< 


Professor Y. Daniel Liang, PhD 




De p arime nt oT Comp uter 3 c le nee 


* telephone: {91 2) 921-5440 


ijrfrstrotfiQ Ajl^nOc siaU* Unfr&fsrtjr 


h to. (912) 921-5906 


1 1 935 AhHrcuru SIihhI 


4 llHIICJ@HliriSlllHIIJ HllLI 


Savannah, OeDrni a 31 41 S-1997 


* hittp^rwvrtv.ts.arrnstrono.edu/liang 


Filename signa1ure.txt 


| Browse 



(a) 



(b) 



Figure 34-27 (a) The custom dialog box prompts the user to enter username and password, 
(b) The program enables the user to view a file by selecting it from a file open dialog box. 



34.7* (Using JFiTeChooser) Write a program that enables the user to select a file from 
a file open dialog box. A file open dialog box is displayed when the Browse button 
is clicked, as shown in Figure 34.27(b). The file is displayed in the text area, and 
the file name is displayed in the text field when the OK button is clicked in the file 
open dialog box. You can also enter the file name in the text field and press the 
Enter key to display the file in the text area. 
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34.8* (Selecting an audio file) Write a program that selects an audio file using the file 
dialog box, and use three buttons, Play, Loop, and Stop, to control the audio, as 
shown in Figure 34.28. If you click the P lay button, the audio file is played 
once. If you click the Loop button, the audio file keeps playing repeatedly. If 
you click the Stop button, the playing stops. The selected audio files are stored in 
the folder named anthems under the exercise directory. The exercise directory 
contains the class file for this exercise. 
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Figure 34-28 The program allows you to choose an audio file from a dialog box and use 
the buttons to play, repeatedly play, or stop the audio. 



34-9** (Playing TicTacToe with a computer) The game in §18.9, "Case Study: TicTac- 
Toe," facilitates two players. Write a new game that enables a player to play 
against the computer. Add a File menu with two items, New Game and Exit, as 
shown in Figure 34.29. When you click New Game, it displays a dialog box. 
From this dialog box, you can decide whether to let the computer go first. 
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Figure 34-29 The new TicTacToe game enables you to play against the computer. 
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Chapter 



MVC and Swing Models 

Objectives 

■ To use the model- view-controller approach to separate 
data and logic from the presentation of data (§35.2). 

■ To implement the model-view-controller components 
using the JavaBeans event model (§35.2). 

■ To explain the Swing model-view-controller 
architecture (§35.4). 

■ To use DSpi nner to scroll the next and previous 
values (§35.5). 

■ To create custom spinner models and editors (§35.6). 

■ To use J Li st to select single or multiple items in 
a list (§35.7). 

■ To add and remove items using Li stModel and 
DefaultListModel (§35.8). 

■ To render list cells using a default or custom cell 
Tenderer (§35.9). 

■ To create custom combo box models and 
Tenderers (§35.10). 
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35.1 Introduction 

The Swing user interface components are implemented using variations of the MVC architec- 
ture. You have used simple Swing components without concern for their supporting models, 
but in order to use advanced Swing components, you have to use their models to store, access, 
and modify data. This chapter introduces the MVC architecture and Swing models. Specifi- 
cally, you will learn how to use the models in JSpinner, JList, and JComboBox. The next 
chapter will introduce JTabl e and JTree. 

35.2 MVC 

The model-view-controller (MVC) approach is a way of developing components by separat- 
ing data storage and handling from the visual representation of the data. The component for 
storing and handling data, known as a model, contains the actual contents of the component. 
The component for presenting the data, known as a view, handles all essential component be- 
haviors. It is the view that comes to mind when you think of the component. It does all the dis- 
playing of the components. The controller is a component that is usually responsible for 
obtaining data, as shown in Figure 35.1. 



model 
view 

controller 



Controller | Model | *- View 

t t t 

Obtain input Store data Display data 

Figure 35.1 The controller obtains data and stores it in a model. The view displays the data 
stored in the model. 



MVC benefits Separating a component into a model and a view has two major benefits: 

■ It makes multiple views possible so that data can be shared through the same model. 
For example, a model storing student names can be displayed simultaneously in a 
combo box and a list box. 

■ It simplifies the task of writing complex applications and makes the components 
scalable and easy to maintain. Changes can be made to the view without affecting 
the model, and vice versa. 

A model contains data, whereas a view makes the data visible. Once a view is associated with 
a model, it is synchronized with the model. This ensures that all of the model's views display 
the same data consistently. To achieve consistency and synchronization with its dependent 
views, the model should notify the views when there is a change in any of its properties that 
are used in the view. In response to a change notification, the view is responsible for redis- 
playing the viewing area affected by the property change. 

The Java event delegation model provides a superior architecture for supporting MVC com- 
ponent development. The model can be implemented as a source with appropriate event and 
event listener registration methods. The view can be implemented as a listener. Thus, if data are 
changed in the model, the view will be notified. To enable the selection of the model from the 
view, simply add the model as a property in the view with a set method. 

Let us use an example to demonstrate the development of components using the MVC ap- 
proach. The example creates a model named Ci rcl eModel , a view named Ci rcl eView, and a 
controller named CircleControl. CircleModel stores the properties (radius, filled, and 
col or) that describe a circle, f i 1 1 ed is a boolean value that indicates whether a circle is filled. 
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Ci rcl eVi ew draws a circle according to the properties of the circle. Ci rcl eControl enables the 
user to enter circle properties from a graphical user interface. Create an applet with two buttons 
named Show Controller and Show View, as shown in Figure 35.2(a). When you click the Show 
Controller button, the controller is displayed in a frame, as shown in Figure 35.2(b). When you 
click the Show View button, the view is displayed in a separate frame, as shown in Figure 35.2(c). 
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(a) (b) (c) 

Figure 35.2 The controller obtains circle properties and stores them in a circle model. The 
view displays the circle specified by the circle model. 



The circle model contains the properties radi us, f i 1 1 ed, and col or, as well as the reg- 
istration/deregistration methods for action event, as shown in Figure 35.3. date model 

When a property value is changed, the listeners are notified. The complete source code for 
Ci rcl eModel is given in Listing 35.1. 

Listing 35.1 Ci rcl eModel . java 

1 import java.awt. event.*; 

2 import java.util.*; 

3 

4 public class Ci rcl eModel { 

5 /** Property radius. */ 

6 private double radius = 20; properties 
7 

8 /** Property filled. */ 

9 private boolean filled; 
10 

11 /** Property color. */ 

12 private java.awt. Color color; 
13 

14 /** Utility field used by event firing mechanism. */ 

15 private ArrayLi st<Acti onLi stener> acti onLi stenerLi st ; 
16 

17 public double getRadiusO { 

18 return radius; 

19 } 
20 

21 public void setRadi us (double radius) { 

22 this. radius = radius; 
23 

24 // Notify the listener for the change on radius 

25 processEvent( fire event 

26 new ActionEvent(this, Acti on Event . ACTI0N_PERF0RMED , "radius")); 

27 } 
28 

29 public boolean isFilledO { 

30 return filled; 

31 } 
32 

33 public void setFi lied (boolean filled) { 

34 this. filled = filled; 
35 

36 // Notify the listener for the change on filled 
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fire event 



fire event 



standard code 



standard code 



standard code 
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processEvent( 

new ActionEvent(this, Acti on Event . ACTI0N_PERF0RMED , "filled")); 



} 



public java.awt. Color getColor() { 
return color; 

} 

public void setColor(java.awt. Color color) { 
this. color = color; 



// Notify the listener for the change on color 
processEvent( 

new Acti onEvent (this, Acti on Event . ACTI0N_PERF0RMED , "color")); 

} 

/** Register an action event listener */ 

public synchronized void addActionListener(ActionListener 1) { 
if (actionLi stenerLi st == null) 

acti onLi stenerLi st = new ArrayLi st<Acti onLi stener>() ; 

actionLi stenerLi st. add (1) ; 

} 

/** Remove an action event listener */ 

public synchronized void removeActi onLi stener(Acti onLi stener 1) { 
if (actionLi stenerLi st != null && actionListenerList.contains(l)) 
acti onLi stenerLi st . remove(l ) ; 

} 

/** Fire ActionEvent */ 

private void processEvent(ActionEvent e) { 
ArrayList list; 

synchronized (this) { 

if (acti onLi stenerLi st == null) return; 

list = (ArrayList)actionListenerList.clone() ; 

} 

for (int i = 0; i < list.size(); i++) { 

Acti onLi stener listener = (Acti onLi stener)! i st . get(i ) ; 
listener. actionPerformed(e) ; 

} 



CircleModel 



-radius: double 
-filled: boolean 
-color: java.awt. Color 



+addActionListener(l : ActionListener) : void 
+removeActionListener(l : ActionListener): void 
-processEvent(e: ActionEvent): void 



JavaBeans properties with get and set 
methods omitted in the UML diagram. 



The radius of this circle. 

True if the circle is filled. 

The color of the circle. 

Adds a new listener to this object. 

Removes a listener from this object. 

Processes the event. 



Figure 35.3 The circle model stores the data and notifies the listeners if the data change. 
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§ Note 

The registration/deregistration/processEvent methods (lines 54-80) are the same as in lines 
49-82 in Listing 32.2, CourseWithActionEvent.java. If you use a GUI builder tool such as Net- 
Beans and Eclipse, the code can be generated automatically. 

The view implements ActionListener to listen for notifications from the model. It con- view 
tains the model as its property. When a model is set in the view, the view is registered with the 
model. The view extends JPanel and overrides the pai ntComponent method to draw the 
circle according to the property values specified in the model. The UML diagram for 
Ci rcl eView is shown in Figure 35.4 and its source code is given in Listing 35.2. 



3 Panel 




ActionListener 



Circle View 



-model: CircleModel 



+actionPerformed(e: ActionEvent) : void 
#pai ntComponent(g : Graphics): void 



JavaBeans properties with get and set 
methods omitted in the UML diagram. 



Stores the circle model. 

Implements this method to update the view. 
Paints the view. 



Figure 35.4 The view displays the circle according to the model. 



Listing 35.2 Ci rcleView. java 

1 import java.awt.*; 

2 import java.awt. event.*; 
3 

4 public class Ci rcleView extends javax . swi ng .] Panel 

5 implements ActionListener { 

6 private CircleModel model; model 
7 

8 public void actionPerformed(ActionEvent actionEvent) { 

9 repaintO; 
10 } 

11 

12 /** Set a model */ 

13 public void setModel (Ci rcl eModel newModel) { set model 

14 model = newModel ; 
15 

16 if (model != null) 

17 // Register the view as listener for the model 

18 model . addActionLi stener(this) ; 
19 

20 repaintO; 

21 } 
22 

23 public CircleModel getModel () { 

24 return model ; 

25 } 
26 

27 public void pai ntComponent(Graphi cs g) { paint view 

28 super . pai ntComponent(g) ; 
29 

30 if (model == null) return; 

31 

32 g . setColor(model . getCol or()) ; 
33 
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34 int xCenter = getWidthO / 2; 

35 int yCenter = getHeightO / 2; 

36 int radius = (int)model .getRadiusO ; 
37 

38 if (model .isFinedO) { 

39 g . f i llOval (xCenter - radius, yCenter - radius, 

40 2 * radius, 2 * radius); 

41 } 

42 else { 

43 g . drawOval (xCenter - radius, yCenter - radius, 

44 2 * radius, 2 * radius); 

45 } 

46 } 

47 } 



The controller presents a GUI interface that enables the user to enter circle properties 
radius, filled, and color. It contains the model as its property. You can use the 
setModel method to associate a circle model with the controller. It uses a text field to obtain 
a new radius and a combo box to obtain a bool ean value to specify whether the circle is 
filled. The source code for Ci rcl eControl 1 er is given in Listing 35.3. 



Listing 35.3 Ci rcl eControl ler.java 



model 



create UI 



1 
2 
3 
4 
5 
6 
7 
8 
9 
10 
11 
12 
13 
14 
15 
16 
17 
18 
19 
20 
21 
22 
23 
24 
25 
26 
27 
28 
29 
30 
31 
32 
33 
34 
35 
36 



import java. awt . event .* ; 
import java. awt.'-; 
import javax. swi ng . * ; 

public class Ci rcl eControl 1 er extends DPanel { 
private CircleModel model; 

private JTextField jtfRadius = new JTextFi el d() ; 
private JComboBox jcboFilled = new JComboBox(new Boolean[]{ 
new Bool ean (fal se) , new Bool ean (true) }) ; 

/** Creates new form Ci rcl eControl 1 er */ 
public Ci rcleController() { 

// Panel to group labels 

J Panel panel 1 = new JPanelO; 

panell.setLayout(new GridLayout(2 , 1)); 

panel 1. add (new JLabel ("Radius")) ; 

panel 1. add (new JLabel ("Filled")) ; 

// Panel to group text field, combo box, and another panel 

JPanel panel2 = new JPanelO; 

panel 2 . setLayout(new GridLayout(2 , 1)); 

panel 2 . add(jtf Radi us) ; 

panel 2 . add(jcboFi 1 1 ed) ; 

setLayout(new BorderLayoutO) ; 
add(panell, BorderLayout .WEST) ; 
add(panel2 , BorderLayout. CENTER) ; 

// Register listeners 

jtf Radi us . addActi onLi stener(new Acti onLi stener() { 
public void actionPerformed(ActionEvent e) { 

if (model == null) return; // No model associated yet. 
model . setRadi us (new 

Double(jtfRadius.getTextO) . doubl eVal ue()) ; 

} 

}); 
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37 jcboFilled.addActionListener(new ActionLi stenerO { 

38 public void actionPerformed(ActionEvent e) { 

39 if (model == null) return; 

40 model .setFi lied ( 

41 ((Boolean)jcboFilled.getSelectedltemO) . bool eanVal ue()) ; 

42 } 

43 }); 

44 } 
45 

46 public void setModel (Ci rcl eModel newModel) { 

47 model = newModel; set model 

48 } 
49 

50 public Ci rcl eModel getModel () { 

51 return model ; 

52 } 



53 } 

Finally, let us create an applet named MVCDemo with two buttons, Show Controller and Show 
View. The Show Controller button displays a controller in a frame, and the Show View button 
displays a view in a separate frame. The program is shown in Listing 35.4. 

Listing 35.4 MVCDemo . j ava 

1 import java.awt.*; 

2 import java.awt. event.*; 

3 import javax. swi ng . * ; 
4 

5 public class MVCDemo extends 1 Applet { 



6 private JButton jbtController = new JButton("Show Controller"); 

7 private JButton jbtView = new 1 Button ("Show View"); 

8 private Ci rcl eModel model = new Ci rcl eModel () ; create model 
9 

10 public MVCDemo () { 

11 setLayout(new FlowLayoutO) ; create UI 

12 add(jbtController) ; 

13 add(jbtView) ; 
14 

15 jbtController. addActionLi stener(new ActionLi stenerO { 

16 public void actionPerformed(ActionEvent e) { 

17 JFrame frame = new JFrame("Controller") ; 

18 Ci rcl eControll er controller = new Ci rcl eControl 1 er() ; 

19 cont roll er . setModel (model ) ; set model 

20 frame. add(controller) ; 

21 frame. setSize(200, 200); 

22 frame.setLocation(200, 200); 

23 frame . setVi si bl e(true) ; 

24 } 

25 }); 
26 

27 jbtView.addActionListener(new ActionLi stenerO { 

28 public void actionPerformed(ActionEvent e) { 

29 JFrame frame = new JFrame("View") ; 

30 CircleView view = new Ci rcl eVi ew() ; 

31 vi ew. setModel (model ) ; set model 

32 frame. add (view) ; 

33 frame. setSize(500, 200); 

34 frame. setLocati on (200, 200); 

35 frame . setVi si bl e(true) ; 
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36 } 

37 }); 

38 } 

main method omitted 39 } 

The model stores and handles data, and the views are responsible for presenting data. The 
fundamental issue in the model-view approach is to ensure consistency between the views and 
the model. Any change in the model should be notified to the dependent views, and all the 
views should display the same data consistently. The data in the model is changed through the 
controller. 

The methods setRadius, setFilled, and setColor (lines 21, 33, 45) in 
Ci rcl eModel invoke the processEvent method to notify the listeners of any change in the 
properties. 

The setModel method in Ci rcl eView sets a new model and registers the view with the 
model by invoking the model's addActionListener method (line 18). When the data in the 
model are changed, the view's actionPerformed method is invoked to repaint the circle 
(line 9). 

The controller Ci rcl eControl 1 er presents a GUI. You can enter the radius from the ra- 
dius text field. You can specify whether the circle is filled from the combo box that contains 
two Boolean objects, new Boolean(fal se) and new Boolean (true) (lines 8-9). 

In MVCDemo, every time you click the Show Controller button, a new controller is created 
(line 18). Every time you click the Show View button, a new view is created (line 30). The 
controller and view share the same model. 

35.3 MVC Variations 

A variation of the model-view-controller architecture combines the controller with the view. 
In this case, a view not only presents the data, but is also used as an interface to interact with 
the user and accept user input, as shown in Figure 35.5. 



Model 




View 
(Controller) 




-< - 



Controller is part of 
the view 



Model may be 
modified via view 

Figure 35.5 The view can interact with the user as well as displaying data. 

For example, you can modify the view in the preceding example to enable the user to 
change the circle's radius using the mouse. When the left mouse button is clicked, the radius 
is increased by 5 pixels. When the right mouse button is clicked, the radius is decreased by 5 
pixels. The new view, named ViewController, can be implemented by extending 
Ci rcl eView, as follows: 

1 public class ViewController extends CircleView { 

2 public Vi ewControl 1 er() { 

3 // Register mouse listener 

4 addMouseLi stener(new java.awt. event. MouseAdapterO { 

5 public void mousePressed(java.awt. event. MouseEvent e) { 

6 Ci rcl eModel model = getModel () ; // Get model 
7 

8 if (model == null) return; 

9 

10 if (e.isMetaDownO) 

11 model .setRadius (model .getRadi us () - 5); // Right button 



mouse listener 



right button? 
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12 el se 

13 model .setRadi us (model .getRadi us () +5); // Left button 

14 } 

15 }); 

16 } 

17 } 

Another variation of the model-view-controller architecture adds some of the data from the 
model to the view so that frequently used data can be accessed directly from the view. Swing 
components are designed using the MVC architecture. Each Swing GUI component is a view 
that uses a model to store data. A Swing GUI component contains some data in the model, so 
that it can be accessed directly from the component. 



35.4 Swing Model-View-Controller Architecture 

Every Swing user interface component (except some containers and dialog boxes, such as 
JPanel, JSpl itPane, JFileChooser, and JColorChooser) has a property named model 
that refers to its data model. The data model is defined in an interface whose name ends with 
Model . For example, the model for button component is ButtonModel . Most model inter- 
faces have a default implementation class, commonly named Defaul tX, where X is its model 
interface name. For example, the default implementation class for ButtonModel is 
Defaul tButtonModel . The relationship of a Swing component, its model interface, and its 
default model implementation class is illustrated in Figure 35.6. 



Generic Swing Component 



Each Swing component 
contains the model property 



Generic Model Interface j 
Default Model Class 



Implements the model 
interface 



j a vax.s wing. JButton 



+model : ButtonModel 
+actionCommand: String 
+mnemonic: String 

other properties omitted 



«interface» 
javax.swing.ButtonModel 



+actionCommand: String 
+mnemonic: String 

other properties omitted 



j avax . swi ng . Defaul tButtonModel 



(a) Generic Swing model-view architecture 



(b) JButton model-view implementation 



Figure 35.6 Swing components are implemented using the MVC architecture. 



For convenience, most Swing components contain some properties of their models, and 
these properties can be accessed and modified directly from the component without the exis- 
tence of the model being known. For example, the properties actionCommand and 
mnemonic are defined in both ButtonModel and JButton. Actually, these properties are in 
the AbstractButton class. Since JButton is a subclass of AbstractButton, it inherits 
all the properties from AbstractButton. 

When you create a Swing component without specifying a model, a default data model is 
assigned to the model property. For example, lines 9-10 in the following code set the 
actionCommand and mnemonic properties of a button through its model. 

1 public class TestSwi ngModel 1 { 

2 public static void main(String[] args) { 

3 javax. swing. JButton jbt = new j avax. swing. JButton () ; 
4 

5 // Obtain the default model from the component 

6 javax.swing.ButtonModel model = jbt.getModel () ; get model 
7 

8 // Set properties in the model 

9 model . setActi onCommand ("OK") ; set model properties 
10 model .setMnemonic('O') ; 

11 
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12 // Display the property values from the component 

13 System. out. pri ntl n("actionCommand is " + jbt.getActionCommandO) ; 

14 System. out. pri ntl n("mnemonic is " + (char) (jbt . getMnemoni c())) ; 

15 } 

16 } 




acti onCommand is OK 
mnemonic is 



create model 



set model properties 



set a new model 



You can also create a new model and assign it to a Swing component. For example, the fol- 
lowing code creates an instance of ButtonModel (line 7) and assigns it to an instance of 
JButton (line 14). 
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public class TestSwi ngModel 2 { 

public static void main(String[] args) { 

javax. swing. JButton jbt = new j avax. swing. 3 Button () ; 

// Create a new button model 
javax. swing. ButtonModel model = 

new javax. swi ng . DefaultButtonModel () ; 

// Set properties in the model 
model . setActi onCommand ("Cancel ") ; 

model .setMnemonic('C') ; 

// Assign the model to the button 
j bt . setModel (model ) ; 

// Display the property values from the component 

System. out. pri ntl n("actionCommand is " + jbt.getActionCommandO); 

System. out. pri ntl n("mnemonic is " + (char) jbt. getMnemonicQ) ; 




acti onCommand is Cancel 
mnemonic is C 



It is unnecessary to use the models for simple Swing components, such as JButton, 
JToggleButton, JCheckBox, JRadioButton, JTextField, and JTextArea, because 
the frequently used properties in the models of these Swing components are also the proper- 
ties in these components. You can access and modify these properties directly through the 
components. For advanced components, such as JSpinner, JList, JComboBox, JTable, 
and JTree, you have to work with their models to store, access, and modify data. 

35.5 JSpinner 

A spinner is a text field with a pair of tiny arrow buttons on its right side that enable the user to 
select numbers, dates, or values from an ordered sequence, as shown in Figure 35.7. The key- 
board up/down arrow keys also cycle through the elements. The user may also be allowed to 
type a (legal) value directly into the spinner. A spinner is similar to a combo box but is some- 
times preferred because it doesn't require a drop-down list that can obscure important data. 
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Figure 35.7 Two JSpi nner components enable the user to select a month and a year for 
the calendar. 



Figure 35.8 shows the constructors and commonly used methods in JSpi nner. A 
JSpi nner 's sequence value is defined by the SpinnerModel interface, which manages a po- 
tentially unbounded sequence of elements. The model doesn't support indexed random access 
to sequence elements. Only three sequence elements are accessible at a time — current, next, 
and previous — using the methods getValueO, getNextVal ue(), and getPrevious- 
ValueO, respectively. The current sequence element can be modified using the setValue 
method. When the current value in a spinner is changed, the model invokes the 
stateChanged (javax. swing . event .ChangeE vent e) method of the registered listen- 
ers. The listeners must implement javax . swing . event . ChangeLi stener. All these 
methods in Spi nnerModel are also defined in JSpi nner for convenience, so you can access 
the data in the model from JSpi nner directly. 



JavaBeans properties with get and set 
methods omitted in the UML diagram. 



javax.swing.JSpinner 



-model: SpinnerModel 
-edi tor : JComponent 



+ JSpi nner() 

+JSpi nner(model : SpinnerModel) 

+getNextVal ue() : Object 

+getPreviousValue() : Object 

+getValue(): Object 

+setVal ue(val ue : Object): void 

+addChangel_i stener(l : ChangeLi stener) : void 

+removeChangel_i stener(l : ChangeLi stener) : void 



javax. swing. Spi nnerModel 



Specifies a model with get/set methods. 
Specifies an editor with get/set methods. 

Constructs a JSpi nner with a Spi nnerNumberModel with 

initial value and no minimum or maximum limits. 
Constructs a JSpi nner with a specified Spi nnerModel . 
Gets the next element value in this JSpi nner. 
Gets the previous element value in this JSpi nner. 
Gets the current element value in this J Spi nner. 
Sets the current element value. 
Adds a listener for value change. 
Removes a listener. 



Figure 35.8 JSpi nner uses a spinner model to store data. 



^$ Note 

[f you create a JSpi nner object without specifying a model, the spinner displays a sequence 
of integers. 

Listing 35.5 gives an example that creates a JSpi nner object for a sequence of numbers and 
displays the previous, current, and next numbers from the spinner on a label, as shown in 
Figure 35.9. 
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Listing 35.5 SimpleSpinner . java 



spinner 



spinner listener 



main method omitted 



1 
2 
3 
4 
5 
6 
7 
8 
9 
10 
11 
12 
13 
14 
15 
16 
17 
18 
19 
20 
21 
22 
23 
24 
25 
26 



import javax. swi ng . * ; 
import javax. swi ng . event .* ; 
import java.awt.BorderLayout; 

public class SimpleSpinner extends JApplet { 

// Create a JSpinner 

private JSpinner spinner = new JSpinnerO; 

// Create a JLabel 

private JLabel label = new DLabel("", 3 Label .CENTER) ; 

public SimpleSpinnerO { 

// Add spinner and label to the UI 
add(spinner, BorderLayout . NORTH) ; 
add (label, BorderLayout . CENTER) ; 

// Register and create a listener 

spinner. addChangeLi stener(new ChangeLi stener() { 

public void stateChanged(javax. swing. event. ChangeEvent e) { 
label . setText("Previous value: " + spinner. getPreviousValue() 
+ " Current value: " + spi nner . getVal ue() 
+ " Next value: " + spi nner . getNextVal ue() ) ; 

} 

}); 




Figure 35.9 The previous, current, and next values in the spinner are displayed on the label. 



A JSpi nner object is created using its no-arg constructor (line 7). By default, a spinner dis- 
plays a sequence of integers. 

An anonymous inner class event adapter is created to process the value change event on the 
spinner (lines 18-24). The previous, current, and next values in a spinner can be obtained 
using the JSpinner's instance methods getPreviousVal ue(), getValueO, and 
getNextVal ue(). 

To display a sequence of values other than integers, you have to use spinner models. 



35.6 Spinner Models and Editors 

SpinnerModel is an interface for all spinner models. AbstractSpinnerModel is a conve- 
nient abstract class that implements SpinnerModel and provides the implementation for its 
registration/deregistration methods. SpinnerListModel, SpinnerNumberModel, and 
SpinnerDateModel are concrete implementations of SpinnerModel. The relationship 
among them is illustrated in Figure 35.10. Besides these models, you can create a custom 
spinner model that extends AbstractSpinnerModel or directly implements 
SpinnerModel . 
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— Spi nnerLi stModel | 



«interface» 
javax.swing.SpinnerModel 



^ ■ AbstractSpinnerModel 



+getPreviousVal ue() : Object 

+getNextVal ue() : Object 

+getValue() : Object 

+setValue(value: Object): void 

+addChangeLi stener(l : ChangeLi stener) : void 

+removeChangeLi stener(l : ChangeLi stener) : void 



Gets the previous element value. 
Gets the next element value. 
Gets the current element value. 
Sets the current element value. 
Adds a listener for value change. 
Removes a listener. 



Spi nnerNumberModel | 
— Spi nnerDateModel | 



Figure 35.10 Spi nnerLi stModel, Spi nnerNumberModel, and Spi nnerDateModel are concrete implementations 
for Spi nnerModel . 



35.6.1 Spi nnerLi stModel 

Spi nnerLi stModel (see Figure 35.11) is a simple implementation of Spi nnerModel 
whose values are stored in a java. util . List. 



«i interface* 
javax. swi ng . Spi nnerModel 

^ 



javax. swing. AbstractSpinnerModel 



javax.swing.SpinnerListModel 



JavaBeans properties with get and set 
methods omitted in the UML diagram. 



-list: java. util .List 




Stores data in a list. 


+Spi nnerLi stModel () 

+Spi nnerLi stModel (val ues : 

+Spi nnerLi stModel (val ues : 


List) 
Object []) 


Constructs a Spi nnerLi stModel that contains "empty" string elements. 
Constructs a Spi nnerLi stModel with the specified list. 
Constructs a Spi nnerLi stModel with the specified array. 



Figure 35.11 Spi nnerLi stModel uses a java. util . List to store a sequence of data in the model. 



You can create a Spi nnerLi stModel using an array or a list. For example, the following 
code creates a model that consists of values Freshman, Sophomore, Junior, Senior, and Grad- 
uate in an array. 

// Create an array 

String [] grades = {"Freshman", "Sophomore", "Junior", 
"Senior", "Graduate"}; 

// Create a model from an array 
model = new Spi nnerLi stModel (grades) ; 

Alternatively, the following code creates a model using a list: 

// Create an array 

String [] grades = {"Freshman", "Sophomore", "Junior", 
"Senior", "Graduate"}; 

// Create an ArrayList from the array 

list = new ArrayLi st(Arrays . asLi st(grades) ) ; 

// Create a model from the list 
model = new Spi nnerLi stModel (1 i st) ; 
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The alternative code seems unnecessary. However, it is useful if you need to add or remove 
elements from the model. The size of the array is fixed once the array is created. The list is a 
flexible data structure that enables you to add or remove elements dynamically. 

35.6.2 Spi nnerNumberModel 

SpinnerNumberModel (see Figure 35.12) is a concrete implementation of SpinnerModel 
that represents a sequence of numbers. It contains the properties maximum, minimum, and 
stepSi ze. The maxi mum and mi ni mum properties specify the upper and lower bounds of the 
sequence. The stepSize specifies the size of the increase or decrease computed by the 
nextValue and previousVal ue methods defined in SpinnerModel. The minimum and 
maximum properties can be nul 1 to indicate that the sequence has no lower or upper limit. All 
of the properties in this class are defined as Number or Comparable, so that all Java numeric 
types may be accommodated. 



«i nterface» 
j avax . swi ng . Spi nnerModel 



javax. swing. AbstractSpi nnerModel 



javax.swing.SpinnerNumberModel 



-maximum: java.lang. Comparable 
-minimum: java.lang. Comparable 
-stepSize: java.lang. Number 
-value: java.lang. Number 



+Spi nnerNumberModel () 

+Spi nnerNumberModel (value: int, minimum: int, 
maximum: int, stepSize: int) 

+Spi nnerNumberModel (value: double, minimum: double, 
maximum: double, stepSize: double) 

+Spi nnerNumberModel (value: Number, minimum: 

Comparable, maximum: Comparable, stepSize: Number) 



JavaBeans properties with get and set 
methods omitted in the UML diagram. 



Specifies the upper bound of the sequence with get/set methods. 
Specifies the lower bound of the sequence with get/set methods. 
Specifies the interval in the sequence with get/set methods. 
Holds the current selected value with get/set methods. 

Constructs an unbounded Spi nnerNumberModel with an initial value 
of zero and StepSi ze equal to one. 

Constructs a Spi nnerNumberModel with the specified initial value, 
minimum/maximum bounds, and StepSi ze in int. 

Constructs a Spi nnerNumberModel with the specified initial value, 
minimum/maximum bounds, and StepSi ze in double. 

Constructs a Spi nnerNumberModel that represents a closed sequence 
of numbers from minimum to maximum. 



Figure 35.12 SpinnerNumberModel represents a sequence of numbers. 



You can create a SpinnerNumberModel with integers or double. For example, the fol- 
lowing code creates a model that represents a sequence of numbers from to 3000 with initial 
value 2004 and interval 1. 

// Create a spinner number model 

SpinnerNumberModel model = new SpinnerNumberModel (2004, 0, 3000, 1); 

The following code creates a model that represents a sequence of numbers from to 120 with 
initial value 50 and interval 0.1. 

// Create a spinner number model 

SpinnerNumberModel model = new SpinnerNumberModel (50, 0, 120, 0.1); 
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35.6.3 SpinnerDateModel 

SpinnerDateModel (see Figure 35.13) is a concrete implementation of SpinnerModel that 
represents a sequence of dates. The upper and lower bounds of the sequence are defined by 
properties called start and end, and the size of the increase or decrease computed by the 
nextValue and previousValue methods is defined by a property called cal endarFiel d. 
The start and end properties can be nul 1 to indicate that the sequence has no lower or upper 
limit. The value of the calendarField property must be one of the java.util .Calendar 
constants that specify a field within a Cal endar. The getNextVal ue and getPreviousVal ue 
methods change the date forward or backward by this amount. For example, if 
calendarField is Calendar . DAY_OF_WEEK, then nextValue produces a date that is 24 
hours after the current value, and previousVal ue produces a date that is 24 hours earlier. 



«i nterface» 
javax. swing. Spi nnerModel 

^ 



javax . swi ng .AbstractSpi nnerModel 



javax.swing.Spinnei'DateModel 


-start: java. Tang. Comparable 




-end: java . 1 ang . Comparabl e 




-calendarField: int 




-val ue : j ava . uti 1 . Cal endar 




+Spi nnerDateModel () 

+SpinnerDateModel (value: Date, start: 
end: Comparable, calendarField: 


Comparable, 
int) 



JavaBeans properties with get and set 
methods omitted in the UML diagram. 



Specifies the start date (upper bound) in the model with get/set methods. 
Specifies the end date (lower bound) in the model with get/set methods. 
Specifies the calendar field (interval) in the sequence with get/set methods. 
Holds the current selected date with get/set methods. 

Constructs an unbounded Spi nnerDateModel whose initial value is the 
current date, cal endarFi el d is equal to Cal endar . DAY_OF_MONTH. 

Constructs a Spi nnerNumberModel with the specified initial date, start/end 
bounds, and cal endarFi el d. 



Figure 35.13 SpinnerDateModel represents a sequence of dates. 

For example, the following code creates a spinner model that represents a sequence of dates, 
starting from the current date without a lower/upper limit and with calendar field on month. 

SpinnerDateModel model = new Spi nnerDateModel (new DateO, null, null, 
Cal endar. MONTH) ; 

35.6.4 Spinner Editors 

A JSpinner has a single child component, called the editor, which is responsible for dis- 
playing the current element or value of the model. Four editors are defined as static inner 
classes inside JSpinner. 

■ JSpi nner . Def aul tEdi tor is a simple base class for all other specialized editors 
to display a read-only view of the model's current value with a JFormatted- 
TextField. JFormattedTextField extends JTextField, adding support for 
formatting arbitrary values, as well as retrieving a particular object once the user has 
edited the text. 

■ JSpinner . NumberEdi tor is a specialized editor for a JSpinner whose 

model is a Spi nnerNumberModel . The value of the editor is displayed with a 
JFormattedTextFiel d whose format is defined by a NumberFormatter instance. 

■ JSpinner .DateEdi tor is a specialized editor for a JSpinner whose model is a 
SpinnerDateModel. The value of the editor is displayed with a JFormatted- 
TextFiel d whose format is defined by a DateFormatter instance. 
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■ JSpinner. ListEditor is a specialized editor for a JSpinner whose model is a 
SpinnerListModel. The value of the editor is displayed with a JFormatted- 
TextField. 

The JSpinner 's constructor creates a Number Editor for SpinnerNumberModel, a 
DateEditor for SpinnerDateModel, a ListEditor for SpinnerListModel, and a 
Defaul tEditor for all other models. The editor can also be changed using the setEditor 
method. The JSpinner's editor stays in sync with the model by listening for ChangeEvents. 
The commi tEdi t () method should be used to commit the currently edited value to the model. 

35.6.5 Example: Using Spinner Models and Editors 

This example uses a JSpinner component to display the date and three other JSpinner 
components to display the day in a sequence of numbers, the month in a sequence of 
strings, and the year in a sequence of numbers, as shown in Figure 35.14. All four compo- 
nents are synchronized. For example, if you change the year in the spinner for year, the date 
value in the date spinner is updated accordingly. The source code of the example is given in 
Listing 35.6. 
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Apr D2, 2U1U 




Day 


: 




Munll 






Year 


2010 





Figure 35.14 The four spinner components are synchronized to display the date in one 
field and the day, month, and year in three separate fields. 



Listing 35.6 SpinnerModelEditorDemo. java 



spinners 



create UI 



1 
2 
3 
4 
5 
6 
7 
8 
9 
10 
11 
12 
13 
14 
15 
16 
17 
18 
19 
20 
21 
22 
23 
24 
25 
26 
27 



import 
import 
import 
import 
import 



javax. swi ng 
javax. swi ng 
java.util .*: 
java. text.* 
j ava . awt . * ; 



event . ' 



public class SpinnerModelEditorDemo extends DApplet { 
// Create four spinners for date, day, month, and year 
private JSpinner jspDate = 

new JSpinner(new Spi nnerDateModel ()) ; 
private JSpinner jspDay = 

new JSpinner(new Spi nnerNumberModel (1 , 1, 31, 1)); 
private String[] monthNames = new DateFormatSymbol s() .getMonthsO ; 
private JSpinner jspMonth = new JSpinner 

(new Spi nnerLi stModel (Arrays . as Li st (monthNames) . subLi st(0 , 12)) ) ; 
private JSpinner spinnerYear = 

new JSpinner(new Spi nnerNumberModel (2004, 1, 3000, 1)); 



public Spi nnerModel Edi torDemo() { 
// Croup labels 
JPanel panel 1 = new JPanel (); 
panel 1. set Layout (new GridLayout(4 , 
panel 1. add (new JLabel ("Date")) ; 
panel 1. add (new JLabel ("Day")) ; 
panel 1 . add (new 3 Label ("Month") ) ; 
panel 1 . add (new 3 Label ("Year")) ; 



D); 
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28 // Croup spinners 

29 JPanel panel2 = new JPanelO; 

30 panel 2 . setLayout(new GridLayout(4, 1)); 

31 panel 2 .add(jspDate) ; 

32 panel 2 .add(jspDay) ; 

33 panel2 .add(jspMonth) ; 

34 panel 2 . add(spi nnerYear) ; 
35 

36 // Add spinner and label to the UI 

37 add(panell, BorderLayout .WEST) ; 

38 add(panel2, BorderLayout . CENTER) ; 
39 

40 // Set editor for date 

41 JSpi nner . DateEdi tor dateEditor = date editor 

42 new JSpinner.DateEditor(jspDate, "MMM dd, yyyy") ; 

43 jspDate.setEditor(dateEditor) ; 
44 

45 // Set editor for year 

46 J Spi nner . NumberEdi tor yearEditor = number editor 

47 new JSpinner.NumberEditor(spinnerYear, "####"); 

48 spi nnerYear . setEdi tor (year Edi tor) ; 
49 

50 // Update date to synchronize with the day, month, and year 

51 updateDateO ; 
52 

53 // Register and create a listener for jspDay 

54 jspDay.addChangeListener(new ChangeLi stener() { spinner listener 

55 public void stateChanged(javax. swing. event. ChangeEvent e) { 

56 updateDateO; 

57 } 

58 }); 
59 

60 // Register and create a listener for jspMonth 

61 jspMonth.addChangeListener(new ChangeLi stenerO { spinner listener 

62 public void stateChanged(javax. swing. event. ChangeEvent e) { 

63 updateDateO; 

64 } 

65 }); 
66 

67 // Register and create a listener for spi nnerYear 

68 spi nnerYear . addChangeLi stener(new ChangeLi stenerO { spinner listener 

69 public void stateChanged(javax. swing. event. ChangeEvent e) { 

70 updateDateO; 

71 } 

72 }); 



73 } 
74 

75 /** Update date spinner to synchronize with the other spinners */ 

76 private void updateDateO { 



77 // Get current month and year in int 

78 int month = ((SpinnerListModel)jspMonth.getModel () ) . 

79 getList() .indexOf(jspMonth.getValue() ) ; 

80 int year = ((Integer) spi nnerYear . getVal ue() ). i ntVal ue() ; 
81 

82 // Set a new maximum number of days for the new month and year 

83 Spi nnerNumberModel numberModel = 

84 (SpinnerNumberModel)jspDay.getModel () ; 

85 numberModel . setMaximum (new Integer(maxDaysInMonth(year, month))); 
86 
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87 // Set a new current day if it exceeds the maximum 

88 if (((Integer) (numberModel . getVal ue() )) .intValue() > 

89 maxDaysInMonth(year, month)) 

90 numberModel .setValue (new Integer(maxDaysInMonth(year, month))); 
91 

92 // Get the current day 

93 int day = ((Integer) jspDay.getValueO) .intValue() ; 
94 

95 // Set a new date in the date spinner 

96 j spDate . setVal ue( 

97 new Gregori anCal endar(year , month, day) .getTimeO) ; 

98 } 
99 

100 /** Return the maximum number of days in a month. For example, 

101 Feb 2004 has 29 days. */ 

102 private int maxDaysInMonth(int year, int month) { 

103 Calendar calendar = new Gregori anCal endar(year , month, 1); 

104 return calendar.getActualMaximum(Calendar.DAY_OF_MONTH) ; 

105 } 

main method omitted 106 } 



A JSpi nner object for dates, j spDate, is created with a default Spi nnerDateModel (lines 
9-10). The format of the date displayed in the spinner is MMM dd, yyyy (e.g., Feb 01, 2006). 
This format is created using the JSpinner's inner class constructor DateEditor (lines 
41^12) and is set as jspDate's editor (line 43). 

A JSpi nner object for days, j spDay, is created with a Spi nnerNumberModel with a se- 
quence of integers between 1 and 3 1 in which the initial value is 1 and the interval is 1 (lines 
11-12). The maximum number is reset in the updateDateO method based on the current 
month and year (lines 88-90). For example, February 2004 has 29 days, so the maximum in 
j spDay is set to 29 for February 2004. 

A JSpinner object for months, jspMonth, is created with a SpinnerListModel with a 
list of month names (lines 14-15). Month names are locale specific and can be obtained using 
the new DateFormatSymbol s() .getMonthsO (line 13). Some calendars can have 13 
months. Arrays.asList(monthNames) creates a list from an array of strings, and 
subLi st (0 , 12) returns the first 12 elements in the list. 

A JSpinner object for years, spinnerYear, is created with a Spi nnerNumberModel 
with a sequence of integers between 1 and 3000 in which the initial value is 2004 and the in- 
terval is 1 (lines 16-17). By default, locale-specific number separators are used. For example, 
2004 would be displayed as 2,004 in the spinner. To display the number without separators, 
the number pattern #### is specified to construct a new NumberEditor for spinnerYear 
(lines 46^17). The editor is set as spinnerYear's editor (line 48). 

The updateDateO method synchronizes the date spinner with the day, month, and year 
spinners. Whenever a new value is selected in the day, month, or year spinner, a new date is 
set in the date spinner. The maxDaysInMonth method (lines 102-105) returns the maximum 
number of days in a month. For example, February 2004 has 29 days. 

A JSpinner object can fire javax. swing. event . ChangeEvent to notify the listeners 
of the state change in the spinner. The anonymous event adapters are created to process spin- 
ner state changes for the day, month, and year spinners (lines 54-73). Whenever a new value 
is selected in one of these three spinners, the date spinner value is updated accordingly. In Ex- 
ercise 35.3, you will improve the example to synchronize the day, month, and year spinners 
with the date spinner. Then, when a new value is selected in the date spinner, the values in the 
day, month, and year spinners will be updated accordingly. 

This example uses Spi nnerNumberModel , Spi nnerDateModel , and SpinnerList- 
Model . They are predefined concrete spinner models in the API. You can also create custom 
spinner models (see Exercise 35.4). 
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35.7 JList and Its Models 

The basic features of JLi st were introduced in § 17.9, "Lists," without using list models. You 
learned how to create a list and how to respond to list selections. However, you cannot add or 
remove elements from a list without using list models. This section introduces list models and 
gives a detailed discussion on how to use JList. 

JList has two supporting models: a list model and a list-selection model. The list model 
is for storing and processing data. The list-selection model is for selecting items. By default, 
items are rendered as strings or icons. You can also define a custom Tenderer that implements 
the ListCellRenderer interface. The relationship of these interfaces and classes is shown 
in Figure 35.15. 



javax.swing.JList 



-model : Li stModel 

-selecti onMode: int 

-selecti onModel : ListSelectionModel 

-cellRenderer: ListCellRenderer 



ty— ListModel | ^— - AbstractLi stModel | ^ DefaultListModel | 

6— ListSelectionModel | ^""' DefaultListSelectionModel | 
^— ListCellRenderer DefaultListCellRenderer | 



Figure 35.15 JLi st contains several supporting interfaces and classes. 



35.7.1 JList Constructors, Properties, and Methods 

Figure 35.16 shows the properties and constructors of JList. You can create a list from a list 
model, an array of objects, or a vector. 



JavaBeans properties with get and set 
methods omitted in the UML diagram. 



javax.swing.JList 



-cellRenderer: ListCellRenderer r 
-fixedCell Height: int 
-fixedCell Width: int 
-layoutOrientation: int 
-model : Li stModel 
-selectedlndex: int 
-selectedlndices : int[] 
-selectedVal ue: Object 
-selectedValues: 0bject[] 
-selectedBackground: int 
-selectedForeground: int 
-selectionMode: int 
-selectionModel : ListSelectionModel 
-vi si bl eRowCount : int 



^1 — javax. swing. Li stModel | 



+JList() 

+JList(dataModel : ListModel) 
+JList(listData: 0bject[]) 
+JList(listData: Vector) 
+setListData(listData: 0bject[]): void 
+setListData(listData: Vector): void 



The object that renders the list items. 

The fixed cell height value in pixels. 

The fixed cell width value. 

Defines the way list cells are laid out. 

Specifies the list model for this list. 

The index of the first selected item in this list. 

An array of all of the selected indices in increasing order. 

The first selected value. 

An array of the values for the selected values in increasing index order. 
The background color of the selected items. 
The foreground color of the selected items. 

Specifies whether single- or multiple -interval selections are allowed. 
Specifies a selection model. 

The preferred number of rows to display without using a scroll bar 
(default: 8). 

Constructs an empty D Li St. 

Constructs a J Li st with the specified model. 

Constructs a J Li st with the data specified in the array. 

Constructs a J Li st with the data specified in the vector. 

Sets an array of objects as data for the list. 

Sets a vector of objects as data for the list. 



Figure 35.16 JList displays elements in a list. 
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35.7.2 List Layout Orientations 

The 1 ayoutOrientation property specifies the layout of the items using one of the follow- 
ing three values: 

■ J Li st . VERTICAL specifies that the cells should be laid out vertically in one column. 
This is the default value. 

■ JList.H0RIZ0NTAL_WRAP specifies that the cells should be laid out horizontally, 
wrapping to a new row as necessary. The number of rows to use is determined by the 
visibleRowCount property if its value is greater than 0; otherwise the number of 
rows is determined by the width of the J List. 

■ JList.VERTICAL_WRAP specifies that the cells should be laid out vertically, wrap- 
ping to a new column as necessary. The number of rows to use is determined by the 
visibleRowCount property if its value is greater than 0; otherwise the number of 
rows is determined by the height of the DLi st. 

For example, suppose there are five elements (iteml, item2, item3, item4, and item5) in the 
list and the visibl eRowCount is 2. Figure 35.17 shows the layout in these three cases. 
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(c) Horizontal wrap 

Figure 35.1 7 Layout orientation specifies how elements are laid out in a list. 

35.7.3 List-Selection Modes and List-Selection Models 

The selectionMode property is one of the three values (SINGLE_SELECTION, 
SINGLE_INTERVAL_SELECTION, MULTIPLE_INTERVAL_SELECTION) that indicate 
whether a single item, single-interval item, or multiple-interval item can be selected, as shown 
in Figure 35.18. Single selection allows only one item to be selected. Single-interval selection 
allows multiple selections, but the selected items must be contiguous. These items can be se- 
lected all together by holding down the SHIFT key. Multiple-interval selection allows selec- 
tions of multiple contiguous items without restrictions. These items can be selected by 
holding down the CTRL key. The default value is MULTIPLE_INTERVAL_SELECTION. 
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(b) Single-interval selection 
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(c) Multiple-interval selection 



Figure 35.1 8 A list has three selection modes. 



The selectionModel property specifies an object that tracks list selection. JList has two 
models: a list model and a list-selection model. List models handle data management, and list-se- 
lection models deal with data selection. A list-selection model must implement the List- 
SelectionModel interface, which defines constants for three selection modes (SINGLE_ 
SELECTION, SINGLE JENTERVAL_SELECTION, and MULTIPLE_INTERVAL_SELECTION), and 
registration methods for ListSectionListener. It also defines the methods for adding and 



35.7 JList and Its Models 1207 



removing selection intervals, and the access methods for the properties, such as sel ectionMode, 
anchorSel ectionlndex, leadSelectionlndex, and val uelsAdj listing. 

By default, an instance of JList uses DefaultListSelectionModel, which is a con- 
crete implementation of Li stSel ectionModel . Usually, you do not need to provide a cus- 
tom list-selection model, because the DefaultListSelectionModel class is sufficient in 
most cases. List-selection models are rarely used explicitly, because you can set the selection 
mode directly in J Li st. 

35.7.4 Example: List Properties Demo 

This example creates a list of a fixed number of items displayed as strings. The example en- 
ables you to dynamically set vi sibl eRowCount from a spinner, 1 ayoutOrientation 
from a combo box, and sel ectionMode from a combo box, as shown in Figure 35.19. When 
you select one or more items, their values are displayed in a status label below the list. The 
source code of the example is given in Listing 35.7. 



uisihleRrKwf^oLiiTl 
lEiyoLitOneiiftation 
selecl KmMotMt 


f 


vctmcftL.wnAPiD \-* 


MUL TSPLC JNT CIWAL.SCIXCnON (2) | 


ITcml Items icini* 
ptwn2 rtenn itom6 





H 1 kfProperHpsD^mn 


uisihlcRowCouiTl 




layoirtorleiiiarton 


HORIIONTflLJWRAP {2} w 


MtocttMModi 


MULTPLEJNTERVAL_SELECTION \2) t 


Iteml N«n2 
Hcni4 ItcinE 


tem3 
tcm6 


Iteml Hem4 



B ListPropertiesDemo 


X 


vibiBtltfRuwCuLfiil 
lavoutOriCiYtation 
shIhiiIhiiiMnkIh 




HORfZONTAL WRAP|2] 




Mill TIPI FJNTFRVAI _SFI FfiTION (?) 




BtQinl Kein2 


Item J jitgml tomb Bem& 


Rem3 



Figure 35.19 You can dynamically set the properties for vi sibl eRowCount, 1 ayoutOrientation, and 
sel ectionMode in a list. 



Listing 35.7 ListPropertiesDemo. java 

1 import java.awt.*; 

2 import java.awt. event.*; 

3 import javax. swi ng . * ; 

4 import javax. swi ng . event . * ; 
5 

6 public class ListPropertiesDemo extends JApplet { 

7 private JList jlst = new JList(new String[] {"Iteml", list 

8 "Item2", "Item3", "Item4", "Item5", "Item6"}); 

9 private JSpinner jspVi sibl eRowCount = spinner 

10 new JSpinner(new Spi nnerNumberModel (8 , -1, 20, 1)); 

11 private JComboBox jcboLayoutOrientation = combo box 

12 new lComboBox(new Stri ng [] {"VERTICAL (0)", 

13 "VERTICAL WRAP (1)", "HORIZONTAL WRAP (2)"}); 

14 private JComboBox jcboSel ectionMode = combo box 

15 new lComboBox(new Stri ng[] {"SINGLE SELECTION (0)", 

16 "SINGLE INTERVAL SELECTION (1)", 

17 "MULTIPLE INTERVAL_SELECTI0N (2)"}); 

18 private J Label jlbl Status = new ILabelO; 
19 

20 /** Construct the applet */ 

21 public ListPropertiesDemoO { 

22 // Place labels in a panel create UI 

23 JPanel panel 1 = new JPanelO; 

24 panell.setLayout(new GridLayout(3 , 1)); 

25 panel 1. add (new J Label ("vi sibl eRowCount") ) ; 

26 panel 1. add (new DLabel ("layoutOrientation")) ; 

27 panel 1. add (new JLabel ("sel ectionMode")) ; 
28 
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spinner listener 



combo box listener 



combo box listener 



list listener 



main method omitted 



29 
30 
31 
32 
33 
34 
35 
36 
37 
38 
39 
40 
41 
42 
43 
44 
45 
46 
47 
48 
49 
50 
51 
52 
53 
54 
55 
56 
57 
58 
59 
60 
61 
62 
63 
64 
65 
66 
67 
68 
69 
70 
71 
72 
73 
74 
75 
76 
77 
78 
79 
80 
81 
82 
83 
84 
85 
86 
87 



// Place text fields in a panel 

J Panel panel 2 = new JPanelO; 

panel 2 . setLayout(new Grid Layout (3 , 1)); 

panel 2 . add ( j spVi si bl eRowCount) ; 

panel2 .add(jcboLayoutOrientation) ; 

panel2 .add(jcboSelectionMode) ; 

// Place panel 1 and panel 2 

J Panel panel 3 = new JPanelO; 

panel 3 . setLayout(new BorderLayout(5 , 5)); 

panel 3 . add (panel 1, Border Layout .WEST) ; 

panel 3 . add (panel 2 , Border Layout .CENTER) ; 

// Place elements in the applet 

add (panel 3, BorderLayout . NORTH) ; 

add(new JScroll Pane(jl st) , BorderLayout . CENTER) ; 

add(jlblStatus, BorderLayout . SOUTH) ; 

// Set initial property values 
jlst.setFixedCellWidth(50) ; 
jlst.setFixedCellHeight(20) ; 

jlst.setSelectionMode(ListSelectionModel . SINGLE_SELECTI0N) ; 

// Register listeners 

jspVisibleRowCount.addChangeListener(new ChangeLi stener() { 
public void stateChanged(ChangeEvent e) { 
j 1 st . setVi si bl eRowCount ( 

((Integer) jspVi si bl eRowCount . getVal ue()) . i ntVal ue()) ; 

} 

}); 

jcboLayoutOri entati on . addActi onLi stener(new Acti onLi stener() 
public void actionPerformed(ActionEvent e) { 
j 1 st . setLayoutOri entati on ( 

j cboLayoutOri entati on . getSel ectedlndex() ) ; 

} 

}); 

jcboSelectionMode.addActionListener(new ActionLi stener() { 
public void actionPerformed(ActionEvent e) { 
j 1 st . setSel ecti onMode ( 

j cboSel ecti onMode . getSel ectedlndex() ) ; 

} 

}); 

jlst.addListSelectionListener(new Li stSel ecti onLi stener() { 
public void valueChanged(ListSelectionEvent e) { 
0bject[] values = jlst.getSelectedValues() ; 
String display = ""; 

for (int i = 0; i < values. length; i++) { 
display += (Stri ng)val ues [i ] + " "; 

} 



jlblStatus.setText(display) ; 



}); 
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A JList is created with six string values (lines 7-8). A JSpinner is created using a 
SpinnerNumberModel with initial value 8, minimum value -1, maximum value 20, and step 
1 (lines 9-10). A JComboBox is created with string values VERTICAL (0), VERTICAL_WRAP 
(1), and H0RIZ0NTAL_WRAP (2) for choosing layout orientation (lines 11-13). A 
JComboBox is created with string values SINGLE_SELECTION (0), INTERVAL_SE LECTION 
(1), and MULTIPLE_INTERVAL_SELECTION (2) for choosing a selection mode (lines 
14-17). A J Label is created to display the selected elements in the list (lines 18). 

A JLi st does not support scrolling. To create a scrollable list, create a JScrol 1 Pane and 
add an instance of J Li st to it (line 44). 

The fixed list cell width and height are specified in lines 48^-9. The default selection mode 
is multiple-interval selection. Line 50 sets the selection mode to single selection. 

When a new visible row count is selected from the spinner, the setVisibleRowCount 
method is used to set the count (lines 53-58). When a new layout orientation is selected from 
the jcboLayoutOrientation combo box, the setLayoutOrientation method is used 
to set the layout orientation (lines 60-65). Note that the constant values for VERTICAL, 
VERTICAL_WRAP, and H0RIZ0NTA L_WRAP are 0, 1, and 2, which correspond to the index 
values of these items in the combo box. When a new selection mode is selected from the 
jcboSelectionMode combo box, the setSelectionMode method is used to set the selec- 
tion mode (lines 67-72). Note that the constant values for SINGLE_SELECTION, 
SINGLE_INTERVAL_SELECTION, and MULTIPLE_INTERVAL_SELECTION are 0, 1, and 2, 
which correspond to the index value of these items in the combo box. 

J List fires javax. swing, event . ListSelectionEvent to notify the listeners of the 
selections. The listener must implement the valueChanged handler to process the event. 
When the user selects an item in the list, the val ueChanged handler is executed, which gets 
the selected items and displays all the items in the label (lines 74-85). 



35.8 List Models 

The preceding example constructs a list with a fixed set of strings. If you want to add new 
items to the list or delete existing items, you have to use a list model. This section introduces 
list models. 

The J List class delegates the responsibilities of storing and maintaining data to its data 
model. The J List class itself does not have methods for adding or removing items from the 
list. These methods are supported in Li stModel , as shown in Figure 35.20. 

All list models implement the Li stModel interface, which defines the registration meth- 
ods for ListDataEvent. The instances of ListDataListener are notified when the items 
in the list are modified. Li stModel also defines the methods getSi ze and getEl ementAt. 
The getSize method returns the length of the list, and the getEl ementAt method returns 
the element at the specified index. 

AbstractLi stModel implements the ListModel and Serial izable interfaces. 
AbstractLi stModel implements the registration methods in the ListModel , but does not 
implement the getSize and getEl ementAt methods. 

DefaultLi stModel extends AbstractLi stModel and implements the two methods 
getSize and getEl ementAt, which are not implemented by AbstractLi stModel . 

The methods in Defaul t Li stModel are similar to those in the java.util .Vector 
class. You use the add method to insert an element to the list, the remove method to remove 
an element from the list, the cl ear method to clear the list, the getSi ze method to return the 
number of elements in the list, and the getEl ementAt method to retrieve an element. In fact, 
the Defaul tLi stModel stores data in an instance of Vector, which is essentially a resiz- 
able array. Swing components were developed before the Java Collections Framework. In fu- 
ture implementations, Vector may be replaced by java. util . ArrayList. 
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«interface» 
javax.swing.ListModel 



4- 



+getElementAt(index: int): Object 
+getSize() : int 

+addListDataListener(l : ListDataListener) : void 
+removeListDataListener(l : Li stDataLi stener) 



javax.swing.AbstractListModel 



javax.swing.DefaultListModel 



+Def aul tLi stModel () 

+add (index: int, element: Object): void 
+addElement(element: Object): void 
+capacity(): int 
+clear(): void 

+contains(element: Object): boolean 
+copyInto(anArray : Object[]): void 
+elementAt (index: int): void 
+elements(): Enumeration 
+ensureCapacity(minCapacity: int): void 
+fi rstEl ement() : Object 
+get(index: int): Object 
+getEl ementAt(i ndex : int): Object 
+getSize(): int 

+i ndexOf (el ement : Object): int 

+i ndexOf (el ement : Object, index: int): int 

+insertElementAt(obj : Object, index: int): void 

+isEmpty(): boolean 

+lastElement() : Object 

+lastlndex0f (element: Object): int 

+lastlndex0f (element: Object, index: int): int 

+remove(index: int): Object 

+removeAll Elements () : void 

+removeEl ement(obj : Object): boolean 

+removeElementAt(index: int): void 

+removeRange(f romlndex: int, tolndex: int): void 

+set(index: int, element: Object): Object 

+setEl ementAt(obj : Object, index: int): void 

+setSize(newSize: int): void 

+size(): int 

+toArray(): Object[] 

+trimToSize() : void 



Figure 35.20 Li stModel stores and manages data in a list. 



® Note 

In most cases, if you create a Swing GUI object without specifying a model, an instance of the 
default model class is created. But this is not true for JList. By default, the model property in 
default list model JList is not an instance of Def aul tLi stModel . To use a list model, you should explicitly 

create one using Def aul tLi stModel . 

Listing 35.8 gives an example that creates a list using a list model and allows the user to 
add and delete items in the list, as shown in Figure 35.21. When the user clicks the Add new 
item button, an input dialog box is displayed to receive a new item. 

Listing 35.8 Li stModel Demo, java 

1 import java.awt.*; 

2 import java.awt. event.*; 

3 import javax. swi ng . * ; 
4 
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5 public class Li stModel Demo extends DApplet { 



6 private Defaul tLi stModel li stModel = new Defaul tLi stModel () ; list model 

7 private JList jlst = new JList(listModel) ; list 

8 private JButton jbtAdd = new 1 Button ("Add new item"); 

9 private JButton jbtRemove = new 1 Button ("Remove selected item"); 
10 

11 /** Construct the applet */ 

12 public Li stModel Demo() { 

13 // Add items to the list model 

14 1 i stModel . addEl ement("Iteml") ; additems 

15 li stModel . addEl ement("Item2") ; 

16 li stModel . addEl ement("Item3") ; 

17 li stModel . addEl ement("Item4") ; 

18 li stModel . addEl ement("Item5") ; 

19 li stModel . addEl ement("Item6") ; 
20 

21 JPanel panel = new JPanelO; 

22 panel .add(jbtAdd) ; 

23 panel . add( jbtRemove) ; 
24 

2 5 add (panel, BorderLayout . NORTH) ; 

26 add(new JScroll Pane(jl st) , BorderLayout . CENTER) ; 

27 

28 // Register listeners 

29 jbtAdd. addActi onLi stener(new Acti onLi stener() { button listener 

30 public void actionPerformed(ActionEvent e) { 

31 String newltem = 

32 JOptionPane. showInputDialog("Enter a new item"); 

33 

34 if (newltem != null) 

35 if (jlst.getSelectedlndexO == -1) 

36 listModel . addEl ement (newltem) ; 

37 else 

38 listModel .add(jlst.getSelectedIndex() , newltem); 

39 } 

40 }); 
41 

42 jbtRemove. addActi onLi stener(new Acti onLi stener() { button listener 

43 public void actionPerformed(ActionEvent e) { 

44 listModel . remove(jlst.getSelectedlndexO) ; 

45 } 

46 }); 

47 } 

48 } main method omitted 
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Figure 35.2 1 You can add elements and remove elements in a list using list models. 



The program creates 1 i stModel (line 6), which is an instance of Defaul tLi stModel , and 
uses it to manipulate data in the list. The model enables you to add and remove items in the list. 

A list is created from the list model (line 7). The initial elements are added into the model 
using the addEl ement method (lines 13-19). 
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To add an element, the user clicks the Add new item button to display an input dialog 
box. Type a new item in the dialog box. The new item is inserted before the currently se- 
lected element in the list (line 38). If no element is selected, the new element is appended to 
the list (line 36). 

To remove an element, the user has to select the element and then click the Remove select- 
ed item button. Note that only the first selected item is removed. You can modify the program 
to remove all the selected items (see Exercise 35.6). 

What would happen if you clicked the Remove selected item button but no items were cur- 
rently selected? This would cause an error. To fix it, see Exercise 35.6. 



35.9 List Cell Renderer 

The preceding example displays items as strings in a list. J Li st is very flexible and versatile, 
and it can be used to display images and GUI components in addition to simple text. This sec- 
tion introduces list cell Tenderers for displaying graphics. 

In addition to delegating data storage and processing to list models, J List delegates the ren- 
dering of list cells to list cell Tenderers. All list cell Tenderers implement the Li stCel 1 Renderer 
interface, which defines a single method, getListCel 1 RendererComponent, as follows: 

public Component getLi stCell RendererComponent 

(DList list, Object value, int index, boolean isSelected, 
boolean cellHasFocus) 

This method is passed with a list, the value associated with the cell, the index of the value, and 
information regarding whether the value is selected and whether the cell has the focus. The 
component returned from the method is painted on the cell in the list. By default, J Li st uses 
DefaultListCell Renderer to render its cells. The Defaul tListCell Renderer class 
implements Li stCel 1 Renderer, extends J Label , and can display either a string or an icon, 
but not both in the same cell. 

For example, you can use J List's default cell renderer to display strings, as shown in 
Figure 35.22(a), using the following code: 

DList list = new 1 List (new St ri ng [] {"Denmark" , "Germany", 
"China", "India", "Norway", "UK", "US"}); 
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Figure 35.22 The cell renderer displays list items in a list. 



You can use DLi st's default cell renderer to display icons, as shown in Figure 35.22(b), using 
the following code: 

Imagelcon denmarklcon = new ImageIcon(getClass() .getResource( 
"image/denmarklcon.gif")) ; 

DList list = new JList(new Imagelcon [] {denmarklcon , germanylcon, 
chinalcon, indialcon, norwaylcon, uklcon, uslcon}) ; 
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How do you display a string along with an icon in one cell, as shown in Figure 35.22(c)? 
You need to create a custom renderer by implementing Li stCell Renderer, as shown in 
Figure 35.23. 



JList 



«interf'ace» 
javax.swing.ListCeIlRenderer 



w- 



getLi stCell RendererComponent(li st : JList, 
value: Object, index: int, isSelected: boolean, 
cellHasFocus: boolean): Component 



Def aul tl_i stCel 1 Renderer 
YourCustomLi stCel 1 Renderer | 



Figure 35.23 Li stCel 1 Renderer defines how cells are rendered in a list. 



Suppose a list is created as follows: 

JList list = new JList(new Object [][] {{denmarklcon , "Denmark"}, 
{germanylcon , "Germany"}, {chinalcon, "China"}, 
{indialcon, "India"}, {norwaylcon, "Norway"}, {uklcon, "UK"}, 
{uslcon, "US"}}); 

Each item in the list is an array that consists of an icon and a string. You can create a custom 
cell renderer that retrieves an icon and a string from the list data model and display them in a 
label. The custom cell renderer class is given in Listing 35.9. 

Listing 35.9 MyLi stCell Renderer. java 

1 import java.awt.*; 

2 import javax. swi ng . * ; 

3 import javax. swing. border.*; 
4 

5 public class MyLi stCel 1 Renderer implements Li stCell Renderer { 



6 private JLabel jlblCell = new JLabel(" ", JLabel . LEFT) ; cell component 

7 private Border lineBorder = 

8 BorderFactory.createLineBorder(Color. black, 1); 

9 private Border emptyBorder = 

10 BorderFactory . createEmptyBorder(2 , 2, 2, 2); 
11 

12 /** Implement this method in Li stCel 1 Renderer */ 

13 public Component getLi stCel 1 RendererComponent 

14 (JList list, Object value, int index, boolean isSelected, 

15 boolean cellHasFocus) { 

16 Object [] pair = (Object [] )val ue ; // Cast value into an array 

17 jlblCell . setOpaque(true) ; 

18 jlblCell . setIcon((ImageIcon)pai r[0]) ; seticon 

19 jlblCell .setText(pair[l] .toStringO) ; set text 
20 

21 if (isSelected) { 

22 jl bl Cel 1 . setForeground(l i st . getSel ectionForegroundO) ; cell selected 

23 jlblCell .setBackground(list.getSelectionBackground()) ; 

24 } 

25 else { 

26 jlblCell .setForeground(list.getForegroundO) ; 

27 jlblCell .setBackground(list.getBackgroundO) ; 

28 } 
29 

30 jlblCell . setBorder(cel 1 HasFocus ? lineBorder : emptyBorder); 
31 
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return rendering cell 32 return jlblCell; 

33 } 

34 } 

The MyListCell (tenderer class implements the getListCellRendererComponent 

method in the ListCellRenderer interface. This method is passed with the parameters 
list, value, index, isSelected, and isFocused (lines 13-15). The value represents 
the current item value. In this case, it is an array consisting of two elements. The first element 
is an image icon (line 18). The second element is a string (line 19). Both image icon and string 
are displayed on a label. The getListCellRendererComponent method returns the label 
(line 32), which is painted on the cell in the list. 

If the cell is selected, the background and foreground of the cell are set to the list's selec- 
tion background and foreground (lines 22-23). If the cell is focused, the cell's border is set to 
the line border (line 30); otherwise, it is set to the empty border (line 30). The empty border 
serves as a divider between the cells. 

|§| Note 

any GUI renderer The example in Listing 35.9 uses a 3 Label as a rendeter. You may use any GUI component as a 

Tenderer, returned from the getListCellRendererComponent method. 

Let us develop an example (Listing 35.10) that creates a list of countries and displays the flag 
image and name for each country as one item in the list, as shown in Figure 35.24. When a 
country is selected in the list, its flag is displayed in a label next to the list. 
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Figure 35.24 The image and the text are displayed in the list cell. 



Listing 35.10 Li stCel 1 RendererDemo. java 



nation strings 

small icons 
big icons 

list model 



1 
2 
3 
4 
5 
6 
7 
8 
9 
10 
11 
12 
13 



import javax. swi ng . * ; 
import javax. swi ng . event ; 
import java.awt.*; 

public class Li stCel 1 RendererDemo extends JApplet { 
private final static int NUMBER OF NATIONS = 7; 
private String [] nations = new String [] 

{"Denmark", "Germany", "China", "India", "Norway", "UK", "US"}; 
private ImageIcon[] icons = new Imagelcon [NUMBER_0F_NATI0NS] ; 
private Imagelcon [] biglcons = new Imagelcon [NUMBER_0F_NATI0NS] ; 



// Create a list model 

private Defaul tLi stModel li stModel 



new Defaul tLi stModel () ; 
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14 

15 // Create a list using the list model 

16 private JList jlstNations = new IList(listModel) ; list 
17 

18 // Create a list cell renderer 

19 private Li stCel 1 Renderer renderer = new MyLi stCel 1 RendererO ; list cell renderer 
20 

21 // Create a split pane 

22 private JSplitPane jSplitPanel = new JSpl itPaneO ; splitpane 
23 

24 // Create a label for displaying image 

25 private JLabel jlbllmage = new )Label("", D Label .CENTER) ; imagelabel 
26 

27 /** Construct Li stCel 1 Renderer */ 

28 public Li stCel 1 RendererDemo() { 

29 // Load small and large image icons 

30 for (int i = 0; i < NUMBER_0F_NATI0NS ; i++) { 

31 icons[i] = new ImageIcon(getClass() . getResource( load image icons 

32 "image/flaglcon" + i + ".gif")); 

33 1 i stModel . addEl ement (new Object [] {i cons [i ] , nations [i ]}) ; addelements 
34 

35 bigIcons[i] = new ImageIcon(getClass() . getResource( load image icons 

36 "image/flag" + i + ".gif")); 

37 } 
38 

39 // Set list cell renderer 

40 jlstNations. setCel 1 Renderer(renderer) ; setrenderer 

41 jlstNations. setPreferredSize(new Dimension(200, 200)); 

42 jSplitPanel.setLeftComponent(new JScroll Pane(jl stNations)) ; 

43 jSplitPanel.setRightComponent(jlbllmage) ; 

44 jlstNations. setSel ectedlndex(O) ; 

45 jlbllmage. setlcon(biglcons[0]) ; 

46 add(jSplitPanel, BorderLayout . CENTER) ; 
47 

48 // Register listener 

49 jl stNati ons . addLi stSel ecti onLi stener(new Li stSel ecti onLi stenerO { list listener 

50 public void valueChanged(ListSelectionEvent e) { 

51 jl bl Image . setlcon (bi glcons [ j 1 stNati ons . getSel ectedlndex() ] ) ; 

52 } 

53 }); 

54 } 

55 } main method omitted 



Two types of icons are used in this program. The small icons are created from files 
f 1 aglconO .gif, . . . , f 1 agIcon6 .gif (lines 3 1-32). These image files are the flags for Den- 
mark, Germany, China, India, Norway, UK, and US. The small icons are rendered inside the list. 
The large icons for the same countries are created from files flag0.gif, . . . , flag6.gif 
(lines 35-36). The large icons are displayed on a label on the right side of the split pane. 

The ListCellRendererDemo class creates a list model (line 13) and adds the items to 
the model (line 33). Each item is an array of two elements (image icon and string). The list is 
created using the list model (line 16). The list cell renderer is created (line 19) and associated 
with the list (line 40). 

The Li stCel 1 RendererDemo class creates a split pane (line 22) and places the list on the 
left (line 42) and a label on the right (line 43). 

When you choose a country in the list, the list-selection event handler is invoked (lines 
49-53) to set a new image to the label in the right side of the split pane (line 51). 
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35.10 JComboBox and Its Models 

The basic features of JComboBox were introduced in §17.8, "Combo Boxes," without using 
combo box models. This section introduces combo models and discusses the use of 
JComboBox in some detail. 

A combo box is similar to a list. Combo boxes and lists are both used for selecting 
items from a list. A combo box allows the user to select one item at a time, whereas a list 
permits multiple selections. When a combo box is selected, it displays a drop-down list 
contained in a popup menu. The selected item can be edited in the cell as if it were a text 
field. Figure 35.25 shows the properties and constructors of JComboBox. The data for a 
combo box are stored in ComboBoxModel . You can create a combo box from a combo box 
model, an array of objects, or a vector. 



JavaBeans properties with get and set 
methods omitted in the UML diagram. 



javax.swing.JComboBox 



-actionCommand: String 
-editable: boolean 
-itemCount: int 
-maximumRowCount : int 

-model : ComboBoxModel 
-popupVi si bl e : boolean 

-Tenderer: Li stCell Renderer 
-selectedlndex: int 
-selectedltem: Object 




+JComboBox() 

+JComboBox(dataModel : ComboBoxModel) 
+JComboBox(i terns: Object []) 
+JComboBox(i terns: Vector) 
+getItemAt (index: int): void 
+addltem(an0bject: Object): void 
+insertItemAt(anObject: Object, index: int): 
+removeItemAt(index: int): void 
+removeltem(an0bject : Object): void 
+ removeAl 1 ItemQ : void 



void 



javax. swing. ComboBoxModel 



An action string associated with the combo box. 

Specifies whether the cell can be edited. 

A read-only property to count the number of items. 

Specifies the maximum number of items the combo box can 
display in the popup menu without a scrollbar. 

The data model that holds the items displayed by this combo box. 

Indicates whether the popup menu for displaying items is visible. 

By default, it is false, which means the user has to click the combo 

box to display the popup menu. 
The object that renders the list items in the combo box. 
Specifies the index of the selected item. 
Specifies the selected item. 

Constructs a default JComboBox. 

Constructs a JComboBox with the specified combo box model. 
Constructs a default JComboBox with an array of items. 
Constructs a JComboBox with a vector. 
Returns the item at the specified index. 
Adds the item to the combo box. 

Inserts the item to the combo box at the specified index. 
Removes an item at the specified index from the combo box. 
Removes an item from the combo box. 
Removes all items from the combo box. 



Figure 35.25 JComboBox displays elements in a list. 



JComboBox delegates the responsibilities of storing and maintaining data to its data 
model. All combo box models implement the ComboBoxModel interface, which extends 
the ListModel interface and defines the getSelectedltem and setSelectedltem 
methods for retrieving and setting a selected item. The methods for adding and removing 
items are defined in the Mutabl eComboBoxModel interface, which extends 
ComboBoxModel . When an instance of JComboBox is created without explicitly specifying 
a model, an instance of Def aul tComboBoxModel is used. The Def aul tComboBoxModel 
class extends AbstractListModel and implements Mutabl eComboBoxModel , as shown 
in Figure 35.26. 
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+i nsertEl ementAt(obj : Object, 
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: void 



Figure 35.26 ComboBoxModel stores and manages data in a combo box. 



Usually you don't need to use combo box models explicitly, because JComboBox contains 
the methods for retrieving (getltemAt, getSel ectedltem, and getSelectedlndex), 
adding (addltem and insertltemAt), and removing (removeltem, removeltemAt, and 
removeAl 1 Items) items from the list. 

JComboBox can fire ActionEvent and ItemEvent, among many other events. Whenev- 
er a new item is selected, JComboBox fires ItemEvent twice, once for deselecting the previ- 
ously selected item, and the other for selecting the currently selected item. JComboBox fires 
an ActionEvent after firing an ItemEvent. 

Combo boxes render cells exactly like lists, because the combo box items are displayed in 
a list contained in a popup menu. Therefore, a combo box cell Tenderer can be created exact- 
ly like a list cell Tenderer by implementing the Li stCel 1 Renderer interface. Like J Li st, 
JComboBox has a default cell renderer that displays a string or an icon, but not both at the 
same time. To display a combination of a string and an icon, you need to create a custom ren- 
derer. The custom list cell renderer MyListCell Renderer in Listing 35.9 can be used as a 
combo box cell renderer without any modification. 

Listing 35.11 gives an example that creates a combo box to display the flag image and 
name for each country as one item in the list, as shown in Figure 35.27. When a country is se- 
lected in the list, its flag is displayed in a panel below the combo box. 

Listing 35.1 1 ComboBoxCel 1 RendererDemo. java 

1 import java.awt.*; 

2 import java.awt. event.*; 

3 import javax. swi ng . * ; 
4 

5 public class ComboBoxCell RendererDemo extends JApplet { 

6 private final static int NUMBER_OF_NATIONS = 7; 

7 private String [] nations = new String [] {"Denmark", nation strings 
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"Germany", "China", "India", "Norway", "UK", "US"}; 
private ImageIcon[] icons = new Imagelcon [NUMBER_0F_NATI0NS] ; 
private Imagelcon [] biglcons = new Imagelcon [NUMBER_0F_NATI0NS] ; 

// Create a combo box model 

private Defaul tComboBoxModel model = new Defaul tComboBoxModel () ; 

// Create a combo box with the specified model 

private JComboBox jcboCountries = new JComboBox (model ) ; 

// Create a list cell renderer 

private MyLi stCel 1 Renderer renderer = new MyLi stCell RendererO ; 

// Create a label for displaying image 

private JLabel jlbllmage = new JLabeK"", J Label .CENTER) ; 

/** Construct the applet */ 
public ComboBoxCel 1 RendererDemo() { 
// Load small and large image icons 
for (int i =0; i < NUMBER_0F_NATI0NS ; i++) { 
icons[i] = new ImageIcon(getClass() .getResource( 

"image/flaglcon" + i + ".gif")); 
model . addEl ement(new Object [] {i cons [i ] , nations [i ]}) ; 

bigIcons[i] = new ImageIcon(getClass() .getResource( 
"image/flag" + i + ".gif")); 

} 

// Set list cell renderer for the combo box 
jcboCountries . setRende re r( renderer) ; 
jlbllmage. setlcon(biglcons[0]) ; 
add(jcboCountries, java.awt.BorderLayout. NORTH) ; 
add(jlbllmage, java.awt.BorderLayout. CENTER) ; 

// Register listener 

jcboCountries. addActionLi stener(new ActionLi stenerO { 

public void actionPerformed(java.awt. event. ActionEvent e) { 
jl bl Image . setlcon 

(bi glcons [ j cboCount ri es . getSel ectedlndex() ] ) ; 

} 

}); 




The program is very similar to the preceding example in Listing 35.10. Two types of image 
icons are loaded for each country and stored in the arrays icons and biglcons (lines 
27-34). Each item in the combo box is an array that consists of an icon and a string (line 30). 
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MyLi stCel 1 Renderer, defined in Listing 35.9, is used to create a cell Tenderer in line 19. 
The cell renderer is plugged into the combo box in line 37. 

When you choose a country from the combo box, the action event handler is invoked (lines 
44-46). This handler sets a new image on the label (line 45). 
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Chapter Summary 

1 . The fundamental issue in the model-view approach is to ensure consistency between 
the views and the model. Any change in the model should be notified to the dependent 
views, and all the views should display the same data consistently. The model can be 
implemented as a source with appropriate event and event listener registration meth- 
ods. The view can be implemented as a listener. Thus, if data are changed in the 
model, the view will be notified. 

2. Every Swing user interface component (e.g., JButton, JTextField, JList, and 
JComboBox) has a property named model that refers to its data model. The data 
model is defined in an interface whose name ends with Model (e.g., SpinnerModel , 
ListModel, ListSelectionModel, and ComboBoxModel ). 

3. Most simple Swing components (e.g., JButton, JTextField, JTextArea) contain 
some properties of their models, and these properties can be accessed and modified di- 
rectly from the component without the existence of the model being known. 

4. A JSpinner is displayed as a text field with a pair of tiny arrow buttons on its right 
side that enable the user to select numbers, dates, or values from an ordered sequence. 
A JSpinner's sequence value is defined by the SpinnerModel interface. 
AbstractSpinnerModel is a convenient abstract class that implements 
SpinnerModel and provides the implementation for its registration/deregistration 
methods. Spinner ListModel , SpinnerNumberModel, and SpinnerDateModel 
are concrete implementations of SpinnerModel . SpinnerNumberModel represents 
a sequence of numbers with properties maximum, minimum, and stepSize. 
SpinnerDateModel represents a sequence of dates. Spinner ListModel can store 
a list of any object values. 

5 . A JSpi nner has a single child component, called the editor, which is responsible for dis- 
playing the current element or value of the model. Four editors are defined as static inner 
classes inside JSpinner: JSpi nner. DefaultEdi tor, JSpi nner .NumberEdi tor, 
JSpi nner . DateEdi tor, and JSpi nner . Li stEdi tor. 

6. JList has two supporting models: a list model and a list-selection model. The list 
model is for storing and processing data. The list-selection model is for selecting 
items. By default, items are rendered as strings or icons. You can also create a custom 
renderer implementing the Li stCel 1 Renderer interface. 

7. JComboBox delegates the responsibilities of storing and maintaining data to its data 
model. All combo box models implement the ComboBoxModel interface, which ex- 
tends the ListModel interface and defines the getSel ectedltem and 
setSel ectedltem methods for retrieving and setting a selected item. The methods 



1220 Chapter 35 



MVC and Swing Models 



for adding and removing items are defined in the Mutabl eComboBoxModel inter- 
face, which extends ComboBoxModel . When an instance of JComboBox is created 
without explicitly specifying a model, an instance of Def aul tComboBoxModel is 
used. The Def aul tComboBoxModel class extends AbstractListModel and im- 
plements Mutabl eComboBoxModel . 

8. Combo boxes render cells exactly like lists, because the combo box items are dis- 
played in a list contained in a popup menu. Therefore, a combo box cell Tenderer can 
be created exactly like a list cell renderer by implementing the Li stCel 1 Renderer 
interface. 

Review Questions 

Sections 35.2-35.3 

35. 1 What is model-view-controller architecture? 

35.2 How do you do implement models, views, and controllers? 

35.3 What are the variations of MVC architecture? 

Section 35.4 

35.4 Does each Swing GUI component (except containers such as JPanel) have a 
property named model ? Is the type of model the same for all the components? 

35.5 Does each model interface have a default implementation class? If so, does a 
Swing component use the default model class if no model is specified? 

Sections 35.5-35.6 

35.6 If you create a JSpi nner without specifying a data model, what is the default model? 

35.7 What is the internal data structure for storing data in Spi nnerLi stModel ? How 

do you convert an array to a list? 

Sections 35.7-35.9 

35.8 Does JList have a method, such as addltem. for adding an item to a list? How do 
you add items to a list? Can J Li st display icons and custom GUI objects in a list? 
Can a list item be edited? How do you initialize data in a list? How do you specify 
the maximum number of visible rows in a list without scrolling? How do you spec- 
ify the height of a list cell? How do you specify the horizontal margin of list cells? 

35.9 How do you create a list model? How do you add items to a list model? How do 
you remove items from a list model? 

35.10 What are the three list-selection modes? Can you set the selection modes directly 
in an instance of J Li st? How do you obtain the selected item(s)? 

35.11 How do you define a custom list cell renderer? 

35.12 What is the handler for handling the ListSelectionEvent? 

Section 35.10 

35.13 Can multiple items be selected from a combo box? Can a combo box item be edit- 
ed? How do you specify the maximum number of visible rows in a combo box 
without scrolling? Can you specify the height of a combo box cell using a method 
in JComboBox? How do you obtain the selected item in a combo box? 

35.14 How do you add or remove items from a combo box? 

35.15 Why is the cell renderer for a combo box the same as the renderer for a list? 
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Section 35.2 

35.1*** (Creating MVC components) Create a model, named ChartModel, which 
holds data in an array of double elements named data, and the names for the 
data in an array of strings named dataName. For example, the enrollment data 
{200,40,50,100,40} stored in the array data are for {"CS", "Math", 
"Chem", "Biol", "Phys"} in the array dataName. These two properties have 
their respective get methods, but not individual set methods. Both proper- 
ties are set together in the setChartData(String[] newDataName , 
doubl e [] newData) method so that they can be displayed properly. Cre- 
ate a view named PieChart to present the data in a pie chart, and create a 
view named BarChart to present the data in a bar chart, as shown in 
Figure 35.28(a). 
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(a) (b) 

Figure 35.28 (a) The two views, PieChart and BarChart, receive data from the ChartModel ; (b) Clicking the 
eclipse button displays the color chooser dialog box for specifying a color. 



(Hint: Each pie represents a percentage of the total data. Color the pie using 
the colors from an array named colors, which is {Color, red, 
Color .yellow, Col or. green, Col or. blue, Col or. cyan, 
Color .magenta, Color .orange, Color. pink, Color .darkGray}. Use 
colors[i % colors. length] for the ith pie. Use black color to display 
the data names.) 

35.2* (Revising Listing 35.3 CircleController.java) Ci rcl eController uses a text 
field to obtain a new radius and a combo box to obtain a Boolean value to 
specify whether the circle is filled. Add a new row in Ci rcl eControl 1 er to 
let the user choose color using the JColorChooser component, as shown in 
Figure 35.28(b). The new row consists of a label with text Color, a label to dis- 
play color, and an eclipse button. The user can click the eclipse button to dis- 
play a JColorChooser dialog box. Once the user selects a color, the color is 
displayed as the background for the label on the left of the eclipse button. 

Sections 35.5-35.6 

35.3** (Synchronizing spinners) The date spinner is synchronized with the day, 
month, and year spinners in Listing 35.6, SpinnerModelEditorDemo.java. Im- 
prove it to synchronize the day, month, and year spinners with the date spin- 
ner. In other words, when a new value is selected in the date spinner, the 
values in the day, month, and year spinners are updated accordingly. 

35.4* (Custom spinner model) Develop a custom spinner model that represents a se- 
quence of numbers of power 2 — that is, 1, 2, 4, 8, 16, 32, and so on. Your 
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model should implement AbstractSpinnerModel . The registration/dereg- 
istration methods for ChangeListener have already been implemented in 
AbstractSpinnerModel. You need to implement getNextValueO, 
getPreviousValueO, getValueO, and setValue (Object) methods. 

35.5* (Reversing the numbers displayed in a spinner) The numbers displayed in a 
spinner increase when the up-arrow button is clicked and decrease when the 
down-arrow button is clicked. You can reverse the sequence by creating a 
new model that extends SpinnerNumberModel and overrides the 
getNextValue and getPreviousValue methods. Write a test program 
that uses the new model, as shown in Figure 35.29. 



BET 
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Figure 35.29 The numbers in the spinner are in decreasing order. 



Sections 35.7-35.9 

35 .6* (Removing selected items in a list) Modify Listing 35.8, ListModelDemo.java, 
to meet the following requirements: 

■ Remove all the selected items from the list when the Remove selected item 
button is clicked. 

■ Enable the items to be deleted using the DELETE key. 

35.7* (Custom list cell renderer) Listing 35.10, ListCellRendererDemo.java, has 
two types of images for each country. The small images are used for display 
in the list, and the large ones are used for display outside the list. Assume that 
only the large images are available. Rewrite the custom cell renderer to use a 
JPanel instead of a JLabel for rendering a cell. Each cell consists of an 
image and a string. Display the image in an ImageViewer and the string in a 
label. The ImageViewer component was introduced in Listing 15.13, Im- 
age Viewer.java. The image can be stretched in an ImageViewer. Set the di- 
mension of an image viewer to 32 by 32, as shown in Figure 35.30. Revise 
Listing 35.10 to test the new custom cell renderer. 




35 .8* (Deleting selected items in a list using the DELETE key) Modify Listing 35. 10, 
ListCellRendererDemo.java, to delete selected items from the list using the 
DELETE key. After some items are deleted from the list, the index of a select- 
ed item in the list does not match the index of the item in the bi glcons array. 
As a result, you cannot use the image icon in the bi glcons array to display the 
image to the right side of the split pane. Revise the program to retrieve the icon 
from the selected item in the list and display it, as shown in Figure 35.31. 
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Figure 35.3 1 Images in the list are also used for display in the label placed in the right side 
of a split pane. 



35.9** (Rendering figures) Create a program that shows a list of geometrical shapes 
along with a label in an instance of JList, as shown in Figure 35.32(a). Dis- 
play the selected figure in a panel when selecting a figure from the list. The 
figures can be drawn using the FigurePanel class in Listing 15.3, Fig- 
urePanel.java. 

35.10** (List of clocks) Write a program that displays a list of cities and their local 
times in a clock, as shown in Figure 35.32(b). When a city is selected in the 
list, its clock is displayed in a large picture on the right. 




(a) (b) 

Figure 35.32 (a) The list displays geometrical shapes and their names; (b) The list displays 
cities and clocks. 



Section 35.10 

35.1 I** (Creating custom cell renderer in a combo box) Create a program that 
shows a list of geometrical shapes along with a label in a combo box, as 
shown in Figure 35.33(a). This exercise may share the list cell renderer with 
Exercise 35.9. 




Figure 35.33 (a) The combo box contains a list of geometrical shapes and the shape names, (b) The combo box con- 
tains a list of color names, each using its own color for its foreground. 
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35. 1 2** (Rendering colored text) Write a program that enables the user to choose the 
foreground colors for a label, as shown in Figure 35.33(b). The combo box 
contains 13 standard colors (BLACK, BLUE, CYAN, DARK_CRAY, GRAY, GREEN, 
LIGHT_GRAY, MAGENTA, ORANGE, PINK, RED, WHITE, YELLOW). Each color 
name in the combo box uses its own color for its foreground. 

35.13* (Deleting a selected item in a combo box using the DELETE key) Modify List- 
ing 35.11, ComboBoxCellRendererDemo.java, to delete the selected item 
from the combo box using the DELETE key. 

Comprehensive 

35.14* (Calendar) Write a program that controls a calendar using a spinner, as shown 
in Figure 35.7. Use the Cal endarPanel class (see Listing 31.4) to display 
the calendar. 
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Objectives 



To display tables using JTabl e (§36.2). 

To process rows and columns using Tabl eModel , Def aul tTabl eModel , 
Tabl eCol umnModel , Def aul tTabl eCol umnModel , and 
ListSelectionModel (§§36.3-36.5). 

To enable auto sort and filtering on table 
model (§36.4). 

To add rows and columns, delete rows and 
columns in a table (§36.5). 

To render and edit table cells using the default 
Tenderers and editors (§36.6). 

To render and edit table cells using the custom 
Tenderers and editors (§36.7). 

To handle table model events (§36.8). 

To display data in a tree hierarchy using 
XTree (§36.9). 

To model the structure of a tree using using 
TreeModel and Defaul tTreeModel (§36.10). 

To add, remove, and process tree nodes using 
TreeNode, MutableTreeNode, and 
Defaul tMutabl eTreeNode (§36.1 1). 

To select tree nodes and paths using 
TreeSelectionModel and Defaul tTreeSe- 
lectionModel (§36.12). 

To render and edit tree nodes using the default 
and custom Tenderers and editors (§36.14). 
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36.1 Introduction 

The preceding chapter introduced the model-view architecture, Swing MVC, and the models 
in JSpi nner, JLi st, and JComboBox. This chapter introduces JTabl e and JTree, and how 
to use the models to process data in JTabl e and JTree. 

36.2 JTable 

JTabl e is a Swing component that displays data in rows and columns in a two-dimensional 
grid, as shown in Figure 36. 1 . 
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Figure 36.1 JTabl e displays data in a table. 



JTabl e doesn't directly support scrolling. To create a scrollable table, you need to create 
a JScrol 1 Pane and add an instance of JTabl e to the scroll pane. If a table is not placed in a 
scroll pane, its column header will not be visible, because the column header is placed in the 
header of the view port of a scroll pane. 

JTabl e has three supporting models: a table model, a column model, and a list- selection 
model. The table model is for storing and processing data. The column model represents all 
the columns in the table. The list- selection model is the same as the one used by J Li st for se- 
lecting rows, columns, and cells in a table. JTabl e also has two useful supporting classes, 
TableColumn and JTableHeader. TableColumn contains the information on a particular 
column. JTabl eHeader can be used to display the header of a JTabl e. Each column has a 
default editor and renderer. You can also create a custom editor by implementing the 
Tabl eCell Editor interface, and create a custom renderer by implementing the 
Tabl eCell Renderer interface. The relationship of these interfaces and classes is shown in 
Figure 36.2. 



j a vax.s wing. JTable 



-model: TableModel 
-col umnModel : Tabl eCol umnModel 
-sel ectionMode : int 
-sel ecti onModel : Li stSel ecti onModel 
-tabl eHeader : JTableHeader 



Q — TableModel | 



Abs tractTab 1 eMode 1 



■ DefaultTableModel | 



Q — Tabl eCol umnModel | TableColumn |^ 

^ — ListSelectionModel \ 
- JTableHeader | 

Figure 36.2 JTabl e contains many supporting interfaces and classes. 



Tabl eCell Renderer\ 
Tabl eCell Editor | 



■ Note 

All the supporting interfaces and classes for DTable are grouped in the javax. swing, table 

package. 

Figure 36.3 shows the constructors, properties, and methods of JTabl e. 



36 2 JTabl e 1227 



javax.swing.JTable 



-autoCreateCol umnsFromModel : boolean 
-autoResi zeMode : int 
-cellEditor: TableCellEditor 
-columnModel : TableColumnModel 
-col umnSelectionAll owed: boolean 
-editingColumn: int 
-editingRow: int 
-gridColor: java.awt. Color 
-i ntercell Spaci ng : Dimension 
-model: TableModel 
-rowCount: int 
-rowHeight: int 
-rowMargin: int 
-rowSelectionAllowed: boolean 
-selectionBackg round: java.awt. Col or 
-selection Foreground: java.awt. Col or 
-showCrid: boolean 
-selectionMode: int 
-selectionModel : ListSelectionModel 
-showHorizontal Li nes : boolean 
-showVerti cal Li nes : boolean 
-tableHeader: JTableHeader 



+JTable() 

+JTable(numRows : int, numCol umns : int) 
+JTable(rowData: Object[][], columnData: Object []) 
+JTable(dm: TableModel) 

+DTable(dm: TableModel, cm: TableColumnModel) 

+]Table(dm: TableModel, cm: TableColumnModel, 
sm: ListSelectionModel) 

+DTable(rowData: Vector, col umnNames : Vector) 

+addColumn(aColumn: TableColumn) : void 

+clearSelection() : void 

+editCellAt(row: int, column: int): void 

+getDefaultEditor(column: Class): TableCell Editor 

+getDefaultRenderer(col : Class): TableCellRenderer 

+setDefaultEditor(column: Class, editor: 
TableCell Editor) : void 

+setDefaultRenderer(column: Class, editor: 
TableCellRenderer): void 



JavaBeans properties with get and set 
methods omitted in the UML diagram. 
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Indicates whether the columns are created in the table (default: true). 
Specifies how columns are resized (default: SUBSEQUENT_COLUMNS). 
Specifies a cell editor. 
Maintains the table column data. 

Specifies whether the column can be selected (default: false). 

Specifies the column of the cell that is currently being edited. 

Specifies the row of the cell that is currently being edited. 

The color used to draw grid lines (default: GRAY). 

Specifies horizontal and vertical margins between cells (default: 1, 1). 

Maintains the table model. 

Read-only property that counts the number of rows in the table. 
Specifies the row height of the table (default: 16 pixels). 
Specifies the vertical margin between rows (default: 1 pixel). 
Specifies whether the rows can be selected (default: true). 
The background color of selected cells. 
The foreground color of selected cells. 

Specify whether the grid lines are displayed (write-only, default: true). 
Specifies a selection mode (write-only). 
Specifies a selection model. 

Specifies whether the horizontal grid lines are displayed (default: true). 
Specifies whether the vertical grid lines are displayed (default: true). 
Specifies a table header. 

Creates a default JTabl e with all the default models. 
Creates a JTabl e with the specified number of empty rows and columns. 
Creates a JTabl e with the specified row data and column header names. 
Creates a JTabl e with the specified table model. 

Creates a JTabl e with the specified table model and table column model. 

Creates a JTabl e with the specified table model, table column model, 
and selection model. 

Creates a JTabl e with the specified row data and column data in vectors. 

Adds a new column to the table. 

Deselects all selected columns and rows. 

Edits the cell if it is editable. 

Returns the default editor for the column. 

Returns the default Tenderer for the column. 

Sets the default editor for the column. 

Sets the default Tenderer for the column. 



Figure 36.3 The JTabl e class is for creating, customizing, and manipulating tables. 

The JTabl e class contains seven constructors for creating tables. You can create a table 
using its no-arg constructor, its models, row data in a two-dimensional array, and column 
header names in an array, or row data and column header names in vectors. Listing 36.1 cre- 
ates a table with the row data and column names (line 20) and places it in a scroll pane (line 
23). The table is displayed in Figure 36.1. 
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Listing 36. 1 TestTabl e . j ava 

1 import javax. swing.*; 
2 

3 public class TestTabl e extends J Applet { 

4 // Create table column names 

5 private String [] columnNames = 

6 {"Country", "Capital", "Population in Millions", "Democracy"}; 
7 

8 // Create table data 

9 private Object[][] data = { 

10 {"USA", "Washington DC", 280, true}, 

11 {"Canada", "Ottawa", 32, true}, 

12 {"United Kingdom", "London", 60, true}, 

13 {"Germany", "Berlin", 83, true}, 

14 {"France", "Paris", 60, true}, 

15 {"Norway", "Oslo", 4.5, true}, 

16 {"India", "New Delhi", 1046, true} 

17 }; 
18 

19 // Create a table 

20 private JTable jTablel = new JTable(data, columnNames); 
21 

22 public TestTabl e() { 

23 add(new JScrollPane(jTablel)) ; 

24 } 

25 } 

|p Note 

autoboxing Primitive type values such as 280 and true in line 10 are autoboxed into new Integer (280) 

and new Boolean (true). 

JTabl e is a powerful control with a variety of properties that provide many ways to cus- 
tomize tables. All the frequently used properties are documented in Figure 36.3. The 
autoResi zeMode property specifies how columns are resized (you can resize table columns 
but not rows). Possible values are: 

JTabl e . AUT0_RESIZE_0FF 

JTabl e.AUT0_RESIZE_LAST_C0LUMN 

JTabl e . AUTO_RESIZE_SUBSEQUENT_COLUMNS 

JTabl e.AUT0_RESIZE_NEXT_C0LUMN 

JTabl e . AUT0_RESIZE_ALL_C0LUMNS 

The default mode is JTabl e.AUTO_RESIZE_SUBSEQUENT_COLUMNS. Initially, each col- 
umn in the table occupies the same width (75 pixels). With AUT0_RESIZE_0FF, resizing a 
column does not affect the widths of the other columns. With AUT0_ 
RESIZE_LAST_COLUMN, resizing a column affects the width of the last column. With 
AUTO_RESIZE_SUBSEQUENT_COLUMNS, resizing a column affects the widths of all the 
subsequent columns. With AUTO_RESIZE_NEXT_COLUMN, resizing a column affects the 
widths of the next columns. With AUTO_RESIZE_ALL_COLUMNS, resizing a column affects 
the widths of all the columns. 

Listing 36.2 gives an example that demonstrates the use of several JTabl e properties. The 
example creates a table and allows the user to choose an Auto Resize Mode, specify the row 
height and margin, and indicate whether the grid is shown. A sample run of the program is 
shown in Figure 36.4. 
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row data 



create table 

scroll pane 

main method omitted 
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Figure 36.4 You can specify an autoresizing mode, the table's row height and row margin, and whether to show the 
grid in the table. 



Listing 36.2 TablePropertiesDemo. java 

1 import java.awt.*; 

2 import java.awt. event.*; 

3 import javax. swing.*; 

4 import javax. swing. event.*; 
5 

6 public class TablePropertiesDemo extends JApplet { 

7 // Create table column names 

8 private String [] columnNames = 

9 {"Country", "Capital", "Population in Millions", "Democracy"}; column names 
10 

11 // Create table data 

12 private Object[][] rowData = { 

13 {"USA" , "Washington DC", 280, true}, table data 

14 {"Canada", "Ottawa", 32, true}, 

15 {"United Kingdom", "London", 60, true}, 

16 {"Germany", "Berlin", 83, true}, 

17 {"France", "Paris", 60, true}, 

18 {"Norway", "Oslo", 4.5, true}, 

19 {"India", "New Delhi", 1046, true} 

20 >; 

21 

22 // Create a table 

23 private JTable jTablel = new DTable(rowData, columnNames); table 
24 

25 // Create two spinners 

26 private JSpinner jspiRowHeight = 

27 new J Spinner (new Spi nnerNumberModel (16 , 1, 50, 1)); spinners 

28 private JSpinner jspi RowMargi n = 

29 new JSpinner(new Spi nnerNumberModel (1 , 1, 50, 1)); 
30 

31 // Create a check box 

32 private JCheckBox jchkShowGrid = new JCheckBox("showGrid" , true); 

33 

34 // Create a combo box 

35 private JComboBox jcboAutoResi zeMode = new JComboBox(new String []{ combo box 

36 "AUTO RESIZE OFF", "AUTO RESIZE LAST COLUMN" , 

37 "AUT0J*ESIZE SUBSEQUENT^COLUMNS" , "AUTO RESIZE NEXT_COLUMN" , 

38 "AUTO_RESIZEJVLL„COLUMNS"}) ; 

39 

40 public Tabl eProperti esDemo() { create UI 

41 3 Panel panel 1 = new JPanelO; 

42 panel l.add(new JLabel ("rowHeight")) ; 

43 panell.add(jspiRowHeight) ; 
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panel 1. add (new JLabel ("rowMargin")) ; 
panell.add(jspiRowMargin) ; 
panell.add(jchkShowCrid) ; 

J Panel panel 2 = new ] Panel (); 

panel 2 . add(new JLabel ("autoResizeMode")) ; 

panel 2 . add(jcboAutoResi zeMode) ; 

add(panell, BorderLayout . SOUTH) ; 
add(pane!2, BorderLayout . NORTH) ; 
add(new JScroll Pane(jTablel)) ; 

// Initialize jTablel 

jTabl el . setAutoResi zeMode (JTabl e . AUT0_RESIZE_0FF) ; 
jTabl el . setGri dCol or (Col or . BLUE) ; 

jTabl el . setSel ecti onMode (Li stSel ecti onModel . SINCLE_SELECTION) ; 
jTabl el . setSel ecti onBackg round (Col or . RED) ; 
jTabl el. setSel ecti onForeg round (Col or .WHITE) ; 

// Register and create a listener for jspiRowHeight 
jspiRowHeight.addChangeListener(new ChangeLi stener() { 
public void stateChanged(ChangeEvent e) { 
jTabl el. setRowHei ght ( 

((Integer) (jspi RowHei ght . getVal ue())) . i ntVal ue()) ; 

} 

}); 

// Register and create a listener for jspiRowMargin 
jspiRowMargin.addChangeListener(new ChangeLi stener() { 
public void stateChanged(ChangeEvent e) { 
jTabl el. setRowMargi n ( 

((Integer) (jspi RowMargi n . getVal ue())) . i ntVal ue()) ; 

} 

}); 

// Register and create a listener for jchkShowGrid 
jchkShowGrid.addActionListener(new ActionLi stener() { 
public void acti onPerformed(Acti onEvent e) { 
jTabl el. setShowGri d ( jchkShowCri d . i sSel ected() ) ; 

} 

}); 

// Register and create a listener for jcboAutoResizeMode 
jcboAutoResizeMode.addActionListener(new ActionLi stener() { 
public void actionPerformed(ActionEvent e) { 
String selectedltem = 

(Stri ng) j cboAutoResi zeMode . getSel ectedltem() ; 

i f (sel ectedltem . equal s("AUT0 RESIZE OFF")) 

jTabl el . setAutoResi zeMode (JTabl e . AUT0_RESIZE_0FF) ; 
else if (sel ectedltem. equals ("AUTO RESIZE LAST_COLUMN")) 

jTabl el . setAutoResi zeMode (JTabl e . AUT0_RESIZE_LAST_C0LUMN) ; 
else if (sel ectedltem . equal s 

("AUTO RESIZE SUBSEQUENT COLUMNS")) 

jTabl el . setAutoResi zeMode ( 

JTabl e.AUTO_RESIZE_SUBSEQUENT_COLUMNS) ; 
else if (sel ectedltem. equals ("AUTO RESIZE NEXT COLUMN")) 

jTabl el . setAutoResi zeMode (JTabl e . AUT0_RESIZE_NEXT_C0LUMN) ; 
else if (sel ectedltem. equals ("AUTO RESIZE ALL COLUMNS")) 

jTabl el . setAutoResi zeMode (JTabl e . AUT0_RESIZE_ALL_C0LUMNS) ; 
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104 } 

105 }); 

106 } 

107 } main method omitted 

If you know the row data in advance, creating a table using the constructor DTable- 
(Object[][] rowData, Object[] col umnNames) is convenient. As shown in line 23, 
a JTabl e is created using this constructor. 

Two JSpinner objects (jspiRowHeight, jspiRowMargin) for selecting row height 
and row margin are created in lines 26-29. The initial value for jspiRowHeight is set to 16, 
which is the default property value for rowHeight. The initial value for jspiRowMargin is 
set to 1, which is the default property value for rowMargin. A check box (jchkShowCrid) 
is created with label showCrid and initially selected in line 32. A combo box for selecting 
autoResizeMode is created in lines 35-38. 

The values of the JTable properties (autoResizeMode, gridColor, selectionMode, 
selectionBackground, and selectionForeground) are set in lines 57-61. 

The code for processing spinners, check boxes, and combo boxes is given in lines 64-106. 



36.3 Table Models and Table Column Models 

JTabl e delegates data storing and processing to its table data model. A table data model must im- 
plement the Tabl eModel interface, which defines the methods for registering table model listen- Tab! eModel 
ers, manipulating cells, and obtaining row count, column count, column class, and column name. 

The AbstractTabl eModel class provides partial implementations for most of the meth- AbstractTabl eModel 
ods in Tabl eModel . It takes care of the management of listeners and provides some conve- 
niences for generating Tabl eModel Events and dispatching them to the listeners. To create a 
concrete Tabl eModel, you simply extend AbstractTabl eModel and implement at least 
the following three methods: 

■ public int getRowCountO 

■ public int getCol umnCountO 

■ public Object getVal ueAt(int row, int column) 

The Defaul tTabl eModel class extends AbstractTabl eModel and implements these Defaul tTabl eModel 

three methods. Additionally, Defaul tTabl eModel provides concrete storage for data. The 
data are stored in a vector. The elements in the vector are arrays of objects, each of which rep- 
resents an individual cell value. The methods in Defaul tTabl eModel for accessing and 
modifying data are shown in Figure 36.5. 

Listing 36.3 gives an example that demonstrates table models. The example creates a table 
model (line 16), plugs the model to the table (line 20), appends a row to the table (line 25), in- 
serts a row before the first row (line 26), removes a row with index 1 (line 28), adds a new col- 
umn (line 29), and sets new values at specified cells (lines 30-32). Figure 36.6 shows the 
output of the program. 

Listing 36.3 TestTabl eModel . java 

1 import javax. swi ng . * ; 

2 import javax. swi ng . tabl e . * ; 
3 

4 public class TestTabl eModel extends JApplet { 

5 // Create table column names 

6 private String [] col umnNames = 

7 {"Country", "Capital", "Population in Millions", "Democracy"}; 
8 

9 // Create table data 
10 private Object[][] data = { 



column names 



row data 
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14 
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31 
32 
33 

34 } 



{"USA", "Washington DC", 280, true}, 
{"Canada", "Ottawa", 32, true} 



}; 



// Create a model 

private Def aul tTabl eModel tableModel = 
new Def aul tTabl eModel (data, col umnNames) ; 



// Create a table 
private JTable jTablel 



new ITabl e (tabl eModel ) ; 



public TestTabl eModel () { 

add(new IScrollPane(jTablel)) ; 

tabl eModel .addRow(new Object [] {"France" , 
tabl eModel . i nsertRow(0 , new 0bject[] 

{"India", "New Delhi", 1046, true}); 
tabl eModel . removeRow(l) ; 
tableModel . addCol umn("Area") ; 
tableModel . setVal ueAt(10, 0, 4); 
tableModel . setVal ueAt(20, 1, 4): 
tableModel . setVal ueAt(30, 2, 4); 



"Paris", 60, true}); 



«interface» 
javax.swing. table. TableModel 



javax. swing. tabl e . AbstractTabl eModel 



+getColumnClass(columnIndex: int): Class 
+getColumnName(columnIndex: int): String 
+getCol umnCountO : int 
+getRowCount() : int 

+getValueAt(rowIndex: int, columnlndex: int): 
Object 

+setValueAt(aValue: Object, rowlndex: 

int, columnlndex: int): void 
+isCell Editable (rowlndex: int, columnlndex: 

int): boolean 
+addTabl eModel Listener(l : 

Tabl eModel Li stener) : void 
+removeTabl eModel Li stener (1 : 

Tabl eModel Li stener) : void 



javax.swing.table.DefaultTableModel 



+Def aul tTabl eModel () 

+Defaul tTabl eModel (rowCount: int, columnCount: int) 
+Defaul tTabl eModel (col umnNames: 0bject[], rowCount: int) 
+Defaul tTabl eModel (data: 0bject[][], columnNames: 0bject[]) 
+Defaul tTabl eModel (col umnNames: Vector, rowCount: int) 
+Defaul tTabl eModel (data: Vector, columnNames: Vector) 
+Defaul tTabl eModel (rowData: Vector, columnNames: Vector) 
+addColumn(columnName: Object): void 
+addColumn(columnName: Object, columnData: Vector) 
+addRow(rowData: 0bject[]): void 
+addRow(rowData: Vector): void 
+getCol umnCountO : i nt 
+getDataVector() : Vector 
+getRowCount() : int 

+i nsertRow(row: int, rowData: 0bject[]): void 

+i nsertRow(row: int, rowData: Vector): void 

+removeRow(row: int): void 

+setCol umnCount(col umnCount : int): void 

+setColumnIdentifiers(newIdentifiers: 0bject[]): void 

+setColumnIdentifiers(columnIdentifiers: Vector): void 

+setDataVector(dataVector: 0bject[][], columnldentifiers: 
0bject[]): void 

+setDataVector(dataVector: Vector, columnldentifiers: Vector): 
void 

+setRowCount(rowCount : int): void 



Figure 36.5 Tabl eModel stores and manages data in a table and Def aul tTabl eModel provides a default imple- 
mentation for Tabl eModel . 
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Figure 36.6 Tabl eModel and Def aul tTabl eModel contain the methods for adding, up- 
dating, and removing table data. 



Tabl eModel manages table data. You can add and remove rows through a Tabl eModel . 
You can also add a column through a Tabl eModel . However, you cannot remove a column 
through a Tabl eModel . To remove a column from a JTabl e, you have to use a table column 
model. 

Table column models manage columns in a table. They can be used to select, add, move, 
and remove table columns. A table column model must implement the Tabl eCol umnModel Tabl eCol umnModel 
interface, which defines the methods for registering table column model listeners, and for ac- 
cessing and manipulating columns, as shown in Figure 36.7. 



«interface» 
javax.swing.table.TableColumnModel 



+addColumn(aColumn: TableColumn) : void 
+getColumn(columnIndex: int): TableColumn 
+getColumnCount() : int 

+getColumnIndex(columnIdentifier: Object): int 

+getColumnMargin() : int 

+getCol umnsQ : Enumeration 

+getCol umnSel ecti onAll owed () : boolean 

+getSel ectedColumnCount() : int 

+getSelectedColumns() : void 

+getSel ecti onModel () : Li stSel ecti onModel 

+getTotalColumnWidth() : int 

+moveColumn(columnIndex: int, newlndex: int): void 
+ removeCo 1 umn (co 1 umn : TableCol umn ) : vo i d 
+setColumnMargin(newMargin: int): void 
+setColumnSel ecti onAll owed (flag: boolean): void 
+setSel ecti onModel (newModel : Li stSel ecti onModel ) : void 



^ javax . swi ng . tabl e . Def aul tTabl eCol umnModel 

Q javax . swi ng . tabl e . Tabl eCol umn | 



Figure 36.7 Tabl eCol umnModel manages columns in a table and Defaul tTabl eCol umnModel is a concrete imple- 
mentation of it. 



Defaul tTabl eCol umnModel is a concrete class that implements TableCol umnModel Def aul tTabl eCol umnModel 
and PropertyChangeListener. The Def aul tTabl eCol umnModel class stores its 
columns in a vector and contains an instance of ListSelectionModel for selecting 
columns. 

The column model deals with all the columns in a table. The Tabl eCol umn class is used Tabl eCol umn 
to model an individual column in the table. An instance of Tabl eCol umn for a specified col- 
umn can be obtained using the getCol umn (index) method in TableCol umnModel or the 
getColumn(columnldentifier) method in JTable. 

Figure 36.8 shows the properties, constructors, and methods in Tabl eCol umn for manip- 
ulating column width and specifying the cell Tenderer, cell editor, and header Tenderer. 

Listing 36.4 gives an example that demonstrates table column models. The example 
obtains the table column model from the table (line 21), moves the first column to the 
second (line 22), and removes the last column (lines 23). Figure 36.9 shows the output of 
the program. 
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javax.swing.table.TableColumn 



#cell Editor: TableCell Editor 
#cel 1 Renderer : TableCell Renderer 
#headerRenderer : TableCel 1 Renderer 
#headerVal ue : Object 
identifier: Object 
#maxWidth: int 
#minWidth: int 
#model Index: int 
#preferredWidth: int 
#resizable: boolean 
#width: int 



+TableColumn() 

+TableColumn(modelIndex: int) 
+TableColumn(modelIndex: int, width: int) 
+TableColumn (model Index: int, width: int, 

cellRenderer: TableCell Renderer) 
+sizeWidthToFit() : void 



JavaBeans properties with get and set 
methods omitted in the UML diagram. 



The editor for editing a cell in this column. 

The renderer for displaying a cell in this column. 

The renderer for displaying the header of this column. 

The header value of this column. 

The identifier for this column. 

The maximum width of this column. 

The minimum width of this column (default: 15 pixels). 

The index of the column in the table model (default: 0). 

The preferred width of this column (default: 75 pixels). 

Indicates whether this column can be resized (default: true). 

Specifies the width of this column (default: 75 pixels). 

Constructs a default table column. 
Constructs a table column for the specified column. 
Constructs a table column with the specified column and width. 
Constructs a table column with the specified column, width, and 
cell renderer. 
Resizes the column to fit the width of its header cell. 



Figure 36.8 The Tabl eCol umn class models a single column. 
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Figure 36.9 Tabl eCol umnModel contains the methods for moving and removing columns. 



Listing 36.4 TestTableCol umnModel . java 
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row data 



create table 
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import javax. swi ng . * ; 
import javax. swi ng . tabl e . * ; 

public class TestTabl eCol umnModel extends JApplet { 
// Create table column names 
private String [] columnNames = 

{"Country", "Capital", "Population in Millions", "Democracy"}; 

// Create table data 
private 0bject[][] data = { 

{"USA", "Washington DC", 280, true}, 

{"Canada", "Ottawa", 32, true} 

}; 

// Create a table 

private JTable jTablel = new ]Table(data, columnNames); 

public TestTabl eCol umnModel () { 
add(new IScrollPane(jTablel)) ; 

Tabl eCol umnModel col umnModel = jTabl el. getCol umnModel () ; 
col umnModel .moveCol umn (0, 1); 
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23 col umnModel . removeColumn (col umnModel .getColumn(j)) ; remove a column 

24 } 

2 5 } main method omitted 



|j| Note 

Some of the methods defined in the table model and the table column model are also defined in 
the JTabl e class for convenience. For instance, the getColumnCountO method is defined in 
JTabl e, TableModel, and Tab! eCol umnModel , the addColumn method defined in the 
column model is also defined in the table model, and the getColumnO method defined in the 
column model is also defined in the JTabl e class. 

JTabl eHeader is a GUI component that displays the header of the JTabl e (see Figure 36. 10). Tabl eHeader 
When you create a JTabl e, an instance of JTabl eHeader is automatically created and stored 
in the tabl eHeader property. By default, you can reorder the columns by dragging the header 
of the column. To disable it, set the reorder! ngAl lowed property to fal se. 



javax . swi ng . JComponent 



j avax.s wing.table. JTableHeader 



#col umnModel : Tabl eCol umnModel 
#draggedCol umn : TableColumn 
#draggedDi stance : Tabl eCel 1 Renderer 
#reorderi ngAl lowed: boolean 
#resizingAl lowed: boolean 
#resizingColumn: TableColumn 
#table: JTabl e 



+JTabl eHeader() 

+ JTabl eHeader (cm : Tabl eCol umnModel ) 



The Tabl eCol umnModel of the table header. 
The column being dragged. 

The distance from its original position to the dragged position. 
Whether reordering of columns is allowed (default: true). 
Whether resizing of columns is allowed (default: true). 
The column being resized. 
The table for which this object is the header. 

Constructs a JTabl eHeader with a default Tabl eCol umnModel . 
Constructs a JTableHeader with a TableCol umnModel. 



Figure 36.10 The JTabl eHeader class displays the header of the JTabl e. 



36.4 Auto Sort and Filtering 

Auto sort and filtering are two useful features. To enable auto sort on any column in a 
JTabl e, create an instance of TableRowSorter with a table model and set JTabl e's 
rowSorter as follows: 

TableRowSorter<TableModel> sorter = create a Tabl eRowSorter 

new TableRowSorter<TableModel>(tableModel) ; 
jTabl e . setRowSorter(sorter) ; setRowSorter 

When the table is displayed, you can sort the table by clicking a column head, as shown in 
Figure 36.11. 

You can specify a filter to select rows in the table. The filter can be applied on one column 
or all columns. The j avax . swi ng . RowFi 1 ter class contains several static methods for cre- 
ating filters. You can use the regexFil ter method to create a RowFi 1 ter with the specified 
regular expression. For example, the following statement creates a filter for the rows whose 
first column or second column begin with letter U. 



RowFilter rowFilter = RowFil ter . regexFi 1 ter("U . *" , int[]{0, 1}) ; 



create a filter 
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(a) (b) 
Figure 36.1 1 (a) The table is sorted on Country, (b) The table is sorted on Capital. 



set filter in JTabl e 



column names 



row data 



create table 



create Tab! eRowSorter 



set sorter 



The second argument in the regexFil ter method specifies a set of column indices. If no 
indices are specified, all columns are searched in the filter. 

To enable filtering, you have to associate a filter with a Tabl eRowSorter, which is set to 
the JTable's rowSorter property. 

Listing 36.5 gives an example that demonstrates auto sort and filtering in JTabl e. 

Listing 36.5 TestTableSortFilter. java 



1 

2 
3 
4 
5 
6 
7 
8 
9 
10 
11 
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14 
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23 
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25 
26 
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import javax. swi ng . * ; 
import javax. swi ng . tabl e . * ; 
import java.awt.BorderLayout; 

public class TestTableSortFilter extends DApplet { 
// Create table column names 
private String [] columnNames = 

{"Country", "Capital", "Population in Millions", "Democracy"}; 

// Create table data 
private 0bject[][] data = { 

{"USA", "Washington DC", 280, true}, 

{"Canada", "Ottawa", 32, true}, 

{"United Kingdom", "London", 60, true}, 

{"Germany", "Berlin", 83, true}, 

{"France", "Paris", 60, true}, 

{"Norway", "Oslo", 4.5, true}, 

{"India", "New Delhi", 1046, true} 

}; 



// Create a table 
private JTable jTablel 



new JTable(data, columnNames); 



// Create a Tabl eRowSorter 

private TableRowSorter<TableModel> sorter = 

new TableRowSorter<TableModel>(jTablel.getModel ()) ; 

private JTextField jtfFilter = new JTextFi el d() ; 
private JButton btFilter = new JButton("Filter") ; 

public TestTableSortFilterO { 

// Enable auto sorter 
jTablel. setRowSorter(sorter) ; 

JPanel panel = new JPanel(new java.awt.BorderLayoutO) ; 
panel . add (new ] Label ("Specify a word to match:"), 

BorderLayout .WEST) ; 
panel . add(jtf Fi 1 ter , BorderLayout . CENTER) ; 
panel . add(btFi 1 ter , BorderLayout . EAST) ; 
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40 

41 adcKpanel , BorderLayout . SOUTH) ; 

42 add(new JScronPane(jTablel) , BorderLayout . CENTER) ; 
43 

44 btF"Mter.addAct"ionListener(new java.awt. event. ActionLi stenerO { 

45 public void actionPerformed(java.awt. event. ActionEvent e) { 

46 String text = jtfFilter.getTextO ; 

47 if (text. trim() .length () == 0) 

48 sorter. setRowFi "I ter (null ) ; remove filter 

49 else 

50 sorter. setRowFilter(RowFi~lter. regexFilter(text)) ; setafilter 

51 } 

52 }); 

53 } 

54 } main method omitted 



The example creates a TableRowSorter (line 25) and sets the sorter in jTablel (line 33). 
The program lets the user enter a filter pattern from a text field, as shown in Figure 36.12. If 
nothing is entered, no filter is set (line 48). If a regex is entered, clicking the Filter button sets 
the filter to jTabl el (line 50). 
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(a) (b) 
Figure 36.12 (a) Filter the table with regex U . *. (b) Filter the table with regex w. 



36.5 Case Study: Modifying Rows and Columns 

This case study demonstrates the use of table models, table column models, list- selection 
models, and the Tabl eCol umn class. The program allows the user to choose selection mode 
and selection type, add or remove rows and columns, and save, clear, or restore the table, as 
shown in Figure 36.13(a). 

The Add New Row button adds a new empty row before the currently selected row, as 
shown in Figure 36.13(b). If no row is currently selected, a new empty row is appended to the 
end of the table. 
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(a) (b) 
Figure 36.13 You can add, remove, and modify rows and columns in a table interactively. 
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When you click the Add New Column button, an input dialog box is displayed to receive 
the title of the column, as shown in Figure 36.14(a). The new column is appended in the table, 
as shown in Figure 36.14(b). 
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Figure 36.14 You can add a new column in a table. 



(b) 
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The Delete Selected Row button deletes the first selected row. The Delete Selected Column 
button deletes the first selected column. 

The Save button saves the current table data and column names. The Clear button clears 
the row data in the table. The Restore button restores the saved table. 

Listing 36.6 gives the program. 



Listing 36.6 Modify Table, java 



i 

2 
3 
4 
5 
6 
7 

8 public class Modify Table extends J Applet { 

9 // Create table column names 
private String [] columnNames = 

{"Country", "Capital", "Population in Millions", 



10 
11 
12 
13 
14 
15 
16 
17 
18 
19 
20 
21 
22 
23 
24 
25 
26 
27 
28 
29 



import java.awt.*; 

import java.awt. event.-; 

import javax. swing.-; 

import javax. swing. table, 

import java.io.'-; 

import java. util .Vector; 



"Democracy"} ; 



// Create table data 

private Object[][] rowData = { 

{"USA", "Washington DC", 280, true}, 
{"Canada", "Ottawa", 32, true}, 
{"United Kingdom", "London", 60, true}, 
{"Germany", "Berlin", 83, true}, 
{"France", "Paris", 60, true}, 
{"Norway", "Oslo", 4.5, true}, 
{"India", "New Delhi", 1046, true} 



}; 

// Create a table model 
private Defaul tTabl eModel 
rowData, columnNames); 



tabl eModel = new Defaul tTabl eModel ( 



// Create a table 

private liable jTablel = new JTabl e (tabl eModel ) ; 
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30 

31 // Create buttons 

32 private JButton jbtAddRow = new 3 Button ("Add New Row"); buttons 

33 private JButton jbtAddColumn = new DButton("Add New Column"); 

34 private JButton jbtDeleteRow = new D Button ("Delete Selected Row"); 

35 private JButton jbtDeleteColumn = new DButton( 

36 "Delete Selected Column") ; 

37 private JButton jbtSave = new JButton("Save") ; 

38 private DButton jbtClear = new JButton("Clear") ; 

39 private JButton jbtRestore = new JButton("Restore") ; 
40 

41 // Create a combo box for selection modes 

42 private JComboBox jcboSelectionMode = combobox 

43 new JComboBox(new String [] {"SINGLE SELECTION" , 

44 "SINGLE_INTERVAL_SELECTION" , "MULTIPLE INTERVAL SELECTION"}) ; 
45 

46 // Create check boxes 

47 private JCheckBox jchkRowSelectionAllowed = checkboxes 

48 new JCheckBox("RowSelectionAllowed" , true); 

49 private JCheckBox jchkColumnSelectionAllowed = 

50 new JCheckBox("ColumnSelectionAllowed" , false); 
51 

52 public ModifyTableO { 

53 J Panel panel 1 = new DPanelO; create UI 

54 panel 1. setLayout(new Cri dLayout(2 , 2)); 

55 panel 1. add (jbtAddRow) ; 

56 panell.add(jbtAddColumn) ; 

57 panell.add(jbtDeleteRow) ; 

58 panell.add(jbtDeleteColumn) ; 
59 

60 J Panel panel 2 = new JPanelO; 

61 panel 2 . add(jbtSave) ; 

62 panel 2 . add(jbtCl ear) ; 

63 panel 2 . add(jbtRestore) ; 
64 

65 JPanel panel 3 = new JPanelO; 

66 panel 3 . setLayout(new BorderLayout(5 , 0)); 

67 panel 3 . add (new JLabel ("Selection Mode"), BorderLayout .WEST) ; 

68 panel 3 . add(jcboSel ecti onMode , BorderLayout. CENTER) ; 
69 

70 J Panel panel 4 = new DPanelO; 

71 panel 4 . setLayout(new FlowLayout(FlowLayout.LEFT)) ; 

72 panel4.add(jchkRowSelectionAllowed) ; 

73 panel4.add(jchkColumnSelectionAllowed) ; 
74 

75 JPanel panel 5 = new JPanelO; 

76 panel 5 . setLayout(new Cri dLayout(2 , 1)); 

77 panel 5 . add(panel 3) ; 

78 panel 5 . add(panel 4) ; 
79 

80 J Panel panel 6 = new JPanelO; 

81 panel 6 . setLayout(new BorderLayoutO) ; 

82 panel 6 . add(panel 1 , BorderLayout . SOUTH) ; 

83 panel 6 . add(panel 2 , BorderLayout . CENTER) ; 
84 

85 add(pane!5, BorderLayout . NORTH) ; 

86 add(new D Scroll Pane (jTabl el) , 

87 BorderLayout . CENTER) ; 

88 add(panel6, BorderLayout . SOUTH) ; 
89 
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add row 



add column 



delete row 



delete column 



save table 
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restore table 



90 
91 
92 
93 
94 
95 
96 
97 
98 
99 
100 
101 
102 
103 
104 
105 
106 
107 
108 
109 
110 
111 
112 
113 
114 
115 
116 
117 
118 
119 
120 
121 
122 
123 
124 
125 
126 
127 
128 
129 
130 
131 
132 
133 
134 
135 
136 
137 
138 
139 
140 
141 
142 
143 
144 
145 
146 
147 
148 
149 



// Initialize table selection mode 

jTablel.setSelectionMode(ListSelectionModel . SINCLE_SELECTION) ; 

jbtAddRow.addActionListener(new ActionLi stenerO { 
public void acti onPerformed(Acti onEvent e) { 
if (jTablel.getSelectedRowfJ >= 0) 

tableModel . i nsertRow ( jTabl el. getSel ectedRowO , 
new java.util .VectorO) ; 

el se 

tableModel .addRow(new java.util .VectorO) ; 

} 

}); 

jbtAddColumn.addActionListener(new ActionLi stenerO { 
public void acti on Performed (Acti onEvent e) { 

String name = JOptionPane.showInputDialogC'New Column Name"); 
tableModel .addColumn (name, new java.util .VectorO) ; 

} 

}); 

jbtDeleteRow.addActionListener(new ActionLi stenerO { 
public void acti onPerformed(Acti onEvent e) { 
if (jTablel.getSelectedRow() >= 0) 

tableModel . removeRow(jTablel.getSelectedRowO) ; 

} 

}); 

jbtDeleteColumn.addActionListener(new ActionLi stenerO { 
public void actionPerformed(ActionEvent e) { 
if (jTablel.getSelectedColumn() >= ) { 

Tabl eCol umnModel columnModel = jTablel.getColumnModel () ; 
TableColumn tableColumn = 

col umnModel . getCol umn (jTabl el . getSel ectedCol umn ()) ; 
col umnModel . removeCol umn (tabl eCol umn) ; 

} 

} 

}); 

jbtSave.addActionListener(new Acti onLi stenerO { 
public void acti onPerformed(Acti onEvent e) { 
try { 

ObjectOutputStream out = new 0bject0utputStream( 

new FileOutputSt ream ("tabl emodel .dat")) ; 
out.writeObject(tableModel .getDataVectorO) ; 
out . wri teObject (getCol umnNames ()) ; 
out.closeO ; 

} 

catch (Exception ex) { 
ex. pri ntStackTrace() ; 

} 

} 

}); 

jbtClear.addActionListener(new Acti onLi stenerO { 
public void acti onPerformed(Acti onEvent e) { 
tableModel . setRowCount(O) ; 

} 

}); 

jbtRestore.addActionListener(new Acti onLi stenerO { 
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150 public void acti onPerformed(Acti onEvent e) { 

151 try { 

152 ObjectlnputStream in = new ObjectInputStream( 

153 new FileInputStream("tablemodel .dat")) ; 

154 Vector rowData = (Vector)in. readObjectO ; 

155 Vector col umnNames = (Vector)i n . readObjectO ; 

156 tableModel . setDataVector(rowData, col umnNames) ; 

157 in.closeO; 

158 } 

159 catch (Exception ex) { 

160 ex.printStackTraceO ; 

161 } 

162 } 

163 }); 
164 

165 jchkRowSelectionAllowed.addActionListener(new Acti onLi stenerO { row selection allowed 

166 public void acti onPerformed (Acti onEvent e) { 

167 jTabl el. setRowSel ecti onAl 1 owed ( 

168 jchkRowSelectionAllowed.isSelectedO) ; 

169 } 

170 }); 
171 

172 j chkCol umnSel ecti onAl 1 owed . addActi on Li stener ( column selection allowed 

173 new ActionLi stenerO { 

174 public void acti onPerformed(Acti onEvent e) { 

175 jTabl el. setCol umnSel ecti onAl 1 owed ( 

176 jchkColumnSelectionAllowed.isSelectedO) ; 

177 } 

178 }); 
179 

180 jcboSelectionMode.addActionListener(new Acti onLi stenerO { choose selection mode 

181 public void acti onPerformed(Acti onEvent e) { 

182 String selectedltem = 

183 (String) jcboSelectionMode.getSelectedltemO ; 
184 

185 if (selectedltem. equals("SINGLE_SELECTION")) 

186 jTabl el. setSel ecti onMode( 

187 Li stSel ecti onModel . SINCLE„SELECTION) ; 

188 else if (selectedltem. equals ("SINGLE INTERVAL SELECTION")) 

189 jTabl el. setSel ecti onMode( 

190 Li stSel ecti onModel . SINGLE_INTERVAL_SELECTION) ; 

191 else if (selectedltem. equals ("MULTIPLE INTERVAL SELECTION")) 

192 jTablel.setSelectionMode( 

193 Li stSel ecti onModel . MULTIPLE_INTERVAL_SELECTION) ; 

194 } 

195 }); 

196 } 
197 

198 private Vector getCol umnNames () { get column names 

199 Vector<Stri ng> col umnNames = new Vector<Stri ng>() ; 
200 

201 for (int i = 0; i < jTablel.getColumnCount() ; i++) 

202 columnNames.add(jTablel.getColumnName(i) ) ; 
203 

204 return col umnNames; 

205 } 

206 } main method omitted 



A table model is created using Def aul tTabl eModel with row data and column names (lines 
25-26). This model is used to create a JTabl e (line 29). 
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The GUI objects (buttons, combo box, check boxes) are created in lines 32-50 and are 
placed in the UI in lines 53-88. 

The table-selection mode is the same as the list- selection mode. By default, the selection 
mode is MULTIPLE_INTERVAL_SELECTION. To match the initial value in the selection 
combo box (jcboSel ectionMode), the table's selection mode is set to 
SINGLE_SELECTION. 

The Add New Row button action is processed in lines 93-101. The i nsertRow method in- 
serts a new row before the selected row (lines 96-97). If no row is currently selected, the 
addRow method appends a new row into the table model (line 99). 

The Add New Column button action is processed in lines 103-108. The addColumn 
method appends a new column into the table model (line 106). 

The Delete Selected Row button action is processed in lines 110-115. The 
removeRow(rowIndex) method removes the selected row from the table model (line 113). 

The Delete Selected Column button action is processed in lines 1 17-126. To remove a col- 
umn, you have to use the removeCol umn method in Tabl eCol umnModel (line 123). 

The Save button action is processed in lines 128-141. It writes row data and column names 
to an output file using object stream (lines 133-134). The column names are obtained using 
the getCol umnNamesO method (lines 198-205). You may attempt to save tableModel, 
because tableModel is an instance of Defaul tTabl eModel (lines 25-26) and 
Defaul tTableModel is serializable. However, tableModel may contain nonserializable 
listeners for Tabl eModel event. 

The Clear button action is processed in lines 143-147. It clears the table by setting the row 
count to (line 145). 

The Restore button action is processed in lines 149-163. It reads row data and column 
names from the file using object stream (lines 154-155) and sets the new data and column 
names to the table model (line 156). 

36.6 Table Renderers and Editors 

Table cells are painted by cell renderers. By default, a cell object's string representation 
(toStringO) is displayed and the string can be edited as it was in a text field. JTabl e main- 
tains a set of predefined renderers and editors, listed in Table 36.1, which can be specified to 
replace default string renderers and editors. 

Table 36.1 Predefined renderers and editors for tables 

Class Renderer Editor 

Object J Label (left aligned) JTextField 

Date J Label (right aligned) JText Field 

Number 3 Label (right aligned) JTextField 

Imagelcon J Label (center aligned) 

Boolean JCheckBox (center aligned) JCheckBox (center aligned) 

The predefined renderers and editors are automatically located and loaded to match the 
class returned from the getCol umnCl ass() method in the table model. To use a predefined 
renderer or editor for a class other than Stri ng, you need to create your own table model by 
extending a subclass of Tabl eModel . In your table model class, you need to override the 
getCol umnCl ass () method to return the class of the column, as follows: 

public Class getCol umnCl ass (int column) { 
return getVal ueAt(0 , col umn) . getCl ass() ; 

} 
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By default, all cells are editable. To prohibit a cell from being edited, override the 
isCellEditable(int rowlndex, int col umnlndx) method in Tabl eModel to return 
fal se. By default, this method returns true in AbstractTabl eModel . 

To demonstrate predefined table renderers and editors, let us write a program that displays 
a table for books. The table consists of three rows with the column names Title, Copies Need- 
ed, Publisher, Date Published, In-Stock, and Book Photo, as shown in Figure 36.15. Assume 
that dates and icons are not editable; prohibit users from editing these two columns. 
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Figure 36.15 You need to use a custom table model to enable predefined renderers for 
Boolean and image cells. 

Listing 36.7 gives a custom table model named MyTabl eModel that overrides the 
getCol umnCl ass method (lines 15-17) to enable predefined renderers for Boolean and 
image cells. MyTabl eModel also overrides the isCell EditableO method (lines 20-24). 
By default, isCell EditableO returns true. The example does not allow the user to edit 
image icons and dates, so this method is overridden to return fal se to disable editing of date 
and image columns. For a cell to be editable, isCell EditableO in the table model must 
be true. 

Listing 36.7 MyTabl eModel . j ava 

1 import javax. swi ng . * ; 

2 import javax. swi ng . tabl e . * ; 

3 import java.util.*; 
4 

5 public class MyTabl eModel extends Defaul tTabl eModel { 

6 public MyTabl eModel () { 

7 } 
8 

9 /** Construct a table model with specified data and columnNames */ 

10 public MyTabl eModel (Object [] [] data, Object[] columnNames) { 

11 super(data, columnNames); 

12 } 
13 

14 /** Override this method to return a class for the column */ 

15 public class getColumnClass(int column) { column class 

16 return getVal ueAt(0 , column) .getClassO ; 

17 } 
18 

19 /** Override this method to return true if cell is editable */ 

20 public boolean isCellEditable(int row, int column) { cell editable? 

21 Class columnClass = getCol umnCl ass (col umn) ; 

22 return columnClass != Imagelcon .class && 

23 columnClass != Date. class; 

24 } 

25 } 

If you create a JTabl e using a table model created from MyTabl eModel , the default render- 
ers and editors for numbers, Boolean values, dates, and icons are used to display and edit 



1244 Chapter 36 JTable and JTree 



column names 



image icons 



row data 



table model 



table 



these columns. Listing 36.8 gives a test program. The program creates a table model using 
MyTabl eModel (line 36). JTabl e assigns a predefined cell Tenderer and a predefined editor 
to the cell, whose class is specified in the getColumnClassO method in MyTabl eModel . 

Listing 36.8 TableCellRendererEditorDemo. java 



main method omitted 



1 
2 
3 
4 
5 
6 
7 
8 
9 
10 
11 
12 
13 
14 
15 
16 
17 
18 
19 
20 
21 
22 
23 
24 
25 
26 
27 
28 
29 
30 
31 
32 
33 
34 
35 
36 
37 
38 
39 
40 
41 
42 
43 
44 
45 
46 
47 



import java.awt.*; 
import javax. swi ng . * ; 
import java.util.*; 

public class TableCellRendererEditorDemo extends JApplet { 
// Create table column names 
private String [] columnNames = 

{"Title", "Copies Needed", "Publisher", "Date Published", 
"In-stock", "Book Photo"}; 

// Create image icons 

private Imagelcon i ntrolelmagelcon = new Imagelcon ( 
getClassO .getResource("image/introle.gif")) ; 

private Imagelcon i ntro2eImageIcon = new ImageIcon( 
getClassO .getResource("image/intro2e.gif")) ; 

private Imagelcon i ntro3eImageIcon = new ImageIcon( 
getClassO .getResource("image/intro3e. jpg")) ; 

// Create table data 

private 0bject[][] rowData = { 

{"Introduction to Java Programming", 120, 
"Que Education & Training", 
new CregorianCalendar(1998, 1-1, 6) .getTimeO , 
false, i ntrolelmagelcon} , 
{"Introduction to Java Programming, 2E", 220, 
"Que Education & Training", 
new CregorianCalendar(1999, 1-1, 6) .getTimeO , 
false, i ntro2eImageIcon} , 
{"Introduction to Java Programming, 3E", 220, 
"Prentice Hall", 

new CregorianCalendar(2000, 12-1, 0). getTimeO, 
true, i ntro3eImageIcon} , 



}; 



// Create a table model 
private MyTabl eModel tabl eModel 
rowData, columnNames); 



new MyTabl eModel ( 



// Create a table 
private JTable jTablel 



new ITabl e(tabl eModel ) ; 



public Tabl eCel 1 RendererEdi torDemoO { 
jTablel. setRowHei ght(60) ; 
add(new IScrollPane(jTablel) , 
BorderLayout. CENTER) ; 

} 



The example defines two classes: MyTabl eModel and TableCellRendererEditorDemo. 
MyTabl eModel is an extension of Def aul tTabl eModel . The purpose of MyTabl eModel is 

to override the default implementation of the getCol umnCl ass() method to return the class 
of the column, so that an appropriate predefined JTabl e can be used for the column. By de- 
fault, getColumnClassO returns Object. class. 
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36.7 Custom Table Renderers and Editors 

Predefined renderers and editors are convenient and easy to use, but their functions are limited. 
The predefined image icon Tenderer displays the image icon in a label. The image icon cannot 
be scaled. If you want the whole image to fit in a cell, you need to create a custom Tenderer. 

A custom Tenderer can be created by extending the Def aul tTabl eCel 1 Renderer, which 
is a default implementation for the Tabl eCel 1 Renderer interface. The custom renderer must 
override the getTabl eCel 1 RendererComponent method to return a component for render- 
ing the table cell. The getTabl eCell RendererComponent method is defined as follows: 

public Component getTabl eCell RendererComponent 
(JTable table, Object value, boolean isSelected, 
boolean is Focused, int row, int column) 

This method signature is very similar to the getListCell RendererComponent method 
used to create custom list cell renderers. 

This method is passed with a JTabl e, the value associated with the cell, information regarding 
whether the value is selected and whether the cell has the focus, and the row and column indices of 
the value. The component returned from the method is painted on the cell in the table. The class in 
Listing 36.9, MylmageCel 1 Renderer, defines a renderer for displaying image icons in a panel. 

Listing 36.9 MylmageCel 1 Rende re r . j ava 



1 

2 
3 
4 
5 
6 
7 
8 
9 
10 
11 
12 
13 
14 
15 



import javax. swi ng . * ; 
import javax. swi ng . tabl e . * ; 
import java.awt.*; 

public class MylmageCel 1 Renderer extends DefaultTableCellRenderer 

/** Override this method in DefaultTableCellRenderer */ 
public Component getTabl eCell RendererComponent 

(DTable table, Object value, boolean isSelected, 
boolean isFocused, int row, int column) { 
Image image = ((Imagelcon)val ue) .getlmageO ; 
ImageViewer imageViewer = new ImageVi ewe r(i mage) ; 



return imageViewer; 



} 



You can also create a custom editor. JTabl e provides the Def aul tCel 1 Edi tor class, which 
can be used to edit a cell in a text field, a check box, or a combo box. To use it, simply create 
a text field, a check box, or a combo box, and pass it to Def aul tCel 1 Edi tor's constructor 
to create an editor. 

Using a custom renderer and editor, the preceding example can be revised to display scaled 
images and to use a custom combo editor to edit the cells in the Publisher column, as shown 
in Figure 36.16. The program is given in Listing 36.10. 
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Figure 36.16 A custom renderer displays a scaled image, and a custom editor edits the 
Publisher column using a combo box. 
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Listing 36.10 CustomTabl eCel 1 RendererEdi torDemo. java 

1 import java.awt.*; 

2 import javax. swi ng . * ; 

3 import javax. swi ng . tabl e .* ; 

4 import java.util.*; 
5 

6 public class CustomTabl eCell RendererEdi torDemo extends JApplet { 



7 // Create table column names 

8 private String [] columnNames = 

9 {"Title", "Copies Needed", "Publisher", "Date Published", 
10 "In-stock", "Book Photo"}; 

11 

12 // Create image icons 

13 private Imagelcon i ntrolelmagelcon = 

14 new ImageIcon(getClassO .getResource("image/introle.gif")) ; 

15 private Imagelcon i ntro2eImageIcon = 

16 new ImageIcon(getClass() .getResource("image/intro2e.gif")) ; 

17 private Imagelcon i ntro3eImageIcon = 

18 new ImageIcon(getClass() .getResource("image/intro3e. jpg")) ; 
19 

20 // Create table data 

21 private 0bject[][] rowData = { 

22 {"Introduction to Java Programming", 120, 

23 "Que Education & Training", 

24 new CregorianCalendar(1998, 1-1, 6) .getTimeO , 

25 false, i ntrolelmagelcon} , 

26 {"Introduction to Java Programming, 2E", 220, 

27 "Que Education & Training", 

28 new GregorianCalendar(1999, 1-1, 6) .getTimeO , 

29 false, i ntro2eImageIcon} , 

30 {"Introduction to Java Programming, 3E", 220, 

31 "Prentice Hall", 

32 new CregorianCalendar(2000, 12-1, 0) .getTimeO , 

33 true, i ntro3eImageIcon} , 

34 }; 
35 

36 // Create a table model 

37 private MyTableModel tableModel = new MyTabl eModel ( 

38 rowData, columnNames); 
39 

40 // Create a table 

41 private JTable jTablel = new JTabl e(tabl eModel ) ; 
42 

43 public CustomTabl eCel 1 RendererEdi torDemoO { 

44 // Set custom Tenderer for displaying images 

45 TableColumn bookCover = jTablel.getColumn("Book Photo"); 

46 bookCover . setCel 1 Renderer(new MylmageCell RendererO) ; 
47 

48 // Create a combo box for publishers 

49 JComboBox jcboPubl i shers = new JComboBoxO ; 

50 jcboPubl i shers. addItem("Prentice Hall"); 

51 jcboPublishers.addItem("Que Education & Training"); 

52 jcboPublishers.addItem("McGraw-Hill") ; 
53 

54 // Set combo box as the editor for the publisher column 

55 TableColumn publ i sherCol umn = jTabl el . getCol umn("Publ isher") ; 

56 publ i sherCol umn . setCel 1 Edi tor( 

57 new Defaul tCel 1 Edi tor(jcboPubl i shers)) ; 
58 
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59 jTab)el.setRowHeight(60) ; 

60 add(new JScrol) Pane(jTab) el) , 

61 BorderLayout. CENTER) ; 

62 } 

63 } main method omitted 

This example uses the same table model (MyTabl eflodel ) that was created in the preceding 
example (lines 37-38). By default, image icons are displayed using the predefined image icon 
renderer. To use MylmageCell Renderer to display the image, you have to explicitly speci- 
fy the MylmageCel 1 Renderer renderer for the Book Photo column (line 46). Likewise, you 
have to explicitly specify the combo box editor for the Publisher column (lines 56-57); other- 
wise the default editor would be used. 

When you edit a cell in the Publisher column, a combo box of three items is displayed. 
When you select an item from the box, it is displayed in the cell. You did not write the code 
for handling selections. The selections are handled by the Defaul tCell Editor class. 

When you resize the Book Photo column, the image is resized to fit into the whole cell. 
With the predefined image renderer, you can see only part of the image if the cell is smaller 
than the image. 



36.8 Table Model Events 

JTable does not fire table events. It fires events like MouseEvent, KeyEvent, and 
ComponentEvent that are inherited from its superclass, ^Component. Table events are fired 
by table models, table column models, and table-selection models whenever changes are 
made to these models. Table models fire Tabl eModel Event when table data are changed. 
Table column models fire Tabl eCol umnModel Event when columns are added, removed, or 
moved, or when a column is selected. Table-selection models fire ListSelectionEvent 
when a selection is made. 

To listen for these events, a listener must be registered with an appropriate model and im- 
plement the correct listener interface. Listing 36. 1 1 gives an example that demonstrates how 
to use these events. The program displays messages on a text area when a row or a column is 
selected, when a cell is edited, or when a column is removed. Figure 36.17 is a sample run of 
the program. 
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Figure 36.1 7 Table event handlers display table events on a text area. 



Listing 36. 1 1 Tabl eEventsDemo . j ava 

1 import java.awt.*; 

2 import java.awt. event.*; 

3 import javax. swing.*; 

4 import javax. swi ng . event .* ; 

5 import javax. swing. table.*; 
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JTable and JTree 



column names 



image icons 



table data 



table model 



table 



column model 



selection model 



6 import java. uti 1 . * ; 
7 

8 public class Tabl eEventsDemo extends JApplet { 



9 
10 
11 
12 
13 
14 
15 
16 
17 
18 
19 
20 
21 
22 
23 
24 
25 
26 
27 
28 
29 
30 
31 
32 
33 
34 
35 
36 
37 
38 
39 
40 
41 
42 
43 
44 
45 
46 
47 
48 
49 
50 
51 
52 
53 
54 
55 
56 
57 
58 
59 
60 
61 
62 
63 
64 



// Create table column names 
private String [] columnNames = 

{"Title", "Copies Needed", "Publisher", 
"In-stock", "Book Photo"}; 



'Date Published", 



// Create image icons 

private Imagelcon i ntrolelmagelcon = 

new ImageIcon(getClass() .getResource("image/introle.gif")) 
private Imagelcon i ntro2eImageIcon = 

new ImageIcon(getClass() .getResource("image/intro2e.gif")) 
private Imagelcon i ntro3eImageIcon = 

new ImageIcon(getClass() .getResource("image/intro3e. jpg")) 

// Create table data 

private 0bject[][] rowData = { 

{"Introduction to Java Programming", 120, 
"Que Education & Training", 
new Gregori anCal endar(1998 , 1-1, 6) .getTimeO , 
false, i ntrolelmagelcon} , 
{"Introduction to Java Programming, 2E", 220, 
"Que Education & Training", 
new Gregori anCal endar(1999 , 1-1, 6) .getTimeO , 
false, i ntro2eImageIcon} , 
{"Introduction to Java Programming, 3E", 220, 
"Prentice Hall", 

new GregorianCalendar(2000, 12-1, 0) . getTi me() , 
true, i ntro3eImageIcon} , 



}; 



// Create a table model 
private MyTableModel tableModel 
rowData, columnNames); 



new MyTabl eModel ( 



// Create a table 

private JTable jTablel = new JTabl e (tabl eModel ) ; 

// Get table column model 

private Tabl eCol umnModel tabl eCol umnModel = 
jTabl el . getCol umnModel () ; 

// Get table selection model 
private ListSelectionModel sel ecti onModel = 
jTablel. getSel ecti onModel () ; 



// Create a text area 
private ITextArea jtaMessage 



new DTextAreaQ ; 



// Create a button 

private IButton jbtDeleteColumn = 

new ]Button("Delete Selected Column"); 

public Tabl eEventsDemo() { 

// Set custom Tenderer for displaying images 
TableColumn bookCover = jTabl el. getColumn ("Book Photo"); 
bookCover . setCel 1 Renderer(new MylmageCel 1 RendererQ) ; 



36.8 Table Model Events 1249 



65 // Create a combo box for publishers 

66 JComboBox jcboPubl i shers = new JComboBoxO; 

67 jcboPubli shers. addItem("Prentice Hall"); 

68 jcboPubl i shers . addItem("Que Education & Training"); 

69 jcboPublishers.addItem("McGraw-Hill") ; 
70 

71 // Set combo box as the editor for the publisher column 

72 TableColumn publ i sherCol umn = jTablel.getColumn("Publisher") ; 

73 publ i sherCol umn . setCel 1 Editor ( 

74 new DefaultCellEditor(jcboPublishers)) ; 
75 

76 ]Tablel.setRowHeight(60) ; 

77 jTabl el . setCol umnSel ecti onAl 1 owed (true) ; 
78 

79 JSplitPane jSplitPanel = new JSplitPane( 

80 JSplitPane.VERTICAL_SPLIT) ; 

81 jSplitPanel.add(new JScroll Pane(jTabl el) , JSpl i tPane . LEFT) ; 

82 jSplitPanel.add(new JScroll Pane(jtaMessage) , JSpl i tPane . RIGHT) ; 

83 add(jbtDeleteColumn, BorderLayout . NORTH) ; 

84 add(jSplitPanel, BorderLayout. CENTER) ; 
85 

86 tabl eModel . addTabl eModel Li stener(new Tabl eModel Li stener() { table model listener 

87 public void tabl eChanged(Tabl eModel Event e) { 

88 jtaMessage. append ("Table changed at row " + 

89 e.getFirstRow() + " and column " + e . getCol umn() + "\n") ; 

90 } 

91 }); 
92 

93 tabl eCol umnModel . addCol umnModel Li stener( column model listener 

94 new Tabl eCol umnModel Li stener() { 

95 public void col umnRemoved (Tabl eCol umnModel Event e) { 

96 jtaMessage. append ("Col umn indexed at " + e . getFromlndexO + 

97 "is deleted \n") ; 

98 } 

99 public void col umnAdded (Tabl eCol umnModel Event e) { 

100 } 

101 public void col umnMoved (Tabl eCol umnModel Event e) { 

102 } 

103 public void col umnMargi nChanged(ChangeEvent e) { 

104 } 

105 public void columnSelectionChanged(ListSelectionEvent e) { 

106 } 

107 }); 
108 

109 jbtDeleteColumn.addActionListener(new ActionLi stener() { 

110 public void acti onPerformed(Acti onEvent e) { 

111 if (jTabl el. getSel ectedCol umn () >= 0) { 

112 Tabl eCol umnModel col umnModel = jTabl el. getCol umnModel () ; 

113 TableColumn tabl eCol umn = 

114 columnModel .getColumn(jTablel.getSelectedColumn()) ; 

115 col umnModel . removeCol umn (tabl eCol umn) ; 

116 } 

117 } 

118 }) ; 
119 

120 selectionModel .addListSelectionListener( selection model listener 

121 new Li stSel ectionLi stener() { 

122 public void val ueChanged(Li stSel ecti onEvent e) { 

123 jtaMessage. append("Row " + jTablel.getSelectedRowQ + 
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124 " and column " + jTablel.getSelectedColumn() + 

125 " selected\n"); 



126 } 

127 }); 

128 } 

main method omitted 129 } 



To respond to the row and column selection events, you need to implement the 
val ueChanged method in ListSelectionListener. To respond to the cell-editing 
event, you need to implement the tabl eChanged method in Tabl eModel Listener. To 
respond to the column-deletion event, you need to implement the col umnRemoved method 
in Tabl eCol umnModel Listener. Let's use the same table from the preceding example, 
but with a button added for deleting the selected column and a text area for displaying the 
messages. 

A table model is created using MyTabl eModel (lines 39-40), which was given in Listing 
36.7. When a table is created (line 43), its default column model and selection model are also 
created. Therefore, you can obtain the table column model and selection model from the table 
(lines 46-51). 

When a row or a column is selected, a Li stSel ectionEvent is fired by sel ectionModel , 
which invokes the handler to display the selected row and column in the text area (lines 120-127). 
When the content or structure of the table is changed, a Tabl eModel Event is fired by 
tabl eModel , which invokes the handler to display the last row and last column of the changed 
data in the text area (lines 86-91). When a column is deleted by clicking the Delete Selected Col- 
umn button, a Col umnModel Event is fired by tabl eCol umnModel , which invokes the handler 
to display the index of the deleted column (lines 93-107). 

36.9 JTree 

JTree is a Swing component that displays data in a treelike hierarchy, as shown in Figure 36.18. 
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Figure 36.18 JTree displays data in a treelike hierarchy. 



All the nodes displayed in the tree are in the form of a hierarchical indexed list. The tree 
can be used to navigate structured data with hierarchical relationships. A node can have 
child nodes. A node is called a leaf if it has no children; a node with no parent is called the 
root of its tree. A tree may consist of many subtrees, each node acting as the root for its own 
subtree. 

A nonleaf node can be expanded or collapsed by double-clicking on the node or on the 
node's handle in front of the node. The handle usually has a visible sign to indicate whether 
the node is expanded or collapsed. For example, on Windows, the + symbol indicates that the 
node can be expanded, and the — symbol, that it can be collapsed. 
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Like JTabl e, JTree is a very complex component with many supporting interfaces and 
classes. JTree is in the javax. swing package, but its supporting interfaces and classes are 
all included in the javax . swi ng . tree package. The supporting interfaces are TreeModel , 
TreeSelectionModel, TreeNode, and Mutabl eTreeNode, and the supporting classes are 
Def aul tTreeModel , Def aul tMutabl eTreeNode, Def aul tTreeCel 1 Edi tor, 
Def aul tTreeCel 1 Renderer, and TreePath. 

While JTree displays the tree, the data representation of the tree is handled by 
TreeModel, TreeNode, and TreePath. TreeModel represents the entire tree, TreeNode 
represents a node, and TreePath represents a path to a node. Unlike the Li stModel or 
Tabl eModel , TreeModel does not directly store or manage tree data. Tree data are stored 
and managed in TreeNode and TreePath. Defaul tTreeModel is a concrete implementa- 
tion of TreeModel. MutableTreeNode is a subinterface of TreeNode, which represents a 
tree node that can be mutated by adding or removing child nodes, or by changing the contents 
of a user object stored in the node. 

The TreeSelectionModel interface handles tree node selection. The 
Defaul tTreeCell Renderer class provides a default tree node renderer that can display a 
label and/or an icon in a node. The Defaul tTreeCel 1 Edi tor can be used to edit the cells 
in a text field. 

A TreePath is an array of Objects that are vended from a TreeModel . The elements of 
the array are ordered such that the root is always the first element (index 0) of the array. 
Figure 36.19 shows how these interfaces and classes are interrelated. 



javax.swing.JTree 



-model : TreeModel 

-anchorPath : TreePath 

-leadPath: TreePath 

-select! onModel : TreeSelectionModel 

-cellRenderer: TreeCel 1 Renderer 

-cell Edi tor: TreeCell Edi tor 



(^— TreeModel \ ^-- DefaultTreeModel | MutableTreeNode | 
^— TreePath | 



TreeNode | 



i 

Defaul tMutabl eTreeNode | 



(^— TreeSelectionModel | ^-- Defaul tTreeSelecti onModel | 
^— TreeCell Renderer | ^-- DefaultTreeCellRenderer | 
(y~ TreeCell Edi tor \ ^-- Defaul tTreeCell Edi tor | 



Figure 36.19 JTree contains many supporting interfaces and classes. 



Figure 36.20 shows the constructors, frequently used properties, and methods of 
JTree. 

The JTree class contains seven constructors for creating trees. You can create a tree 
using its no-arg constructor, a tree model, a tree node, a Hashtabl e, an array, or a vector. 
Using the no-arg constructor, a sample tree is created as shown in Figure 36.18. Using a 
Hashtabl e, an array, or a vector, a root is created but not displayed. All the keys in a 
Hashtabl e, all the objects in an array, and all the elements in a vector are added into the 
tree as children of the root. If you wish the root to be displayed, set the rootVi si bl e prop- 
erty to true. 

All the methods related to path selection are also defined in the TreeSelectionModel 
interface, which will be covered in §36.12, "TreePath and TreeSel ectionModel ." 

Listing 36.12 gives an example that creates four trees: a default tree using the no-arg con- 
structor, a tree created from an array of objects, a tree created from a vector, and a tree creat- 
ed from a hash table, as shown in Figure 36.21. Enable the user to dynamically set the 
properties for rootVisible, rowHeight, and showsRootHandles. 
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j avax.s wing. JTree 



JavaBeans properties with get and set 
methods omitted in the UML diagram 



#cell Editor: TreeCell Editor 
#cellRenderer: TreeCel 1 Renderer 
#edi table: boolean 
#model : TreeModel 
#rootVi si bl e : boolean 
#rowHeight: int 

#scrol 1 sOnExpand : boolean 

#selectionModel : TreeSelectionModel 
#showsRootHandles: boolean 
#toggl eCl i ckCount : int 
-anchorSelectionPath: TreePath 
-expandsSel ectedPaths : boolean 
-leadSelectionPaths: TreePath 



+JTree() 

+JTree(val ue : java.util .Hashtable) 

+JTree(val ue : Object[]) 

+JTree(newModel : TreeModel) 
+JTree(root: TreeNode) 

+JTree(root: TreeNode, asksAllowsChildren: 
bool ean) 

+JTree(val ue : Vector) 

+addSelectionPath(path: TreePath): void 
+addSelectionPaths (paths: TreePath []): void 
+addSelectionRow(row: int): void 
+addSelectionRows(rows: int[]): void 
+clearSelection() : void 
+collapsePath(path: TreePath): void 

+getSelectionPath() : TreePath 
+getSelectionPaths() : TreePath[] 
+getl_astSel ectedPathComponent() 
+getRowCount() : int 

+removeSelectionPath(path: TreePath): void 
+removeSelectionPaths(paths : TreePath[]): void 



Specifies a cell editor used to edit entries in the tree. 
Specifies a cell renderer. 

Specifies whether the cells are editable (default: false). 
Maintains the tree model. 

Specifies whether the root is displayed (depending on the constructor). 
Specifies the height of the row for the node displayed in the tree 

(default: 16 pixels). 
If true, when a node is expanded, as many of the descendants 

as possible are scrolled to be visible (default: 16 pixels). 
Models the set of selected nodes in this tree. 
Specifies whether the root handles are displayed (default: true). 
Number of mouse clicks before a node is expanded (default: 2). 
The path identified as the anchor. 

True if paths in the selection should be expanded (default: true). 
The path identified as the lead. 

Creates a JTree with a sample tree model, as shown in Figure 36.18. 
Creates a JTree with an invisible root and the keys in the Hashtabl e 

key/value pairs as its children. 
Creates a JTree with an invisible root and the elements in the array as 

its children. 

Creates a JTree with the specified tree model. 

Creates a JTree with the specified tree node as its root. 

Creates a JTree with the specified tree node as its root and decides 
whether a node is a leaf node in the specified manner. 

Creates a JTree with an invisible root and the elements in the vector as 
its children. 

Adds the specified TreePath to the current selection. 
Adds the specified TreePaths to the current selection. 
Adds the path at the specified row to the current selection. 
Adds the path at the specified rows to the current selection. 
Clears the selection. 

Ensures that the node identified by the specified path is collapsed and 
viewable. 

Returns the path from the root to the first selected node. 
Returns the paths from the root to all the selected nodes. 
Returns the last node in the first selected TreePath. 
Returns the number of rows currently being displayed. 
Removes the node in the specified path. 
Removes the node in the specified paths. 



Figure 36.20 The JTree class is for creating, customizing, and manipulating trees. 
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Figure 36.2 1 You can dynamically set the properties for rootVi si bl e, rowHei ght, and 
showRootHandl es in a tree. 
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Listing 36. 1 2 Si mpl eTreeDemo . j ava 

1 import java.awt.*; 

2 import java.awt. event.*; 

3 import javax. swi ng . * ; 

4 import javax. swi ng . event . * ; 

5 import java.util ; 
6 

7 public class Si mpl eTreeDemo extends JApplet { 

8 // Create a default tree 

9 private JTree jTreel = new JTree(); tree 1 
10 

11 // Create a tree with an array of Objects. 

12 private JTree jTree2 = new JTree(new String [] tree 2 

13 {"dog", "cow", "cat", "pig", "rabbit"}); 
14 

15 // Create a tree with a vector 

16 private Vector vector = new Vector(Arrays . asLi st( tree 3 

17 new Object[]{"red", "green", "black", "white", "purple"})); 

18 private JTree jTree3 = new JTree(vector) ; 
19 

20 private Hashtabl e<Integer , String> hashtable = 

21 new Hashtabl e<Integer , String>(); 

22 private JTree jTree4; tree 4 
23 

24 // Create a combo box for selecting rootVisible 

25 private JComboBox jcboRootVisible = new JComboBox( 

26 new String [] {"false", "true"}); 
27 

28 // Create a combo box for selecting showRootHandl es 

29 private JComboBox jcboShowsRootHandles = new JComboBox( 

30 new String [] {"false", "true"}); 
31 

32 // Create a spinner for selecting row height 

33 private JSpinner jSpi nnerRowHei ght = new JSpinner( 

34 new Spi nnerNumberModel (16 , 1, 50, 1)); 
35 

36 public Si mpl eTreeDemoO { 

37 jTreel. setRootVi si bl e(fal se) ; 

38 

39 hashtable. putCl, "red"); 

40 hashtable. put(2, "green"); 

41 hashtable. put(3, "blue"); 

42 hashtable. put(4, "yellow"); 

43 jTree4 = new JTree(hashtabl e) ; tree 
44 

45 JPanel panell = new JPanel(new GridLayout(l, 4)); 

46 panell. add (new JScroll Pane(jTreel)) ; 

47 panell. add (new JScroll Pane(jTree2)) ; 

48 panell. add (new JScroll Pane(jTree3)) ; 

49 panell. add (new JScroll Pane(jTree4)) ; 
50 

51 JPanel pane!2 = new JPanel (); 

52 panel 2. add (new JLabel ("rootVisible")) ; 

53 panel 2 . add(jcboRootVi si bl e) ; 

54 panel 2. add (new JLabel ("rowHeight")) ; 

55 panel 2 . add (j Spi nnerRowHei ght) ; 

56 panel 2. add (new JLabel ("showsRootHandles")) ; 

57 panel2 .add(jcboShowsRootHandles) ; 
58 



1254 Chapter 36 JTable and JTree 



combo box listener 



spinner listener 



main method omitted 



59 
60 
61 
62 
63 
64 
65 
66 
67 
68 
69 
70 
71 
72 
73 
74 
75 
76 
77 
78 
79 
80 
81 
82 
83 
84 
85 
86 
87 
88 
89 
90 
91 
92 
93 
94 
95 

96 } 



add(panel 1, BorderLayout . CENTER) ; 
add(panel2, BorderLayout . SOUTH) ; 

// Register listeners 

jcboRootVisible.addActionListener(new Acti onLi stenerO { 
public void actionPerformed(ActionEvent e) { 
boolean rootVisible = 

j cboRootVi si bl e . getSel ectedltemO . equal s ("true") ; 
jTreel. setRootVi si ble (rootVi sible) ; 
jTree2 . setRootVi si bl e (rootVi si bl e) 
j Tree 3 . setRootVi si bl e (rootVi si bl e) 
jTree4 . setRootVi si bl e (rootVi si bl e) 
} 

}); 

jcboShowsRootHandles.addActionListener(new ActionLi stenerO { 
public void actionPerformed(ActionEvent e) { 
boolean showsRootHandl es = 

j cboShowsRootHandl es . getSel ectedltemO ■ equal s ("true") ; 
jTreel. setShowsRootHandl es (showsRootHandl es) ; 
jTree2 . setShowsRootHandl es (showsRootHandl es) ; 
jTree3 . setShowsRootHandl es (showsRootHandl es) ; 
jTree4 . setShowsRootHandl es (showsRootHandl es) : 

} 

}); 

jSpinnerRowHeight.addChangeListener(new ChangeLi stenerO { 
public void stateChanged(ChangeEvent e) { 
int height = 

((Integer) (jSpi nnerRowHei ght . getVal ue())) . i ntVal ue() ; 
jTreel. setRowHeight(height) ; 
jTree2 . setRowHei ght (height) ; 
jTree3.setRowHeight(height) ; 
jTree4.setRowHeight(height) : 

} 

}); 



Four trees are created in this example. The first is created using the no-arg constructor (line 9) 
with a default sample tree. The second is created using an array of objects (lines 12-13). All 
the objects in the array become the children of the root. The third is created using a vector 
(lines 16-18). All the elements in the vector become the children of the root. The fourth is cre- 
ated using a hash table (lines 39^43). A Hashtabl e is like a Map. Hashtabl e was introduced 
earlier than Java 2 and has since been replaced by Map. It is used in the Java API (e.g., JTree), 
which was developed before Java 2. The keys of the hash table become the children of the root. 

JTree doesn't directly support scrolling. To create a scrollable tree, create a 
JScrol 1 Pane and add an instance of JTree to the scroll pane (lines 46^4-9). 

The example enables you to specify whether the root is visible and whether the root han- 
dles are visible from two combo boxes (lines 63-83). It also lets you specify the row height of 
the node in a spinner (lines 85-94). 



36.10 TreeModel and Defaul tTreeModel 

The TreeModel interface represents the entire tree. Unlike ListModel or TableModel, 
TreeModel does not directly store or manage tree data. TreeModel contains the structural 
information about the tree, and tree data are stored and managed by TreeNode. 
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«interface» 
javax.swing. tree. TreeModel 



+getChi Id (parent: Object, index: int): Object 

+getChildCount(parent: Object): int 

+getIndexOfChi ld(parent: Object, child: Object): 

+getRoot() : Object 

+i sLeafCnode : Object): boolean 

+addTreeModel Li stener(l i stener : 

TreeModel Li stener) : void 
+ removeTreeModel Li stener (1 i stener : 

TreeModel Li stener) : void 
+valueForPathChanged(path : TreePath, newValue: 

Object): void 



Returns the child of the parent at the index in the parent's child array. 

Returns the number of children of the specified parent in the tree model. 

Returns the index of the child in the parent. If the parent or child is null, returns -1. 

Returns the root of the tree. Returns null if the tree is empty. 

Returns true if the specified node is a leaf. 

Adds a listener for the TreeModel Event posted after the tree changes. 

Removes a listener previously added with addTreeModel Li stener. 

Messaged when the user has altered the value for the item identified by 
path to newVal ue. 



_ 



javax.swing.tree.DefaultTreeModel 



#asksAll owsChi ldren : boolean 



#root: TreeNode 



+DefaultTreeModel (root: TreeNode) 

+Def aul tTreeModel (root: TreeNode, 
asksAllowsChildren: boolean) 

+asksAll owsChi ldren() : boolean 

+getPathToRoot(aNode: TreeNode): TreeNode [] 

+i nsertNodeInto(newChi Id : Mutabl eTreeNode , 
parent: Mutabl eTreeNode , index: int): void 

+reload(): void 

+removeNodeFromParent(node : Mutabl eTreeNode) : 
void 



Tells how leaf nodes are determined. True if only nodes that do not allow 

children are leaf nodes, false if nodes that have no children are leaf nodes. 
The root of the tree. 

Creates a Def aul tTreeModel with the specified root. 

Creates a Def aul tTreeModel with the specified root and decides whether ; 
node is a leaf node in the specified manner. 

Returns asksAl 1 owsChi 1 dren. 

Returns the nodes in an array from root to the specified node. 
Inserts newChi 1 d at location index in parent's children. 

Reloads the model (invoke this method if the tree has been modified). 
Removes the node from its parent. 



Figure 36.22 TreeModel represents an entire tree and Defaul tTreeModel is a concrete implementation of it. 

Def aul tTreeModel is a concrete implementation for TreeModel that uses TreeNodes. 
Figure 36.22 shows TreeModel and Defaul tTreeModel . 

Once a tree is created, you can obtain its tree model using the getModel method. Listing 
36.13 gives an example that traverses all the nodes in a tree using the tree model. Line 1 cre- 
ates a tree using JTree's no-arg constructor with the default sample nodes, as shown in 
Figure 36.18. The tree model for the tree is obtained in line 4. Line 5 invokes the traversal 
method to traverse the nodes in the tree. 

Listing 36. 1 3 Tes tTreeModel . j ava 

1 public class TestTreeModel { 

2 public static void main(String[] args) { 

3 javax. swing.JTree jTreel = new javax . swi ng . JTreeO ; 

4 javax. swing. tree. TreeModel model = jTreel. getModel () ; 
traversal (model , model .getRootO) ; 

} 



5 
6 
7 
8 
9 
10 
11 
12 



default tree 
tree model 
getRoot 



private static void traversal 

(javax. swing. tree. TreeModel model, Object root) { 
System . out . pri nt(root + " ") ; 
if (model .isLeaf (root)) return; 

for (int i = 0; i < model . getChi 1 dCount(root) ; i++) 



is leaf? 

getChildCount 
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13 traversal (model , model .getChi Id (root, i)); 

14 } 

15 } 

16 } 



JTree colors blue violet red sports basketball soccer football 
food hot dogs pizza ravioli 



The traversal method starts from the root of the tree. The root is obtained by invoking the 
getRoot method (line 5). If the root is a leaf, the method returns (line 1 1). Otherwise, it re- 
cursively invokes the traversal method to start from the children of the root (line 13). 

36.1 1 TreeNode, MutableTreeNode, 
and DefaultMutableTreeNode 

While TreeModel represents the entire tree, TreeNode stores a single node of the tree. 
Mutabl eTreeNode defines a subinterface of TreeNode with additional methods for chang- 
ing the content of the node, for inserting and removing a child node, for setting a new parent, 
and for removing the node itself. 

DefaultMutableTreeNode is a concrete implementation of MutableTreeNode that 
maintains a list of children in a vector and provides the operations for creating nodes, for exam- 
ining and modifying a node's parent and children, and also for examining the tree to which the 
node belongs. Normally, you should use DefaultMutableTreeNode to create a tree node. 
Figure 36.23 shows TreeNode, MutableTreeNode, and Defaul tMutabl eTreeNode. 

® Note 

In graph theory, depth-first traversal is defined the same as preorder traversal, but in the 
depthFirstEnumerationO method in DefaultMutableTreeNode, it is the same as 
postorder traversal. 

tj| Note 

You can create a JTree from a root using new JTree (TreeNode) or from a model using new 
JTree(TreeModel). To create a tree model, you first create an instance of TreeNode to repre- 
sent the root of the tree, and then create an instance of Defaul tTreeModel fitted with the root. 

Listing 36.14 gives an example that creates two trees to display world, continents, countries, 
and states. The two trees share the same nodes and thus display identical contents. The pro- 
gram also displays the properties of the tree in a text area, as shown in Figure 36.24. 

Listing 36.14 TreeNodeDemo. java 

1 import java.awt.*; 

2 import javax. swing.*; 

3 import javax. swing. tree.*; 

4 import java.util.*; 
5 

6 public class TreeNodeDemo extends DApplet { 

7 public TreeNodeDemoO { 

8 // Create the first tree 

9 DefaultMutableTreeNode root, europe, northAmerica, us; 
10 

11 europe = new Defaul tMutabl eTreeNode("Europe") ; 

12 europe. add (new Defaul tMutabl eTreeNode("UK")) ; 
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13 eu rope. add (new Defaul tMutabl eTreeNode("Germany")) ; 

14 eu rope. add (new Defaul tMutabl eTreeNode("France")) ; 

15 eu rope. add (new Defaul tMutabl eTreeNode("Norway")) ; 
16 

17 northAmeri ca = new DefaultMutableTreeNode ("North America"); 

18 us = new Defaul tMutabl eTreeNode("US") ; 

19 us.add(new DefaultMutableTreeNode("California")) ; add children 

20 us.add(new Defaul tMutabl eTreeNode("Texas")) ; 

21 us.add(new Defaul tMutabl eTreeNode("New York")); 

22 us.add(new Defaul tMutabl eTreeNode("Florida")) ; 

23 us.add(new DefaultMutableTreeNode("Illinois")) ; 

24 northAmerica.add(us) ; 

25 northAmerica.add(new Defaul tMutabl eTreeNode ("Canada") ) ; 
26 

27 root = new Defaul tMutabl eTreeNode("Worl d") ; 

28 root . add(europe) ; 

29 root . add(northAmeri ca) ; 
30 

31 J Panel panel = new JPanelO; 

32 panel . setLayout(new Gri dLayout(l , 2)); 

33 panel . add(new IScroll Pane(new ITree(root)) ) ; 

34 panel . add(new IScroll Pane(new JTree(new Defaul tTreeModel (root)))) ; 
35 

36 JTextArea jtaMessage = new ]TextArea() ; 

37 jtaMessage . setWrapStyl eWord(true) ; 

38 jtaMessage . setLi neWrap(true) ; 

39 add(new ]SplitPane(JSplitPane.VERTICAL_SPLIT, 

40 panel, new JScrol 1 Pane(jtaMessage)) , BorderLayout . CENTER) ; 
41 

42 // Get tree information 

43 jtaMessage . append("Depth of the node US is " + us.getDepthO) ; 

44 jtaMessage . append ("\nLevel of the node US is " + us.getLevel ()) ; 

45 jtaMessage. append("\nFirst child of the root is " + 

46 root.getFi rstChildO) ; 

47 jtaMessage. append("\nFirst leaf of the root is " + 

48 root.getFi rstLeafO) ; 

49 jtaMessage . append ("\nNumber of the children of the root is " + 

50 root.getChildCountO) ; 

51 jtaMessage . append ("\nNumber of leaves in the tree is " + 

52 root.getLeafCountO) ; 

53 String breadthFi rstSearchResult = ""; 
54 

55 // Breadth-first traversal 

56 Enumeration bf = root. breadthFi rstEnumeration() ; 

57 while (bf .hasMoreElementsO) 

58 breadthFi rstSearchResul t += bf . nextEl ement() .toStringO + " "; 

59 jtaMessage. append("\nBreath-first traversal from the root is " 

60 + breadthFi rstSearchResul t) ; 

61 } 

62 } main method omitted 



You can create a JTree using a TreeNode root (line 33) or a TreeModel (line 34), whichev- 
er is convenient. A TreeModel is actually created using a TreeNode root (line 34). The two 
trees have the same contents because the root is the same. However, it is important to note that 
the two JTree objects are different, and so are their TreeModel objects, although both trees 
have the same root. 

A tree is created by adding the nodes to the tree (lines 9-29). Each node is created using 
the DefaultMutableTreeNode class. This class provides many methods to manipulate 
the tree (e.g., adding a child, removing a child) and obtaining information about the tree 
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«interface» 
javax.swing. tree. TreeNode 



+chi ldren() : java.uti 1 . Enumeration 
+getAllowsChi IdrenO : boolean 
+getChildAt(childIndex: int): TreeNode 
+getChildCount() : int 
+getIndex(node: TreeNode): int 
+getParent() : TreeNode 
+ isLeafO: boolean 





«interface» 
javax.swing. tree.MutableTreeNode 



+insert(child: MutableTreeNode, index: int): void 

+remove(index: int): void 

+ remove (node: MutableTreeNode) : void 

+ removeFromParent() '■ void 

+setParent(newParent: MutableTreeNode) : void 
+setUserObject(object: Object): void 



javax.swing.tree.DefaultMutableTreeNode 



#al 1 owsChi 1 d ren : Bool ean 
#parent : MutableTreeNode 
#userObject : Object 



+Def aul tMutabl eTreeNode () 

+Defaul tMutableTreeNode(userObject : Object) 

+Def aul tMutabl eTreeNode (use rObject : Object , 

al 1 owsChi 1 d ren : bool ean) 
+add(newChi 1 d : Mutabl eTreeNode) 
+getChildAfter(aChild: TreeNode) : TreeNode 
+getChi 1 dBef ore (aChi 1 d : TreeNode) : TreeNode 
+getFi rstChildO : TreeNode 
+getl_astChild() : TreeNode 
+getFi rstLeaf () : Def aul tMutabl eTreeNode 
+get Last Leaf () : Def aul tMutabl eTreeNode 
+getNextLeaf () : Defaul tMutabl eTreeNode 
+getPreviousLeaf () : Defaul tMutabl eTreeNode 
+getLeafCount() : int 
+getDepth() : int 
+getLevel () : int 

+getNextNode() : Defaul tMutabl eTreeNode 

+getPreviousNode() : Defaul tMutabl eTreeNode 

+getSi bl i ngCountO : i nt 

+getNextSi bl i ng() : Defaul tMutabl eTreeNode 

+getPath(): TreeNode[] 

+getRoot() : TreeNode 

+isRoot() : boolean 

+breadthFi rstEnumerationO : Enumeration 
+depthFi rstEnumerationO : Enumeration 
+postorderEnumeration() : Enumeration 
+preorderEnumeration() : Enumeration 



Returns the children of this node. 

Returns true if this node can have children. 

Returns the child TreeNode at index chi 1 dlndex. 

Returns the number of children under this node. 

Returns the index of the specified node in the current node's children. 

Returns the parent of this node. 

Returns true if this node is a leaf. 



Adds the specified child under this node at the specified index. 
Removes the child at the specified index from this node's child list. 
Removes the specified node from this node's child list. 
Removes this node from its parent. 
Sets the parent of this node to the specified newParent. 
Resets the user object of this node to the specified object. 



True if the node is able to have children. 
Stores the parent of this node. 
Stores the content of this node. 

Creates a tree node without user object, and allows children. 

Creates a tree node with the specified user object, and allows children. 

Creates a tree node with the specified user object and the specified 

mode to indicate whether children are allowed. 
Adds the specified node to the end of this node's child vector. 
These two methods return the next (previous) sibling of the specified 

child in this node's child vector. 

These two methods return this node's first (last) child in the child's 
vector of this node. 

These four methods return the first (last, next, and previous) leaf that 
is a descendant of this node. The first (last, next, and previous) leaf 
is recursively defined as the first (last, next, and previous) child's 
first (last, next, and previous) leaf. 

Returns the total number of leaves that are descendants of this node. 

Returns the depth of the tree rooted at this node. 

Returns the distance from the root to this node. 

Returns the node that follows (precedes) this node in a preorder 
traversal of this node. 

Returns the number of siblings of this node. 

Returns the next sibling of this node in the parent's child vector. 

Returns the path from the root to this node. 

Returns the root of the tree that contains this node. 

Returns true if this node is the root of the tree. 

These four methods create and return an enumeration that traverses the 
subtree rooted at this node in breadth-first order (depth-first order, 
postorder, preorder). These traversals were discussed in §25.2.4, 
"Tree Traversal." 



Figure 36.23 TreeNode represents a node. 
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Figure 36.24 The two trees have the same data because their roots are the same. 



(e.g., level, depth, number of children, number of leaves, traversals). Some examples of 
using these methods are given in lines 43-60. 

As shown in this example, often you don't have to directly use TreeModel . Using 
DefaultMutableTreeNode is sufficient, since the tree data are stored in Defaul t- 
Mutabl eTreeNode, and Defaul tMutabl eTreeNode contains all the methods for modify- 
ing the tree and obtaining tree information. 



36.12 TreePath and TreeSelectionModel 

The JTree class contains the methods for selecting tree paths. The TreePath class repre- 
sents a path from an ancestor to a descendant in a tree. Figure 36.25 shows TreePath. 

javax.swing.tree.TreePath 

+TreePath(singlePath: Object) 
+TreePath(path: 0bject[]) 
+getl_astPathComponent() : Object 
+getParentPath() : TreePath 
+getPath(): 0bject[] 

+getPathComponent(element: int): Object 
+getPathCount() : int 

+i sDescendant(aTreePath : TreePath): boolean 
+pathByAddingChi Id (child: Object): TreePath 

Figure 36.25 TreePath represents a path from an ancestor to a descendant in a tree. 

You can construct a TreePath from a single object or an array of objects, but often in- 
stances of TreePath are returned from the methods in JTree and TreeSel ectionModel . obtain tree paths 
For instance, the getLeadSel ectionPathO method in JTree returns the path from the 
root to the selected node. There are many ways to extract the nodes from a tree path. Often 
you use the getLastPathComponentO method to obtain the last node in the path, and then 
the getParentO method to get all the nodes in the path upward through the link. 

The selection of tree nodes is defined in the TreeSel ectionModel interface, as shown in 
Figure 36.26. The Defaul tTreeSel ectionModel class is a concrete implementation of the 
TreeSelectionModel that maintains an array of TreePath objects representing the cur- 
rent selection. The last TreePath selected, called the lead path, can be obtained using the 
getLeadSel ectionPathO method. To obtain all the selection paths, use the 
getSel ectionPathsQ method, which returns an array of tree paths. 



Constructs a TreePath containing only a single element. 
Constructs a path from an array of objects. 
Returns the last component of this path. 
Returns a path containing all but the last path component. 
Returns an ordered array of objects containing the components of this TreePath. 
Returns the path component at the specified index. 
Returns the number of elements in the path. 

Returns true if aTreePath contains all the components in this TreePath. 
Returns a new path containing all the elements of this TreePath plus child. 
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«interface» 
javax.swing. tree. TreeSelectionModel 



+addSelectionPath(path: TreePath) : void 
+addSelectionPaths (paths: TreePath[]) : void 
+clearSelection() : void 
+getLeadSel ecti onPath () : TreePath 
+getSelectionCount() : int 
+getSelectionPathO : TreePath 
+getSel ecti onPaths () : TreePath[] 
+getSelectionMode() : int 

+ removeSel ecti onPath (path: TreePath): void 

+ removeSel ecti onPaths (paths: TreePath[]) : void 

+setSel ecti onMode (mode: int): void 

+setSel ecti onPath (path: TreePath): void 

+setSel ecti onPaths (paths: TreePath []) : void 

+addTreeSel ecti onLi stener(x : TreeSelectionLi stener) : 

+ removeTreeSel ecti onLi stener(x: TreeSelectionLi stener) : 



void 
void 



Adds the specified TreePath to the current selection. 

Adds the specified TreePaths to the current selection. 

Clears the selection. 

Returns the last path in the selection. 

Returns the number of paths in the selection. 

Returns the first path in the selection. 

Returns all the paths in the selection. 

Returns the current selection mode. 

Removes path from the selection. 

Removes paths from the selection. 

Sets the selection mode. 

Sets the selection to path. 

Sets the selection to paths. 

Registers a TreeSel ecti onLi stene r. 

Removes a TreeSel ecti onLi stene r. 



javax . swi ng .tree . Def aul tTreeSel ecti onModel | 

Figure 36.26 The TreeSelectionModel handles selection in a tree and Def aul tTreeSel ectionModel 

is a concrete implementation of it. 



tree selection modes 



TreeSelectionModel supports three selection modes: contiguous selection, discontigu- 
ous selection, and single selection. Single selection allows only one item to be selected. 
Contiguous selection allows multiple selections, but the selected items must be contiguous. 
Discontiguous selection is the most flexible; it allows any item to be selected at a given time. 
The default tree selection mode is discontiguous. To set a selection mode, use the 
setSel ectionMode(int mode) method in TreeSel ectionModel . The constants for the 
three modes are: 

■ C0NTIGU0US_TREE_SE LECTION 

■ DISC0NTIGU0US_TREE_SELECTI0N 

■ SINGLE_TREE_SELECTION 



Note 

When you create a DTree, a Defaul tTreeSel ecti onModel is automatically created, and 
bypass thus you rarely need to create an instance of TreeSelectionModel explicitly. Since most of 

TreeSelectionModel the methods in TreeSelectionModel are also in DTree, you can get selection paths and 

process the selection without directly dealing with TreeSel ectionModel . 



Listing 36.15 gives an example that displays a selected path or selected paths in a tree. The user 
may select a node or multiple nodes and click the Show Path button to display the properties of 
the first selected path or the Show Paths button to display all the selected paths in a text area, as 
shown in Figure 36.27. The Show Path button displays a path from the last node up to the root. 



Listing 36.15 TestTreePath . java 

1 import java.awt.*; 

2 import java.awt. event.*; 

3 import javax.swing.*; 

4 import javax. swing. tree.*; 
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5 

6 public class TestTreePath extends JApplet { 



7 private JTree jTree = new ]Tree(); defaulttree 

8 private JTextArea jtaOutput = new JTextAreaO ; textarea 

9 private JButton jbtShowPath = new JButton("Show Path"); Show Path button 
10 private JButton jbtShowPaths = new JButton("Show Paths"); Show Paths button 
11 

12 public TestTreePath () { 

13 JSplitPane splitPane = new JSplitPane(JSplitPane.HORIZONTAL„SPLIT, splitpane 

14 new JScrol 1 Pane(jTree) , new JScroll Pane(jtaOutput)) ; 
15 

16 J Panel panel = new JPanelO; 

17 panel .add(jbtShowPath) ; 

18 panel .add( jbtShowPaths) ; 
19 

20 add (splitPane, BorderLayout. CENTER) ; 

21 add(panel, BorderLayout . NORTH) ; 
22 

23 jbtShowPath.addActionListener(new Acti onLi stener() { Show Path button 

24 public void actionPerformed(ActionEvent e) { 

2 5 TreePath path = jTree. getSel ecti onPath () ; selected path 

26 jtaOutput. append("\nProcessing a single path\n") ; 

27 jtaOutput. append("# of elements: " + path.getPathCountO) ; pathcount 

28 jtaOutput. append("\nlast element: " 

29 + path . getLastPathComponent() ) ; 

30 jtaOutput. append ("\nfrom last node in the path to the root: ") ; 

31 TreeNode node = (TreeNode)path.getLastPathComponentO ; lastnode 

32 while (node != null) { 

33 jtaOutput. append(node.toString() + " ") ; 

34 node = node . getParent() ; get parent 

35 } 

36 }}); 
37 

38 jbtShowPaths. addActi onLi stener(new Acti onLi stener() { Show Paths button 

39 public void actionPerformed(ActionEvent e) { 

40 jtaOutput. append("\nProcessing multiple paths\n") ; 

41 javax . swi ng . tree .TreePath [] paths = jTree. getSelectionPaths() ; selected paths 

42 for (int i = ; i < paths . 1 ength ; i++) 

43 jtaOutput. append(paths[i] .toStringO + "\n") ■ display apath 

44 }}); 

45 } 

46 } main method omitted 
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Figure 36.27 The selected path(s) are processed. 
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The getSelectionPathO method invoked from a JTree returns a TreePath in line 25. 
The first node in the path is always the root of the tree. The getPathCountO invoked from 
a TreePath returns the number of the nodes in the path (line 27). The getLast- 
PathComponentO invoked from a TreePath returns the last node in the path (line 29). The 
return node type is Object. You need to cast it to a TreeNode (line 31) in order to invoke the 
getParentO method from a TreeNode (line 34). 

While the getSelectionPathO method (line 25) returns the first selected path, the 
getSel ectionPathsO method (line 41) returns all the selected paths in an array of paths. 

36. 1 3 Case Study: Modifying Trees 

Write a program to create two trees that display the same contents: world, continents, coun- 
tries, and states, as shown in Figure 36.28. For the tree on the left, enable the user to choose a 
selection mode, specify whether it can be edited, add a new child under the first selected node, 
and remove all the selected nodes. 
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(a) (b) 
Figure 36.28 You can rename a node, add a child, and remove nodes in a tree dynamically. 



You can choose a selection mode from the selectionMode combo box. You can specify 
whether the left tree nodes can be edited from the editable check box. 

When you click a button, if no nodes are currently selected in the left tree, a message dialog 
box is displayed, as shown in Figure 36.29(a). When you click the Add a Child for Selected Node 
button, an input dialog box is displayed to prompt the user to enter a child name for the selected 
node, as shown in Figure 36.29(b). The new node becomes a child of the first selected node. When 
you click the Remove Selected Nodes button, all the selected nodes in the left tree are removed. 
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Figure 36.29 You can add a new node to the tree. 



Listing 36.16 gives the program. 

Listing 36.16 ModifyTree. java 

1 import java.awt.*; 

2 import java.awt. event.*; 

3 import javax. swing.*; 

4 import javax. swi ng . tree . * ; 
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5 

6 public class ModifyTree extends J Applet { 

7 // Create a combo box for choosing selection modes 

8 private JComboBox jcboSelectionMode = new JComboBox(new String[]{ combobox 

9 "CONTIGUOUS TREE_SELECTION" , "DISCONTIGUOUS TREE SELECTION" , 
10 "SINGLE TREE SELECTION"}) ; 

11 

12 // Create a check box for specifying editable 

13 private JCheckBox jchkEditable = new JCheckBoxO; checkbox 
14 

15 // Create two buttons 

16 private J Button jbtAdd = buttons 

17 new ] Button ("Add a Child for Selected Node"); 

18 private JButton jbtRemove = new 1 Button ("Remove Selected Nodes"); 
19 

20 // Declare two trees 

21 private JTree jTreel, jTree2; trees 
22 

23 public ModifyTreeO { 

24 // Create the first tree 

25 Defaul tMutabl eTreeNode root, europe, northAmeri ca, us; treenodes 
26 

27 europe = new Defaul tMutabl eTreeNode("Europe") ; fill nodes 

28 europe. add (new DefaultMutableTreeNode("UK")) ; 

29 europe . add (new Defaul tMutabl eTreeNode ("Germany") ) ; 

30 europe . add (new Defaul tMutabl eTreeNode("France")) ; 

31 europe . add (new Defaul tMutabl eTreeNode("Norway")) ; 
32 

33 northAmeri ca = new Defaul tMutabl eTreeNode("North America"); 

34 us = new Defaul tMutabl eTreeNode("US") ; 

35 us.add(new Defaul tMutabl eTreeNode("Cal i fornia")) ; 

36 us.add(new DefaultMutableTreeNode("Texas")) ; 

37 us.add(new Defaul tMutabl eTreeNode("New York")); 

38 us.add(new DefaultMutableTreeNode("Florida")) ; 

39 us.add(new DefaultMutableTreeNode("Illinois")) ; 

40 northAmerica.add(us) ; 

41 northAmerica.add(new Defaul tMutabl eTreeNode("Canada")) ; 
42 

43 root = new DefaultMutableTreeNode("World") ; 

44 root.add(europe) ; 

45 root.add(northAmerica) ; 
46 

47 jcboSelectionMode. setSel ectedlndex(l) ; 
48 

49 IPanel pi = new JPanelO; 

50 pl.add(new JLabel ("selectionMode")) ; 

51 pl.add(jcboSelectionMode) ; 

52 pl.add(new J Label ("editable")) ; 

53 pl.add(jchkEditable) ; 
54 

55 JPanel p2 = new iPanel(new Cri dLayout(l , 2)); 

56 p2.add(new DScroll Pane(jTreel = new ITree(root))) ; create jTreel 

57 p2.add(new DScroll Pane(jTree2 = create jTree2 

58 new JTree(new Defaul tTreeModel (root)))) ; // Same root as jTreel 
59 

60 JPanel p3 = new DPanelO; 

61 p3.add(jbtAdd); 

62 p3.add(jbtRemove) ; 
63 

64 add(pl, BorderLayout . NORTH) ; 
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add(p2, BorderLayout. CENTER) ; 
add(p3, BorderLayout. SOUTH) ; 

// Register listeners 

jcboSelectionMode.addActionListener(new Acti onLi stener() { 
public void acti on Performed (Acti onEvent e) { 
if (jcboSelectionMode.getSelectedItem() . 
e q u al s ( " CONTIGUOUS TREE SE LECTION " ) ) 
jTreel.getSelectionModel () .setSelectionMode( 
TreeSelectionModel .C0NTIGU0US_TREE_SELECTI0N) ; 
else if (jcboSel ecti onMode . getSel ectedltem() . 
equal s ("DISCONTIGUOUS TREE_SELECTION")) 
jTreel.getSelectionModel () .setSelectionMode( 

TreeSelectionModel .DISC0NTIGU0US_TREE_SELECTT0N) ; 

el se 

jTreel.getSelectionModel () .setSelectionMode( 
TreeSel ecti onModel . SINGLE_TREE_SELECTI0N) ; 

} 

}); 

jchkEditable.addActionListener(new ActionLi stener() { 
public void actionPerformed(ActionEvent e) { 
jTreel . setEdi tabl e ( j chkEdi tabl e . i sSel ected () ) ; 

} 

}); 

jbtAdd . addActionLi stener(new ActionLi stener() { 
public void actionPerformed(ActionEvent e) { 

DefaultMutableTreeNode parent = (Defaul tMutabl eTreeNode) 
jTreel . getLastSel ected PathComponent () ; 

if (parent == null) { 

JOpti on Pane. showMessageDialog (null , 

"No node in the left tree is selected"); 
return ; 

} 

// Enter a new node 

String nodeName = 10ptionPane.showInputDialog( 

null, "Enter a child node for "+ parent, "Add a Child", 
JOptionPane .QUESTI0N_MESSAGE) ; 

// Insert the new node as a child of treeNode 
parent . add(new Defaul tMutabl eTreeNode(nodeName)) ; 

// Reload the model since a new tree node is added 
((Defaul tTreeModel ) (jTreel. getModel ())) . reload () ; 
((Defaul tTreeModel ) (jTree2 . getModel ())) . reload () ; 

} 

}); 

jbtRemove.addActionListener(new ActionLi stener() { 
public void actionPerformed(ActionEvent e) { 

// Get all selected paths 

TreePath[] paths = jTreel. getSelectionPaths() ; 

if (paths == null) { 

lOptionPane . showMessageDialog(null , 

"No node in the left tree is selected"); 
return ; 

} 
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} 



} 

}); 



// Reload the model since a new tree node is added 
((Defaul tTreeModel ) (jTreel. getModel ())) . reload O ; 
((Defaul tTreeModel ) (jTree2 . getModel ())) . reload () ; 



// Remove all selected nodes 

for (int i =0; i < paths . 1 ength ; i++) { 

Defaul tMutabl eTreeNode node = (Defaul tMutabl eTreeNode) 
(paths[i] .getLastPathComponentQ) ; 



} 



"Cannot remove the root") ; 

} 

el se 



if (node.isRootQ) { 



node. removeFromParentQ ; 



JOpti onPane . showMessageDi al og (nul 1 , 



remove node 



reload tree model 



main method omitted 



Two JTree objects (jTreel and jTree2) are created with the same root (lines 56-58), but 
each has its own TreeSel ectionModel . When you choose a selection mode in the combo 
box, the new selection mode is set in jTreel's selection model (line 69-83). The selection 
mode for jTree2 is not affected. 

When the editable check box is checked or unchecked, the edi tabl e property in jTreel 
is set accordingly. If edi tabl e is true, you can edit a node in the left tree. 

When you click the Add a Child for Selected Node button, the first selected node is re- 
turned as parent (lines 93-94). Suppose you selected Europe, UK, and US in this order; 
parent is Europe. If parent is null, no node is selected in the left tree (lines 96-100). Oth- 
erwise, prompt the user to enter a new node from an input dialog box (lines 103-105) and add 
this node as a child of parent (line 108). Since the tree has been modified, you need to in- 
voke the reload () method to notify that the models for both trees have been changed (lines 
111-112). Otherwise, the new node may not be displayed in jTreel and jTree2. 

When you click the Remove Selected Nodes button, all the tree paths for each selected node 
are obtained in paths (line 119). Suppose you selected Europe, UK, and US in this order; 
three tree paths are obtained. Each path starts from the root to a selected node. If no node is se- 
lected, paths is nul 1 . To delete a selected node is to delete the last node in each selected tree 
path (128-138). The last node in apath is obtained using getLastPathComponentC). If the 
node is the root, it cannot be removed (lines 132-135). The removeFromParentO method 
removes a node (line 137). 



TTree delegates node rendering to a Tenderer. All Tenderers are instances of the 
TreeCellRenderer interface, which defines a single method, getTreeCell Renderer- 
Component, as follows: 

public Component getTreeCell RendererComponent 

(JTree tree, Object value, boolean selected, boolean expanded, 
boolean leaf, int row, boolean hasFocus) ; 

You can create a custom tree cell renderer by implementing the TreeCel 1 Renderer interface, 
or use the Defaul tTreeCell Renderer class, which provides a default implementation for 
TreeCellRenderer. When a new JTree is created, an instance of Defaul t- 
TreeCel 1 Renderer is assigned to the tree renderer. The Defaul tTreeCel 1 Renderer class 
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maintains three icon properties named 1 eaf Icon, openlcon, and cl osedlcon for leaf nodes, 
expanded nodes, and collapsed nodes. It also provides colors for text and background. The fol- 
lowing code sets new leaf, open and closed icons, and new background selection color in the tree: 

Defaul tTreeCell Renderer Tenderer = 

(Defaul tTreeCel 1 Renderer) jTreel. getCel 1 RendererO ; 
Tenderer. setLeaflcon(yourCustomLeaflmagelcon) ; 
renderer. setOpenlcon(yourCustomOpenlmagelcon) ; 
renderer . setCl osedlcon (you rCustomClosedlmagelcon) ; 
renderer. setBackgroundSelectionColor(Color. red) ; 



Note 

The default leaf, open icon, and closed icon are dependent on the look-and-feel. For instance, on 
Windows look-and-feel, the open icon is — and the closed icon is +. 

JTree comes with a default cell editor. If JTree's editable property is true, the default 
editor activates a text field for editing when the node is clicked three times. By default, this 
property is set to f al se. To create a custom editor, you need to extend the 
Def aul tCel 1 Edi tor class, which is the same class you used in table cell editing. You can 
use a text field, a check box, or a combo box, and pass it to Def aul tCell Editor's con- 
structor to create an editor. The following code uses a combo box for editing colors. The 
combo box editor is shown in Figure 36.30(a). 

// Customize editor 

JComboBox jcboColor = new JComboBoxO ; 
jcboColor.addItem("red") ; 
jcboColor. addltem("green") ; 
jcboColor. addltem("blue") ; 
jcboColor. addltem ("yellow") ; 
jcboColor. addItem("orange") ; 

jTreel. setCel 1 Edi tor (new javax . swi ng . Def aul tCel 1 Edi tor(jcboCol or)) ; 
jTreel. setEdi tabl e(true) ; 
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(a) (b) 
Figure 36.30 You can supply a custom editor for editing tree nodes. 
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There are two annoying problems with the editor created in the preceding code. First, it is ac- 
tivated with just one mouse click. Second, it overlaps the node's icon, as shown in Figure 
36.30(a). These two problems can be fixed by using the Def aul tTreeCel 1 Edi tor, as 
shown in the following code: 

jTreel. setCel 1 Edi tor 

(new javax. swi ng .tree . Def aul tTreeCel 1 Edi tor (jTreel, 
new javax. swing. tree. Defaul tTreeCel 1 RendererO , 
new javax. swi ng . Defaul tCel 1 Edi tor (jcboColor))) ; 
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The new editor is shown in Figure 36.30(b). Editing using Def aul tTreeCel 1 Edi tor starts 
on a triple mouse click. The combo box does not overlap the node's icon. 

36.15 Tree Events 

JTree can fire TreeSelectionEvent and TreeExpansionEvent, among many other 
events. Whenever a new node is selected, JTree fires a TreeSelectionEvent. Whenever 
a node is expanded or collapsed, JTree fires a TreeExpansionEvent. To handle the tree- 
selection event, a listener must implement the TreeSel ectionListener interface, which 
contains a single handler named val ueChanged method. TreeExpansionListener con- 
tains two handlers named treeCollapsed and treeExpanded for handling node expan- 
sion or node closing. 

The following code displays a selected node in a listener class for TreeSel ectionEvent: 

public void val ueChanged (TreeSel ectionEvent e) { 
TreePath path = e.getNewLeadSelectionPathO ; 
TreeNode treeNode = (TreeNode)path . getLastPathComponentO ; 
System. out. println("The selected node is " + treeNode . toStri ngO) ; 

} 

Chapter Summary 

1. JTabl e has three supporting models: a table model, a column model, and a list-se- 
lection model. The table model is for storing and processing data. The column model 
represents all the columns in the table. The list-selection model is the same as the one 
used by J List for selecting rows, columns, and cells in a table. JTabl e also has two 
useful supporting classes, TableColumn and JTabl eHeader. TableColumn con- 
tains the information on a particular column. JTabl eHeader contains the informa- 
tion on the header of a JTabl e. Each column has a default editor and renderer. You 
can also create a custom editor by implementing the TableCellEditor interface, 
and you can create a custom renderer by implementing the Tabl eCell Renderer 
interface. 

2. Like JTabl e, JTree is a very complex component with many supporting interfaces 
and classes. While JTree displays the tree, the data representation of the tree is han- 
dled by TreeModel, TreeNode, and TreePath. TreeModel represents the entire 
tree, TreeNode represents a node, and TreePath represents a path to a node. Unlike 
the Li stModel or Tabl eModel , the tree model does not directly store or manage tree 
data. Tree data are stored and managed in TreeNode and TreePath. A TreePath is 
an array of Objects that are vended from a TreeModel . The elements of the array are 
ordered such that the root is always the first element (index 0) of the array. The 
TreeSel ectionModel interface handles tree node selection. The Defaul tTree- 
Cel 1 Renderer class provides a default tree node renderer that can display a label 
and/or an icon in a node. The Defaul tTreeCel 1 Edi tor can be used to edit the cells 
in a text field. The TreePath class is a support class that represents a set of nodes in 
a path. 

3. JTabl e and JTree are in the javax . swi ng package, but their supporting interfaces 
and classes are all included in the javax. swing. table and javax. swing. tree 

packages, respectively. 
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Review Questions 



Sections 36.2-36.7 

36.1 How do you initialize a table? Can you specify the maximum number of visible 
rows in a table without scrolling? How do you specify the height of a table cell? 
How do you specify the horizontal margin of table cells? 

36.2 How do you modify table contents? How do you add or remove a row? How do 
you add or remove a column? 

36.3 What is autoresizing of a table column? How many types of autoresizing are 
available? 

36.4 What are the properties that show grids, horizontal grids, and vertical grids? What 
are the properties that specify the table row height, vertical margin, and horizontal 
margin? 

36.5 What are the default table Tenderers and editors? How do you create a custom 
table cell Tenderer and editor? 

36.6 What are the default tree Tenderers and editors? How do you create a custom tree 
cell Tenderer and editor? 

36.7 How do you disable table cell editing? 
Sections 36.8-36.14 

36.8 How do you create a tree? How do you specify the row height of a tree node? How 
do you obtain the default tree model and tree-selection model from an instance of 
JTree? 

36.9 How do you initialize data in a tree using TreeModel ? How do you add a child to 
an instance of Defaul tMutabl eTreeNode? 

36.10 How do you enable tree node editing? 

36.11 How do you add or remove a node from a tree? 

36.12 How do you obtain a selected tree node? 



Programming Exercises 

Sections 36.2-36.7 

36.1* (Creating a table for a loan schedule) Exercise 31.5 displays an amortization 
schedule in a text area. Write a program that enables the user to enter or choose the 
loan amount, number of years, and interest rate from spinners and displays the 
schedule in a table, as shown in Figure 36.31. The step for loan amount is $500, 
for number of years is 1, and for annual interest rate is 0.125%. 



Enter Loan Amount. Number of Years, and Annua 



Loan Amount 


$100,000 




Number of Years 


15 




Annual Interest Rate 


%5 





Display Loan Schedule 



Payments 



Principal 



1415.11 



$375.69 



fS9.25D.19 



1413.54 



$377.25 



$98,872.94 



$411.97 



$378.82 



$98 : 4S4.11 



$410.39 
$408.81 



$380.40 
$381.99 



$98 ; 1 13.71 



$97. 731.72 I" 



Figure 36.3 1 The table shows the loan schedule. 
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36.2* (Deleting rows and columns) Listing 36.6, ModifyTable.java, allows you to 
delete only the first selected row or column. Enable the program to delete all 
the selected rows or columns. Also enable the program to delete a row or a col- 
umn by pressing the DELETE key. 

36.3** (Creating a student table) Create a table for student records. Each record con- 
sists of name, birthday, class status, in-state, and a photo, as shown in Figure 
36.32(a). The name is of the String type; birthday is of the Date type; class 
status is one of the following five values: Freshman, Sophomore, Junior, Senior, 
or Graduate; in-state is a bool ean value indicating whether the student is a res- 
ident of the state; and photo is an image icon. Use the default editors for name, 
birthday, and in-state. Supply a combo box as custom editor for class status. 
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USA 


Washington DC 
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Canada 


Ottawa 


32 


true 




United Kingdom 


London 


60 
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Germany 


Berlin 


83 


true 




France 


Paris 


60 


true 





(b) 



Figure 36.32 (a) The table displays student records, (b) The data in the file are displayed 
in a JTabl e. 



36.4* (Displaying a table for data from a text file) Suppose that a table named Exer- 
cise36_4Table.txt is stored in a text file. The first line in the file is the header, and 
the remaining lines correspond to rows in the table. The elements are separated by 
commas. Write a program to display the table using the JTabl e component. For 
example, the following text file is displayed in a table, as shown in Figure 36.32(b). 

Country, Capital, Population, Democracy 

USA, Washington DC, 280, true 

Canada, Ottawa, 32, true 

United Kingdom, London, 60, true 

Germany, Berlin, 83, true 

France, Paris, 60, true 

Norway, Oslo, 4.5, true 

India, New Delhi, 1046, true 

36.5*** (Creating a controller using JTable) In Exercise 35.1, you created a chart 
model (ChartModel) and two views (PieChart and BarChart). Create a 
controller that enables the user to modify the data, as shown in Figure 36.33. 




Figure 36.33 You can modify the data in the controller. The views are synchronized with 
the controller. 
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You will see the changes take effect in the pie-chart view and the bar-chart 
view. Your exercise consists of the following classes: 

■ The controller named ChartController. This class uses a table to dis- 
play data. You can modify the data in the table. Click the Insert button to in- 
sert a new row above the selected row in the table, click the Delete button to 
delete the selected row in the table, and click the Update button to update 
the changes you made in the table. 

■ The class MyTabl eModel . This class extends Defaul tTabl eModel to 
override the getCol umnCl ass method so that you can use the 
JTable's default editor for numerical values. This class is the same as 
in Listing 36.7. 

■ The classes ChartModel, PieChart, and BarChart from Exercise 35.1. 

■ The main class Exercise36_5. This class creates a user interface with a 
controller and two buttons, View Pie Chart and View Bar Chart. Click the 
View Pie Chart button to pop up a frame to display a pie chart, and click the 
View Bar Chart button to pop up a frame to display a bar chart. 

Sections 36.8-36.14 

36.6* (Creating a tree for book chapters) Create a tree to display the table of con- 
tents for a book. When a node is selected in the tree, display a paragraph to de- 
scribe the selected node, as shown in Figure 36.34(a). 
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Figure 36.34 (a) The content of the node is displayed in a text area when the node is clicked, (b) You can 
store tree data to a file and restore them later. 



36.7* (Storing and restoring trees) Modify Listing 36.16, ModifyTree.java, to add 
two buttons, as shown in Figure 36.34(b) to store and restore trees. Use the ob- 
ject I/O to store the tree model. 

36.8* (Traversing trees) Create a tree using the default JTree constructor and tra- 
verse the nodes in breadth-first, depth-first, preorder, and postorder. 

36.9*** (File explorer) Use JTree to develop a file explorer. The program lets the 
user enter a directory and displays all files under the directory, as shown in 
Figure 36.35. 
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Figure 36.35 The file explorer explores the files in a directory. 



36.1 0** {Adding and deleting tree nodes using the INSERT and DELETE keys) Modify 
Listing 36.16, Modify Tree.java, to add a new child node by pressing the IN- 
SERT key, and delete a node by pressing the DELETE key. 
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Java Database Programming 



■ To understand the concept of database and database management systems (§37.2). 

■ To understand the relational data model: relational data structures, constraints, and 
languages (§37.2). 

■ To use SQL to create and drop tables and to retrieve and modify data (§37.3). 

■ To learn how to load a driver, connect to a database, execute 
statements, and process result sets using JDBC (§37.4). 

■ To use prepared statements to execute precompiled 
SQL statements (§37.5). 

■ To use callable statements to execute stored 
SQL procedures and functions (§37.6). 

■ To explore database metadata using the 
DatabaseMetaData and Resul tSetMetaData 

interfaces (§37.7). 
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37.1 Introduction 

You may have heard a lot about database systems. Database systems are everywhere. Your so- 
cial security information is stored in a database by the government. If you shop online, your 
purchase information is stored in a database by the company. If you attend a university, your 
academic information is stored in a database by the university. Database systems not only 
store data, they also provide means of accessing, updating, manipulating, and analyzing data. 
Your social security information is updated periodically, and you can register in courses on- 
line. Database systems play an important role in society and in commerce. 

This chapter introduces database systems, SQL, and how to develop database applications 
using Java. If you already know SQL, you may skip §§37.2-37.3. 

37.2 Relational Database Systems 

database system A database system consists of a database, the software that stores and manages data in the 

database, and the application programs that present data and enable the user to interact with 
the database system, as shown in Figure 37.1. 



Application Users j 
Application Programs 




System Users 



Database Management System (DBMS) 



database 



Figure 37.1 A database system consists of data, database management software, and 
application programs. 



A database is a repository of data that form information. When you purchase a database 
system, such as MySQL, Oracle, IBM, Microsoft, or Sybase, from a software vendor, you 
DBMS actually purchase the software comprising a database management system (DBMS). Data- 

base management systems are designed for use by professional programmers and are not suit- 
able for ordinary customers. Application programs are built on top of the DBMS for 
customers to access and update the database. Thus application programs can be viewed as the 
interfaces between the database system and its users. Application programs may be stand- 
alone GUI applications or Web applications, and may access several different database sys- 
tems in the network, as shown in Figure 37.2. 

Most of today's database systems are relational database systems. They are based on the 
relational data model, which has three key components: structure, integrity, and language. 
Structure defines the representation of the data. Integrity imposes constraints on the data. 
Language provides the means for accessing and manipulating data. 
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Application Users 



Application Programs 



Database Management System • • • Database Management System 



■ database 



Figure 37.2 An application program may access multiple database systems. 



37.2.1 Relational Structures 

The relational model is built around a simple and natural structure. A relation is actually a 
table that consists of nonduplicate rows. Tables are easy to understand and easy to use. The re- 
lational model provides a simple yet powerful way to represent data. 

A row of a table represents a record, and a column of a table represents the value of a sin- 
gle attribute of the record. In relational database theory, a row is called a tuple and a column 
is called an attribute. Figure 37.3 shows a sample table that stores information about the 
courses offered by a university. The table has eight tuples, and each tuple has five attributes. 



relational model 



tuple 
attribute 



Relation/Table Name 



Course Table 



Columns/ Attributes 



Tuples/ 
Rows 




courseld 


subjectld 


courseNumber 


title 


numOfCredits 


11111 


CSCI 


1301 


Introduction to Java I 


4 


11112 


CSCI 


1302 


Introduction to Java II 


3 


11113 


CSCI 


3720 


Database Systems 


3 


11114 


CSCI 


4750 


Rapid Java Application 


3 


11115 


MATH 


2750 


Calculus I 
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MATH 


3750 


Calculus II 


5 


11117 


EDUC 


1111 


Readi ng 


3 


11118 


ITEC 


1344 


Database Administration 


3 



Figure 37.3 A table has a table name, column names, and rows. 



Tables describe the relationship among data. Each row in a table represents a record of relat- 
ed data. For example, "1 1 1 11", "CSCI", "1301", "Introduction to Java I", and "4" are related to 
form a record (the first row in Figure 37.3) in the Course table. Just as data in the same row are 
related, so too data in different tables may be related through common attributes. Suppose the 
database has two other tables, Student and Enrol 1 ment, as shown in Figures 37.4 and 37.5. 
The Course table and the Enrollment table are related through their common attribute 
courseld, and the Enrol 1 ment table and the Student table are related through ssn. 
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Student Table 



ssn 


f i rstName 


mi 


lastName 


phone 


bi rthDate 




street 


zipCode deptID 


444111110 


Jacob 


R 


Smi th 


9129219434 


1985- 


-04- 


09 


99 


Kingston Street 


31435 


BIOL 


444111111 


John 


K 


Stevenson 


9129219434 


null 






100 


Main Street 


31411 


BIOL 


444111112 


George 


K 


Smith 


9129213454 


1974- 


-10- 


10 


1200 


Abercorn St. 


31419 


CS 


444111113 


Frank 


E 


Jones 


9125919434 


1970- 


-09- 


09 


100 


Main Street 


31411 


BIOL 


444111114 


Jean 


K 


Smith 


9129219434 


1970- 


-02- 


09 


100 


Main Street 


31411 


CHEM 


444111115 


Josh 


R 


Woo 


7075989434 


1970- 


-02- 


09 


555 


Franklin St. 


31411 


CHEM 


444111116 


Josh 


R 


Smith 


9129219434 


1973- 


-02- 


09 


100 


Main Street 


31411 


BIOL 


444111117 


Joy 


P 


Kennedy 


9129229434 


1974- 


-03- 


19 


103 


Bay Street 


31412 


CS 


444111118 


Toni 


R 


Peterson 


9129229434 


1964- 


-04- 


29 


103 


Bay Street 


31412 


MATH 


444111119 


Patrick 


R 


Stoneman 


9129229434 


1969- 


-04- 


29 


101 


Washington St. 


31435 


MATH 


444111120 


Rick 


R 


Carter 


9125919434 


1986- 


-04- 


09 


19 


West Ford St. 


31411 


BIOL 



Figure 37.4 A Student table stores student information. 



Enrollment Table 




ssn 


courseld 


dateRegi stered 


grade 


444111110 


11111 


2004- 


-03- 


19 


A 


444111110 


11112 


2004- 


-03- 


19 


B 


444111110 


11113 


2004- 


-03- 


19 


C 


444111111 


11111 


2004- 


-03- 


19 


D 


444111111 


11112 


2004- 


-03- 


19 


F 


444111111 


11113 


2004- 


-03- 


19 


A 


444111112 


11114 


2004- 


-03- 


19 


B 


444111112 


11115 


2004- 


-03- 


19 


C 


444111112 


11116 


2004- 


-03- 


19 


D 


444111113 


11111 


2004- 


-03- 


19 


A 


444111113 


11113 


2004- 


-03- 


19 


A 


444111114 


11115 


2004- 


-03- 


19 


B 


444111115 


11115 


2004- 


-03- 


19 


F 


444111115 


11116 


2004- 


-03- 


19 


F 


444111116 


11111 


2004- 


-03- 


19 


D 


444111117 


11111 


2004- 


-03- 


19 


D 


444111118 


11111 


2004- 


-03- 


19 


A 


444111118 


11112 


2004- 


-03- 


19 


D 


444111118 


11113 


2004- 


-03- 


19 


B 



Figure 37.5 An Enrol 1 ment table stores student enrollment information. 



37.2.2 Integrity Constraints 

integrity constraint An integrity constraint imposes a condition that all the legal values in a table must satisfy. 

Figure 37.6 shows an example of some integrity constraints in the Subject and Course 
tables. 

In general, there are three types of constraints: domain constraints, primary key constraints, 
and foreign key constraints. Domain constraints and primary key constraints are known as 
intranational constraints, meaning that a constraint involves only one relation. The foreign 
key constraint is interregional, meaning that a constraint involves more than one relation. 

Domain Constraints 

domain constraint Domain constraints specify the permissible values for an attribute. Domains can be specified 

using standard data types, such as integers, floating-point numbers, fixed-length strings, and 
variant-length strings. The standard data type specifies a broad range of values. Additional con- 
straints can be specified to narrow the ranges. For example, you can specify that the 
numOfCredi ts attribute (in the Course table) must be greater than and less than 5. You can 
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Enrollment Table 



ssn 


courseld 


dateRegi si 


:ered 


grade 


444111110 


11111 


2004- 


-03- 


-19 


A 


444111110 


11112 


2004- 


-03- 


-19 


B 


444111110 


11113 


2004- 


-03- 


-19 


C 



Each value in cou rseld in the 
Enrollment table must match a value 
in courseld in the Course table 



Course Table 


courseld 


subjectld 


courseNumber 


title 


numOfCredi ts 




11111 


CSCI 


1301 


Introduction to Java I 


4 




11112 


CSCI 


1302 


Introduction to Java II 


3 




11113 


CSCI 


3720 


Database Systems 


3 



Each row must have a 
value for courseld, and 
the value must be unique 



Each value in the 

numOfCredi ts column must be 

greater than and less than 5 



Figure 37.6 The Enrol 1 ment table and the Course table have integrity constraints. 



also specify whether an attribute can be nul 1 , which is a special value in a database meaning 
unknown or not applicable. As shown in the Student table, bi rthDate may be nul 1 . 

Primary Key Constraints 

To understand primary keys, it is helpful to know superkeys, keys, and candidate keys. A primary key 
superkey is an attribute or a set of attributes that uniquely identifies the relation. That is, no superkey 
two tuples have the same values on a superkey. By definition, a relation consists of a set of 
distinct tuples. The set of all attributes in the relation forms a superkey. 

A key K is a minimal superkey, meaning that any proper subset of K is not a superkey. A re- 
lation can have several keys. In this case, each of the keys is called a candidate key. The 
primary key is one of the candidate keys designated by the database designer. The primary 
key is often used to identify tuples in a relation. As shown in Figure 37.6, courseld is the 
primary key in the Course table. 

Foreign Key Constraints 

In a relational database, data are related. Tuples in a relation are related, and tuples in different 
relations are related through their common attributes. Informally speaking, the common attrib- 
utes are foreign keys. The. foreign key constraints define the relationships among relations. foreign key 

Formally, a set of attributes FK is a. foreign key in a relation R that references relation T if 
it satisfies the following two rules: 

■ The attributes in FK have the same domain as the primary key in T. 

■ A nonnull value on FK in R must match a primary key value in T. 

As shown in Figure 37.6, courseld is the foreign key in Enrollment that references the 
primary key courseld in Course. Every courseld value must match a courseld value in 
Course. 

Enforcing Integrity Constraints 

The database management system enforces integrity constraints and rejects operations that auto enforcement 
would violate them. For example, if you attempted to insert a new record ('11115', 'CSCI', 
'2490', 'C++ Programming', 0) into the Course table, it would fail because the credit hours 
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must be greater than 0; if you attempted to insert a record with the same primary key as an ex- 
isting record in the table, the DBMS would report an error and reject the operation; if you at- 
tempted to delete a record from the Course table whose primary key value is referenced by 
the records in the Enrol 1 merit table, the DBMS would reject this operation. 

!§| Note 

All relational database systems support primary key constraints and foreign key constraints. Not 
all database systems support domain constraints. On the Microsoft Access database, for exam- 
ple, you cannot specify the constraint that numOfCredits is greater than and less than 5. 



37.3 SQL 

database language Structured Query Language (SQL) is the language for defining tables and integrity constraints 

and for accessing and manipulating data. SQL (pronounced "S-Q-L" or "sequel") is the uni- 
versal language for accessing relational database systems. Application programs may allow 
users to access a database without directly using SQL, but these applications themselves must 
use SQL to access the database. This section introduces some basic SQL commands. 



standard SQL 



MySQL Tutorial 
Oracle Tutorial 
Access Tutorial 



ft Note 

There are many relational database management systems. They share the common SQL language 
but do not all support every feature of SQL. Some systems have their own extensions to SQL. 
This section introduces standard SQL supported by all systems. 

SQL can be used on MySQL, Oracle, Sybase, IBM DB2, IBM Informix, Borland Interbase, 
MS Access, or any other relational database system. This chapter uses MySQL to demon- 
strate SQL and uses MySQL, Access, and Oracle to demonstrate JDBC programming. The 
book's Web site contains the following supplements on how to install and use three popular 
databases: MySQL, Oracle, and Access: 

■ Supplement IV.B: Tutorial for MySQL 

■ Supplement IV.C: Tutorial for Oracle 

■ Supplement IV.D: Tutorial for Microsoft Access 



37.3.1 Creating a User Account on MySQL 

Assume that you have installed MySQL 5 with the default configuration. To match all the ex- 
amples in this book, you should create a user named scott with password tiger. You can per- 
form the administrative tasks using the MySQL GUI Administrator tool or using the 
command line. Here are the steps to create a user from the command line: 

1. From the DOS command prompt, type 
mysql -uroot -p 

You will be prompted to enter the root password, as shown in Figure 37.7. 

2. At the mysql prompt, enter 
use mysql; 

3. To create user scott with password tiger, enter 

create user 'scott' @ 'localhost' identified by 'tiger'; 

grant select, insert, update, delete, create, drop, 
execute, references on *.* to 'scott' @ 'localhost'; 
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. command Prompt - mysql -uroot -p 



-lal*l 



C:\5mysql -uroot -p 

Enter password: hhxhkhkhxh 

Welcome to the- MySQL monitor. Commands end uith ; or \q. 
Your MySQL connection id is 29 

Seruer version: 5 . G . '3 7 ~ com muni ty-nt HySQL Community Edition (GPL) 

Type 'help; 1 or '\h° for help. Type "\c" to clear the buffer, 

mysql> use mysql ; 
Database changed 

mysql} create user "scott 'Q' loealhost L identified by tiger'; 
Query 0K r 3 rows affected (6.G2 sec) 

mysql > grant select, insert, update, delete, create, drop, 

-> execute, references on «.« to h scc t t '@' localhost ' ; 
Query OK, 3 rows affected (6.00 sec) 



mysql> exit ; 



J 



Figure 37.7 You can access a MySQL database server from the command window. 

4. Enter 
exit; 

to exit the MySQL console. 
Note 

On Windows, your MySQL database server starts every time your computer starts. You can stop it by 
typing the command net stop mysql and restart it by typing the command net start mysql. 

By default, the server contains two databases named mysql and test. The mysql database con- 
tains the tables that store information about the server and its users. This database is intended for 
the server administrator to use. For example, the administrator can use it to create users and grant 
or revoke user privileges. Since you are the owner of the server installed on your system, you 
have full access to the mysql database. However, you should not create user tables in the mysql 
database. You can use the test database to store data or create new databases. You can also cre- 
ate a new database using the command create database databasename or drop an exist- 
ing database using the command drop database databasename. 



start mysql 
stop mysql 



37.3.2 Creating a Database 

To match the examples in the book, you should create a database named javabook. Here are 
the steps to create it: 

1. From the DOS command prompt, type 

mysql -uscott -ptiger 

to login to mysql, as shown in Figure 37.8. 



■ ■■■ Command Prompt - mysql -uscott -ptiger 






C:\>mysql -uscott -ptiger 

Welcome to the MySQL monitor. Commands end uith ; or \g. 
Vour MySQL connection id is 33 

Server version; 5.0 . 37-community-nt MySQL Community Edition (GPL) 




Type 'help;' or ' \h " for help. Type ' \c ' to clear the 


buffer. 




mysql > create database javabook; 
Query OK, 1 row affected (Q 92 sec] 






nysql> show databases ; 




j 


<i i 


— 





Figure 37.8 You can create databases in MySQL. 
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2. At the mysql prompt, enter 

create database javabook; 

For your convenience, the SQL statements for creating and initializing tables used in the book 
is provided in Supplement IV.A. You can download the script for MySQL and save it to 
script.sql. To execute the script, first switch to the javabook database using the following 
command: use javabook; and then type 

run script file source script.sql; 

as shown in Figure 37.9. 



Welcome to the MySQL monitor. 
Jfour MySQL connection id is 2 
Server version : 5.1.35 



Commands end with ; or \g . 

ity MySQL Community Server <GPL> 

llype J help; J or J Sh J for help. Type J Sc J to clear the current input statement, 

nysql> create database jauahoak; 
Query OK, 1 row affected <0.03 sec) 

nysql> use javabook; 

Database changed 

[«ysql> source script.sql; 



i 



Figure 37.9 You can run SQL commands in a script file. 



37.3.3 Creating and Dropping Tables 

Tables are the essential objects in a database. To create a table, use the create tabl e state- 
ment to specify a table name, attributes, and types, as in the following example: 

create table create table Course ( 

courseld char(5) , 
subjectld char(4) not null, 
courseNumber integer, 
title varchar(50) not null, 
numOf Credits integer, 
primary key (courseld) 

); 

This statement creates the Course table with attributes courseld, subjectld, course- 
Number, title, and numOfCredits. Each attribute has a data type that specifies the type of 
data stored in the attribute. char(5) specifies that courseld consists of five characters. 
varchar(50) specifies that title is a variant-length string with a maximum of 50 charac- 
ters, integer specifies that courseNumber is an integer. The primary key is courseld. 
The tables Student and Enrol 1 ment can be created as follows: 



create table Student ( 
ssn char (9) , 
f i rstName varchar(25), 
mi char(l), 
lastName varchar(25), 
bi rthDate date , 
street varchar(25), 
phone char(ll) , 
zi pCode char (5) , 
deptld char(4) , 
primary key (ssn) 

); 



create table Enrollment ( 
ssn char (9) , 
courseld char(5) , 
dateRegi stered date, 
grade char(l) , 

primary key (ssn, courseld), 
foreign key (ssn) references 
Student (ssn) , 

foreign key (courseld) references 
(courseld) 

); 
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|ft Note 

SQL keywords are not case sensitive. This book adopts the following naming conventions: Tables naming convention 

are named in the same way as Java classes, and attributes are named in the same way as Java vari- 
ables. SQL keywords are named in the same way as Java keywords. 

If a table is no longer needed, it can be dropped permanently using the drop tabl e command. For 
example, the following statement drops the Course table: 

drop table Course; create table 

If a table to be dropped is referenced by other tables, you have to drop the other tables first. For 
example, if you have created the tables Course, Student, and Enrol 1 ment and want to drop 
Course, you have to first drop Enrol 1 ment, because Course is referenced by Enrol 1 ment. 
Figure 37.10 shows how to enter the create table statement from the mysql console. 



HH.I„l.,U,l,IU„I.M.,.UiU,!,Jl,.', 

mysejl> use jauabaok; 

Database changed 

myeql> drop table Course; 

Query OK, rows affected (O.BB sec) 

mysql'- create table Course!' 

courseld char(5} „ 
subject Id char(<Hl not null, 
courseNumber integer, 
title uare.har(5u) not null. 
nuHOf Credits integer, 
primary key (coureeld) 



Quf ry OK , 

mysql > 



Q rows affected (0.11 see) 



JnJjiJ 



Figure 37.10 The execution result of the SQL statements is displayed in the MySQL console. 



If you make typing errors, you have to retype the whole command. To avoid retyping, you 
can save the command in a file, and then run the command from the file. To do so, create a 
text file to contain commands, named, for example, test.sql. You can create the text file using 
any text editor, such as NotePad, as shown in Figure 37.1 1(a). To comment a line, precede it 
with two dashes. You can now run the script file by typing source test . sql from the SQL 
command prompt, as shown in Figure 37.1 1(b). 



_]njj£] 



Filft Ifit Fnrmah Help 



create table course (. 
<_uurielJ UidrCS), 
subjectld char(4) not null, 
cour s eNunber integer, 
tir[p varrhar ( Sujl nnr null, 
nuinofcredits integer, 
primary key (courselcO 



nysql> drop table Course; 

Query OK, rows affected <0.@0 sec) 

mysql> source c :SbookSTest _sql 
Query OK, rows affected CO. 80 sec) 



mysql) 

L±l_ 



J 



(a) (b) 
Figure 37.1 1 (a) You can use Notepad to create a text file for SQL commands, (b) You can 
run the SQL commands in a script file from MySQL. 



37.3.4 Simple Insert, Update, and Delete 

Once a table is created, you can insert data into it. You can also update and delete records. 
This section introduces simple insert, update, and delete statements. 
The general syntax to insert a record into a table is: 

insert into tableName [(columnl, column2, . . . , column)] 
values (valuel, value2, . . . , valuen); 
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For example, the following statement inserts a record into the Course table. The new record has 
the courseld '11113', subjectld 'CSCI', courseNumber 3720, title 'Database Systems', 
and creditHours 3. 

insert into Course (courseld, subjectld, courseNumber, title, numOf Credits) 
values ('11113', 'CSCI', '3720', 'Database Systems', 3); 

The column names are optional. If they are omitted, all the column values for the record must 
be entered, even though the columns have default values. String values are case sensitive and 
enclosed inside single quotation marks in SQL. 
The general syntax to update a table is: 

update tableName 

set columnl = newValuel [, column2 = newValue2, ...] 
[where condition]; 

For example, the following statement changes the numOf Credits for the course whose 
title is Database Systems to 4. 

update Course 

set numOfCredits = 4 

where title = 'Database Systems'; 

The general syntax to delete records from a table is: 

delete [from] tableName 
[where condition]; 

For example, the following statement deletes the Database Systems course from the Course 
table: 

delete Course 

where title = 'Database System'; 
The following statement deletes all the records from the Course table: 
delete Course; 

37.3.5 Simple Queries 

To retrieve information from tables, use a sel ect statement with the following syntax: 

select column-list 
from table-list 
[where condition]; 

The sel ect clause lists the columns to be selected. The from clause refers to the tables in- 
volved in the query. The optional where clause specifies the conditions for the selected rows. 
Query 1: Select all the students in the CS department, as shown in Figure 37.12. 

select firstName, mi, lastName 

from Student 

where deptld = 'CS'; 

37.3.6 Comparison and Boolean Operators 

SQL has six comparison operators, as shown in Table 37.1, and three Boolean operators, as 
shown in Table 37.2. 
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nysql> select firstNarae, mi, last Name 
— > frnm Rtudent: 
-> where deptld = J CS J ; 

4 + + + 

! F xi h stNane ! ni ! lastNans ! 




A 


■* + + + 

! George ! E ! Heintz ! 
! ilny ! P ! Kennedy ! 




4 + 4 4 

7. pfius in set CR.Ifi srh} 






mysnrl > 






*\ 1 


_L 





Figure 37.1 2 The result of the select statement is displayed in a window. 

Table 37.1 Comparison Operators Table 37.2 Boolean Operators 



Operator Description Operator Description 

Equal to not logical negation 

<> or ! = Not equal to and logical conjunction 

Less than or logical disjunction 

<= Less or equal to 

> Greater than 

>= Greater than or equal to 



||t Note 

The comparison and Boolean operators in SQL have the same meaning as in Java. In SQL the 
equal to operator is =, but in Java it is ==. In SQL the not equal to operator is <> or 
! = , but in Java it is ! = . The not, and, and or operators are ! , && (&), and | | ( | ) in Java. 

Query 2: Get the names of the students who are in the CS dept and live in the zip code 3141 1. 

select firstName, mi, lastName 
from Student 

where deptld = 'CS' and zipCode = '31411'; 
Igl Note 

To select all the attributes from a table, you don't have to list all the attribute names in the select 
clause. Instead you can just use an asterisk (*), which stands for all the attributes. For example, 
the following query displays all the attributes of the students who are in the CS dept and live in 
zip code 3141 1: 

select * 
from Student 

where deptld = 'CS' and zipCode = '31411'; 

37.3.7 The 1 ike, between-and, and is null Operators 

SQL has a 1 i ke operator that can be used for pattern matching. The syntax to check whether 
a string s has a pattern p is 

s 1 i ke p or s not 1 i ke p 

You can use the wild-card characters % (percent symbol) and _ (underline symbol) in the pattern 
p. % matches zero or more characters, and _ matches any single character in s. For example, 
lastName like '_mi%' matches any string whose second and third letters are m and i. 
lastName not 1 ike '_mi%' excludes any string whose second and third letters are m and i. 
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§ Note 

On the earlier version of MS Access, the wild-card character is *, and the character ? matches any 
single character. 

The between-and operator checks whether a value v is between two other values, vl and 
v2, using the following syntax: 

v between vl and v2 or v not between vl and v2 

v between vl and v2 is equivalent to v >= vl and v <= v2, and v not 
between vl and v2 is equivalent to v < vl or v > v2. 

The i s nul 1 operator checks whether a value v is nul 1 using the following syntax: 

v is null orv is not null 

Query 3: Get the social security numbers of the students whose grades are between 'C and 'A'. 

select ssn 
from Enrollment 

where grade between 'C and 'A' ; 

37.3.8 Column Alias 

When a query result is displayed, SQL uses the column names as column headings. Usually 
the user gives abbreviated names for the columns, and the columns cannot have spaces when 
the table is created. Sometimes it is desirable to give more descriptive names in the result 
heading. You can use the column aliases with the following syntax: 

select columnName [as] alias 

Query 4: Get the last name and zip code of the students in the CS department. Display the col- 
umn headings as Last Name for lastName and Zip Code for zipCode. The query result is 
shown in Figure 37.13. 

select lastName as "Last Name", zipCode as "Zip Code" 

from Student 

where deptld = 'CS'; 



Command Prompt - mysql 


-Inl 


x| 


nysql> select lastName as "Last Nane", 
-> from Student 
-> where deptld = *CS J ; 


zipCode as "Zip Code" 


±1 


+ + + 

! Last Nane ! Zip Code ! 






! Heintz ! 31419 ! 
! Kennedy ! 31412 ! 






2 rows in set (0.00 sec) 






mysql > 


i ►n! 





Figure 37.1 3 You can use a column alias in the display. 
tg|t Note 

The as keyword is optional in MySQL and Oracle but is required in MS Access. 

37.3.9 The Arithmetic Operators 

You can use the arithmetic operators * (multiplication), / (division), + (addition), and - (sub- 
traction) in SQL. 
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Query 5: Assume that a credit hour is 50 minutes of lectures; get the total minutes for each 
course with the subject CSCI. The query result is shown in Figure 37.14. 

select title, 50 * numOfCredi ts as "Lecture Minutes Per Week" 
from Course 

where subjectld = 'CSCI'; 



Command Prompt - mysql 






- la] ^1 


iyaql> select title, 59 ** 
> f rem Course 
— y where subject Id - 


n unOf Gi'c d it 3 as 
CSCI " i 


"Lecture Ninutc3 


Per Uccli" 




i title 


Lecture Minutes 


1 

Per Meek ; 






! lntrn tn Jaua 1 

! Intro to Jaua II 

! Database Systems 

! Rapid Java Application 




1 

?.na : 

159 ! 
159 ! 
15B ! 






1 rows In set <&.&& sec> 










«ysojl> 












1 


1 











Figure 37.14 You can use arithmetic operators in SQL. 

37.3.10 Displaying Distinct Tuples 

SQL provides the distinct keyword, which can be used to suppress duplicate tuples in the 
output. For example, the following statement displays all the subject IDs used by the courses: 

select subjectld as "Subject ID" 
from Course; 

This statement displays all the subject IDs. To display distinct tuples, add the di sti net key- 
word in the sel ect clause, as follows: 

select distinct subjectld as "Subject ID" 
from Course; 

When there is more than one item in the sel ect clause, the di sti net keyword applies to all 
the items that find distinct tuples. 

37.3.1 I Displaying Sorted Tuples 

SQL provides the order by clause to sort the output using the following general syntax: 

select column-list 

from table-list 

[where condition] 

[order by columns-to-be-sorted]; 

In the syntax, columns-to-be-sorted specifies a column or a list of columns to be sorted. 
By default, the order is ascending. To sort in descending order, append the desc keyword after 
columns-to-be-sorted. You could also append the asc keyword, but it is not necessary. 
When multiple columns are specified, the rows are sorted based on the first column, then the 
rows with the same values on the first column are sorted based on the second column, and so on. 

Query 6: List the full names of the students in the CS department, ordered primarily on 
their last names in descending order and secondarily on their first names in ascending order. 
The query result is shown in Figure 37.15. 

select lastName, firstName, deptld 

from Student 

where deptld = 'CS' 

order by lastName desc, firstName asc; 



1286 Chapter 37 Java Database Programming 



Command Prompt - mysql 




xj 


[mysql> se lect last Name, f irstName , dept Id 
-> from Student 
-> where deptld = J CS* 

-> order by lastName desc, f irstNane asc; 




il 

1 


+ + + + 

! lastNane ! f irstNane ! deptld ! 
+ + + + 






! Kennedy ! Joy ! CS ! 
! Heintz ! George ! CS ! 






+ + + + 

2 rows in set <0.@2 sec) 






[iysql> _ 






<l 1 




r 



Figure 37.15 You can sort results using the order by clause. 



37.3.12 Joining Tables 

Often you need to get information from multiple tables, as demonstrated in the next query. 

Query 7: List the courses taken by student Jacob Smith. To solve this query, you need to 
join tables Student and Enrollment, as shown in Figure 37.16. 



A tuple ■ 



Student Table 
ssn lastName mi f i rstName ... 



Enrollment Table 
ssn courseld 



Equal 



Figure 37.16 Student and Enrollment are joined on ssn. 



You can write the query in SQL: 

select distinct lastName, fi rstName, courseld 

from Student, Enrollment 

where Student. ssn = Enrollment. ssn and 

lastName = 'Smith' and fi rstName = 'Jacob'; 



The tables Student and Enrol 1 ment are listed in the from clause. The query examines every 
pair of rows, each made of one item from Student and another from Enrollment, and se- 
lects the pairs that satisfy the condition in the where clause. The rows in Student have the 
last name, Smith, and the first name, Jacob, and both rows from Student and Enrollment 
have the same ssn values. For each pair selected, 1 astName and f i rstName from Student 
and courseld from Enrollment are used to produce the result, as shown in Figure 37.17. 
Student and Enrollment have the same attribute ssn. To distinguish them in a query, use 
Student . ssn and Enrol 1 ment . ssn. 

For more features of SQL, see Supplement IV.H and Supplement IV.I. 



37.4 JDBC 

The Java API for developing Java database applications is called JDBC. JDBC is the trade- 
marked name of a Java API that supports Java programs that access relational databases. 
JDBC is not an acronym, but it is often thought to stand for Java Database Connectivity. 

JDBC provides Java programmers with a uniform interface for accessing and manipulat- 
ing a wide range of relational databases. Using the JDBC API, applications written in the 
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njFsq;l> select distinct lastName, first Name, courseld 
-> from Student, Enrollment 
— > where Student .ssn = Enrollment .ssn and 
-> lastNane = J Snith J and firstName = J Jacob J ; 


±1 




last Name 


f irstName 


courseld ! 




Smith 
Smith 
Smith 


Jacob 
Jacob 
Jacob 


11111 i 

11112 i 

11113 i 


3 rows in set sec) 
[«ysql> 




<\ I 





Figure 37.1 7 Query 7 demonstrates queries involving multiple tables. 



Java programming language can execute SQL statements, retrieve results, present data in a 
user-friendly interface, and propagate changes back to the database. The JDBC API can also 
be used to interact with multiple data sources in a distributed, heterogeneous environment. 

The relationships between Java programs, JDBC API, JDBC drivers, and relational data- 
bases are shown in Figure 37.18. The JDBC API is a set of Java interfaces and classes used to 
write Java programs for accessing and manipulating relational databases. Since a JDBC driver 
serves as the interface to facilitate communications between JDBC and a proprietary data- 
base, JDBC drivers are database specific and are normally provided by the database vendors. 
You need MySQL JDBC drivers to access the MySQL database, and Oracle JDBC drivers to 
access the Oracle database. For the Access database, use the JDBC-ODBC bridge driver in- 
cluded in JDK. ODBC is a technology developed by Microsoft for accessing databases on the 
Windows platform. An ODBC driver is preinstalled on Windows. The JDBC-ODBC bridge 
driver allows a Java program to access any ODBC data source. 




JDBC-ODBC 
Bridge Driver 



Microsoft ODBC 
Driver 







Microsoft Access 
Database 



Figure 37.1 8 Java programs access and manipulate databases through JDBC drivers. 



37.4-1 Developing Database Applications Using JDBC 

The JDBC API is a Java application program interface to generic SQL databases that enables 
Java developers to develop DBMS-independent Java applications using a uniform interface. 

The JDBC API consists of classes and interfaces for establishing connections with data- 
bases, sending SQL statements to databases, processing the results of the SQL statements, 
and obtaining database metadata. Four key interfaces are needed to develop any database 
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application using Java: Driver, Connection, Statement, and Resul tSet. These interfaces 
define a framework for generic SQL database access. The JDBC API defines these interfaces. 
The JDBC driver vendors provide implementation for them. Programmers use the interfaces. 

The relationship of these interfaces is shown in Figure 37.19. A JDBC application loads an 
appropriate driver using the Driver interface, connects to the database using the Connection 
interface, creates and executes SQL statements using the Statement interface, and processes 
the result using the Resul tSet interface if the statements return results. Note that some state- 
ments, such as SQL data definition statements and SQL data modification statements, do not 
return results. 



Driver 




Connection I Connection 



Statement | 
\ 


Statement | 

t 


Statement | 

t 


Statement | 

i 


ResultSet | 


ResultSet | 


ResultSet | 


ResultSet | 



Figure 37.1 9 JDBC classes enable Java programs to connect to the database, send SQL 
statements, and process results. 

The JDBC interfaces and classes are the building blocks in the development of Java data- 
base programs. A typical Java program takes the steps outlined below to access the database. 

1. Loading drivers. 

An appropriate driver must be loaded using the statement shown below before connecting to 
a database. 

Class . f orName ("JDBCDr i verCl ass") ; 

A driver is a concrete class that implements the j ava . sql . Dr i ver interface. The drivers for 
Access, MySQL, and Oracle are listed in Table 37.3. 

Table 37.3 JDBC Drivers 

Database Driver Class Source 

Access sun. jdbc . odbc . JdbcOdbcDri ver Already in JDK 

MySQL com. mysql . jdbc. Driver Companion Web site 

Oracle oracl e . jdbc . driver .Oracl eDri ver Companion Web site 

The JDBC-ODBC driver for Access is bundled in JDK. The MySQL JDBC driver is contained 
mysqljdbc.jar in mysql jdbc . jar (downloadable from www.cs.armstrong.edu/liang/intro8e/book/lib/mysqljdbc.jar). 

ojdbc6.jar The Oracle JDBC driver is contained in ojdbc6 .jar (downloadable from www.cs.armstrong.edu/ 

liang/intro8e/book/lib/ojdbc6.jar). To use the MySQL and Oracle drivers, you have to add 
mysqljdbc.jar and ojdbc6.jar in the classpath using the following DOS command on Windows: 

set cl asspath=%cl asspath%; c : \book\mysql jdbc . jar ; c : \book\ojdbc6 . jar 
If your program accesses several different databases, all their respective drivers must be loaded. 
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§ Note 

com. mysql . jdbc. Driver is a class in mysql jdbc. jar, and oracle, jdbc. driver . why load a driver? 

OracleDriver is a class in ojdbc6.jar. mysql jdbc. jar and ojdbc6.jar contain 
many classes to support the driver. These classes are used by JDBC, but not directly by JDBC pro- 
grammers. When you use a class explicitly in the program, it is automatically loaded by the JVM. 
The driver classes, however, are not used explicitly in the program, so you have to write the code 
to tell the JVM to load them. 

|§jt Note 

Java 6 supports automatic driver discovery, so you don't have to load the driver explicitly. At automatic driver discovery 

the time of this writing, however, this feature is not supported for all drivers. To be safe, load 
the driver explicitly. 

2. Establishing connections. 

To connect to a database, use the static method getConnection(databaseURL) in the 
DriverManager class, as follows: 

Connection connection = Dri verManager . getConnecti on(databaseURL) ; 

where databaseURL is the unique identifier of the database on the Internet. Table 37.4 lists 
the URLs for the MySQL, Oracle, and Access databases. 



Table 37.4 JDBC URLs 

Database URL Pattern 



Access jdbc:odbc:dataSource 

MySQL jdbc: mysql ://hostname/dbname 

Oracle jdbc : oracl e : thi n : ©hostname : port* : oracl eDBSID 

For an ODBC data source, the databaseURL is jdbc:odbc:dataSource. An ODBC 
data source can be created using the ODBC Data Source Administrator on Windows. See 
Supplement IV.D, "Tutorial for Microsoft Access," on how to create an ODBC data source for 
an Access database. 

Suppose a data source named ExampleMDBDataSource has been created for an Access 
database. The following statement creates a Connection object: 

Connection connection = DriverManager. getConnecti on connect Access DB 

("jdbc:odbc: ExampleMDBDataSource") ; 

The databaseURL for a MySQL database specifies the host name and database name to lo- 
cate a database. For example, the following statement creates a Connection object for the 
local MySQL database j avabook with username scott and password tiger. 

Connection connection = Dri verManager . getConnecti on connect MySQL DB 

("jdbc:mysql : //local host/ j avabook" , "scott", "tiger"); 

Recall that by default MySQL contains two databases named mysql and test. §37.3.2, "Creat- 
ing a Database," created a custom database named j avabook. We will use j avabook in the 
examples. 

The databaseURL for an Oracle database specifies the hostname, the port# where the data- 
base listens for incoming connection requests, and the oracleDBSID database name to locate a 
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database. For example, the following statement creates a Connection object for the Oracle 
database on liang.armstrong.edu with username scott and password tiger. 

connect Oracle DB Connection connection = DriverManager.getConnection 

(" jdbc :oracl e: thin: @1 iang .armstrong.edu : 1521 :orcl " , 
"scott", "tiger"); 

3. Creating statements. 

If a Connection object can be envisioned as a cable linking your program to a database, 
an object of Statement can be viewed as a cart that delivers SQL statements for execu- 
tion by the database and brings the result back to the program. Once a Connection object 
is created, you can create statements for executing SQL statements as follows: 

Statement statement = connection. createStatementO ; 

4. Executing statements. 

An SQL DDL or update statement can be executed using executeUpdate(String sql), 
and an SQL query statement can be executed using executeQuery (String sql). The 
result of the query is returned in Resul tSet. For example, the following code executes the 
SQL statement create table Temp (coll char(5) , col 2 char(5)): 

statement . executeUpdate 

("create table Temp (coll char (5), col 2 char (5))"); 

The next code executes the SQL query sel ect f i rstName , mi , 1 astName from Student 
where 1 astName = ' Smi th ' : 

// Select the columns from the Student table 
ResultSet resultSet = statement . executeQuery 

("select fi rstName, mi, 1 astName from Student where 1 astName " 
+ " = 'Smith'"); 

5. Processing Resul tSet. 

The Resul tSet maintains a table whose current row can be retrieved. The initial row posi- 
tion is nul 1 . You can use the next method to move to the next row and the various get meth- 
ods to retrieve values from a current row. For example, the code given below displays all the 
results from the preceding SQL query. 

// Iterate through the result and print the student names 
while (resultSet . next()) 

System. out. println(resultSet.getString(l) + " " + 

resultSet. getString(2) + ". " + resultSet. getString(3)) ; 

The getString(l), getString(2), and getString(3) methods retrieve the column values 
for fi rstName, mi, and 1 astName, respectively. Alternatively, you can use getString- 
("fi rstName"), getString("mi"), and getString("l astName") to retrieve the same 
three column values. The first execution of the next () method sets the current row to the first 
row in the result set, and subsequent invocations of the next() method set the current row to 
the second row, third row, and so on, to the last row. 

Listing 37. 1 is a complete example that demonstrates connecting to a database, executing a 
simple query, and processing the query result with JDBC. The program connects to a local 
MySQL database and displays the students whose last name is Smith. 
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Listing 37.1 Simple JDBC. java 

1 import java.sql.*; 

2 

3 public class Simpl eJdbc { 

4 public static void main(String[] args) 



5 throws SQLException, ClassNotFoundException { 

6 // Load the JDBC driver 

7 CI ass. forName ("com. mysql . jdbc. Driver ") ; load driver 

8 System. out. pri ntl n("Driver loaded"); 
9 

10 // Establish a connection 

11 Connection connection = Dri verManager . getConnecti on connect database 

12 ("jdbc: mysql ://local host/javabook" , "scott", "tiger"); 

13 System. out. pri ntl n ("Database connected"); 
14 

15 // Create a statement 

16 Statement statement = connection . createStatement() ; create statement 
17 

18 // Execute a statement 

19 ResultSet resultSet = statement . executeQuery execute statement 

20 ("select firstName, mi, lastName from Student where lastName " 

21 + " = 'Smith'"); 

22 

23 // Iterate through the result and print the student names 

24 while (resul tSet . next() ) getresult 

25 System. out. println(resultSet.getString(l) + "\t" + 

26 resultSet. getString(2) + "\t" + resul tSet . getStri ng(3) ) ; 
27 

28 // Close the connection 

29 connection. close() ; close connection 



30 } 

31 } 

The statement in line 7 loads a JDBC driver for MySQL, and the statement in lines 1 1-13 connects 
to a local MySQL database. You may change them to connect to an Access or Oracle database. 
The last statement (line 29) closes the connection and releases resource related to the connection. 

<^> 

f§| Note 

If you run this program from the DOS prompt, specify the appropriate driver in the classpath, as run from DOS prompt 

shown in Figure 37.20. 



f - \ Command Prompt 




JL 


C;\book>jaua -cp . ; 1 ib/myoql jdbc 


jar Simp 1 * Jdbc 




Driuer loaded 






Database connected 




1 


Jean K Smith 






Josh R Smith 






C;\book>_ 






.1 1 


2} 





Figure 37.20 You must include the driver file to run Java database programs. 

The classpath directory and jar files are separated by commas. The period ( . ) represents the cur- 
rent directory. For convenience, the driver files are placed under the lib directory. 

Hit Caution 

Do not use a semicolon ( ; ) to end the Oracle SQL command in a Java program. The semicolon may the semicolon issue 

not work with the Oracle JDBC drivers. It does work, however, with the other drivers used in the book. 
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§ Note 

The Connection interface handles transactions and specifies how they are processed. By de- 
auto commit fault, a new connection is in autocommit mode, and all its SQL statements are executed and 

committed as individual transactions. The commit occurs when the statement completes or the 
next execute occurs, whichever comes first. In the case of statements returning a result set, the 
statement completes when the last row of the result set has been retrieved or the result set has 
been closed. If a single statement returns multiple results, the commit occurs when all the results 
have been retrieved. You can use the setAutoCommit(fal se) method to disable autocom- 
mit, so that all SQL statements are grouped into one transaction that is terminated by a call to ei- 
ther the commitO or the rollbackO method. The rollbackO method undoes all the 
changes made by the transaction. 



37.4-2 Accessing a Database from a Java Applet 

Using the JDBC-ODBC bridge driver, your program cannot run as an applet from a Web brows- 
er because the ODBC driver contains non-Java native code. The JDBC drivers for MySQL and 
Oracle are written in Java and can run from the JVM in a Web browser. This section gives an ex- 
ample that demonstrates connecting to a database from a Java applet. The applet lets the user 
enter the SSN and the course ID to find a student's grade, as shown in Figure 37.21. The code in 
Listing 37.2 uses the MySQL database on the localhost. 



Applet 



Applet Viewer: FinrJGrade.class 



SSN 444111110 Course ID 11111 



Applet started. 



Jnjjcj 



Show Grade 



^ \_J Sniili R Jamb's; un i:uLiive liAro I'j Java I is A 

m 

Jqvq Applet Window 



H Applet Viewer: FitidGrade, class 


_|n|x| 


Applet 


SSH 44411111^1 | CourseD |11111 


Show Grade 




Applet started. 





Message 




.^t J MA Tomir.1 








Java Applet Window 



Figure 37.2 1 A Java applet can access the database on the server. 



Listing 37.2 Fi ndCrade . java 

1 import javax. swing.*; 

2 import java.sql.*; 

3 import java.awt.*; 

4 import java.awt. event.*; 
5 

6 public class FindCrade extends J Applet { 

7 private JTextField jtfSSN = new JTextField(9) ; 

8 private JTextField jtfCourseld = new JTextField(5) ; 

9 private JButton jbtShowGrade = new JButton("Show Grade"); 
10 

11 // Statement for executing queries 

12 private Statement stmt; 
13 

14 /** Initialize the applet */ 

15 public void init() { 

16 // Initialize database connection and create a Statement object 

17 initializeDBO ; 
18 
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19 jbtShowGrade.addActionListener( button listener 

20 new java.awt. event. Acti onLi stenerO { 

21 public void acti on Performed (Acti on Event e) { 

22 jbtShowGrade_actionPerformed(e) ; 

23 } 

24 }); 
25 

26 J Panel j Panel 1 = new JPanelO; 

27 j Panel 1. add (new JLabel ("SSN")) ; 

28 j Panel 1. add (jtf SSN); 

29 j Panel 1. add (new JLabel ("Course ID")); 

30 jPanell.add(jtfCourseld) ; 

31 jPanell.add(jbtShowCrade) ; 
32 

33 add (j Panel 1, BorderLayout . NORTH) ; 

34 } 
35 

36 private void initializeDBO { 

37 try { 

38 // Load the JDBC driver 

39 Class. forName("com. mysql . jdbc. Driver") ; loaddriver 

40 // Class. forName("oracle. jdbc. driver. OracleDriver") ; Oracle driver commented 

41 System. out. pri ntl n("Driver loaded"); 
42 

43 // Establish a connection 

44 Connection connection = DriverManager.getConnection connect to MySQL database 

45 ("jdbc:mysql : //local host/ javabook", "scott", "tiger"); 

46 // (" jdbc :oracl e : thi n : @1 i ang . armstrong . edu : 1521:orcl " , connect to Oracle commented 

47 // "scott", "tiger"); 

48 System. out . pri ntl n ("Database connected"); 

49 

50 // Create a statement 

51 stmt = connect! on . createStatement() ; create statement 

52 } 

53 catch (Exception ex) { 

54 ex . pri ntStackTrace() ; 

55 } 

56 } 
57 

58 private void jbtShowGrade_actionPerformed(ActionEvent e) { 

59 String ssn = jtfSSN . getText() ; 

60 String courseld = jtfCourseld.getTextO ; 

61 try { 

62 String queryString = "select firstName, mi, " + 

63 "lastName, title, grade from Student, Enrollment, Course " + 

64 "where Student. ssn = '" + ssn + "' and Enrollment. courseld " 

65 + "= "' + courseld + 

66 "' and Enrollment. courseld = Course. courseld " + 

67 " and Enrollment. ssn = Student . ssn" ; 
68 

69 ResultSet rset = stmt . executeQuery(queryStri ng) ; execute statement 

70 

71 if (rset . next () ) { show result 

72 String lastName = rset.getString(l) ; 

73 String mi = rset . getStri ng(2) ; 

74 String firstName = rset . getStri ng(3) ; 

75 String title = rset.getString(4) ; 

76 String grade = rset.getString(5) ; 
77 
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78 // Display result in a dialog box 

79 10ptionPane.showMessageDialog(null , f i rstName + " " + mi + 

80 " " + lastName + "'s grade on course "+ title +" is " + 

81 grade); 

82 } else { 

83 // Display result in a dialog box 

84 10ptionPane.showMessageDialog(null , "Not found"); 

85 } 

86 } 

87 catch (SQLExcepti on ex) { 

88 ex.printStackTrace() ; 

89 } 



90 } 

main method omitted 91 } 

The i ni t i al i zeDB () method (lines 36-56) loads the MySQL driver (line 39), connects to the 
MySQL database on host liang.armstrong.edu (lines 44^45), and creates a statement (line 51). 

You can run the applet standalone from the man n method (note that the listing for the mai n 
method is omitted for all the applets in the book for brevity) or test the applet using the ap- 
pletviewer utility, as shown in Figure 37.21. If this applet is deployed on the server where the 
database is located, any client on the Internet can run it from a Web browser. Since the client 
may not have a MySQL driver, you should specify the driver in the archive attribute in the ap- 
plet tag, as follows: 

<appl et 

code = "FindGrade" 

archive = "FindGrade. jar, lib/mysql jdbc. jar" 
width = 380 
height = 80 

> 

</applet> 



Note 

create archive file For information on how to create an archive file, see Supplement 1 I I.Q, "Packaging and Deploy- 

ing Java Projects." The FindGrade.jar file can be created using the following command: 



c:\book>jar -cf FindGrade.jar FindGrade. class FindGradeSl. class 
%g? Note 

applet security restriction To access the database from an applet, security restrictions make it necessary for the applet to be 

downloaded from the server where the database is located. Therefore, you have to deploy the ap- 
plet on the server. 



% Note 

security hole There is a security hole in this program. If you enter 1 ' or true or ' 1 in the SSN field, you will 

get the first student's score, because the query string now becomes 

select fi rstName, mi, lastName, title, grade 
from Student, Enrollment, Course 
where Student. ssn = '1' or true or '1' and 
Enrollment . courseld = ' ' and 
Enrollment. courseld = Course. courseld and 
Enrollment . ssn = Student. ssn; 

You can avoid this problem by using the PreparedStatement. 
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37.5 PreparedStatement 

Once a connection to a particular database is established, it can be used to send SQL state- 
ments from your program to the database. The Statement interface is used to execute static 
SQL statements that contain no parameters. The PreparedStatement interface, extending 
Statement, is used to execute a precompiled SQL statement with or without parameters. 
Since the SQL statements are precompiled, they are efficient for repeated executions. 

A PreparedStatement object is created using the preparedStatement method in 
the Connection interface. For example, the following code creates a PreparedState- 
ment preparedStatement on a particular Connection connection for an SQL 
insert statement: 

Statement preparedStatement = connection . prepareStatement 
("insert into Student (firstName, mi, lastName) " + 
"values (?, ?, ?)"); 

This insert statement has three question marks as placeholders for parameters representing 
values for f i rstName, mi , and 1 astName in a record of the Student table. 

As a subinterface of Statement, the PreparedStatement interface inherits all the methods 
defined in Statement. It also provides the methods for setting parameters in the object of 
PreparedStatement. These methods are used to set the values for the parameters before execut- 
ing statements or procedures. In general, the set methods have the following name and signature: 

setX(int parameterlndex , X value); 

where X is the type of the parameter, and parameterlndex is the index of the parameter in 
the statement. The index starts from 1. For example, the method setStringCint 
paramterlndex , Stri ng val ue) sets a Stri ng value to the specified parameter. 

The following statements pass the parameters "Jack", "A", and "Ryan" to the placeholders 
for firstName, mi, and lastName in PreparedStatement preparedStatement: 

preparedStatement. setString(l, "Jack") ; 
preparedStatement . setStri ng(2 , "A") ; 
preparedStatement . setStri ng(3 , "Ryan") ; 

After setting the parameters, you can execute the prepared statement by invoking 
executeQueryO for a SELECT statement and executeUpdateO for a DDL or update 
statement. 

The executeQueryO and executeUpdateO methods are similar to the ones defined 
in the Statement interface except that they have no parameters, because the SQL state- 
ments are already specified in the preparedStatement method when the object of 
PreparedStatement is created. 

Using a prepared SQL statement, Listing 37.2 can be improved as in Listing 37.3. 

Listing 37.3 Fi ndCradeUsi ngPreparedStatement . java 

1 import javax. swing.*; 

2 import java.sql.*; 

3 import java.awt.*; 

4 import java.awt. event.*; 
5 

6 public class Fi ndCradeUsi ngPreparedStatement extends JApplet { 

7 private JTextField jtfSSN = new JTextField(9) ; 

8 private JTextField jtfCourseld = new JTextField(5) ; 

9 private JButton jbtShowGrade = new JButton("Show Grade"); 
10 
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11 // PreparedStatement for executing queries 

12 private PreparedStatement preparedStatement ; 
13 

14 /** Initialize the applet */ 

15 public void init() { 

16 // Initialize database connection and create a Statement object 

17 initializeDBO ; 
18 

19 j btShowCrade . addActi on Li stener ( 

20 new java.awt. event. Acti onLi stenerO { 

21 public void actionPerformed(ActionEvent e) { 

22 jbtShowGrade_actionPerformed(e) ; 

23 } 

24 }); 
25 

26 J Panel j Panel 1 = new JPanelO; 

27 j Panel 1. add (new JLabel ("SSN")) ; 

28 jPanell.add(jtfSSN) ; 

29 j Panel 1. add (new JLabel ("Course ID")); 

30 jPanell.add(jtfCourseld) ; 

31 jPanell.add(jbtShowCrade) ; 
32 

33 add(jPanell, BorderLayout . NORTH) ; 

34 } 
35 

36 private void initializeDBO { 

37 try { 

38 // Load the JDBC driver 

loaddriver 39 CI ass . forName("com . mysql . jdbc . Driver") ; 

40 // Class. forName("oracl e . jdbc. driver. OracleDriver") ; 

41 System. out. pri ntl n("Driver loaded"); 
42 

43 // Establish a connection 

connect database 44 Connection connection = DriverManager.getConnection 

45 ("jdbc: mysql : //local host/ javabook" , "scott", "tiger"); 

46 // (" jdbc :oracl e : thi n : @1 i ang . armstrong . edu : 1521:orcl " , 

47 // "scott", "tiger"); 

48 System. out. pri ntl n ("Database connected"); 

49 

50 String queryString = "select firstName, mi, " + 

51 "lastName, title, grade from Student, Enrollment, Course " + 
placeholder 52 "where Student. ssn = ? and Enroll ment . courseld = ? " + 

53 "and Enroll ment. courseld = Course. courseld" ; 

54 

55 // Create a statement 

prepare statement 56 preparedStatement = connection. prepareStatement(queryString) ; 

57 } 

58 catch (Exception ex) { 

59 ex . pri ntStackTrace() ; 

60 } 

61 } 
62 

63 private void jbtShowGrade_actionPerformed(ActionEvent e) { 

64 String ssn = jtfSSN . getText() ; 

65 String courseld = jtfCourseld.getTextO ; 

66 try { 

67 preparedStatement . setStri ng(l , ssn); 

68 preparedStatement . setStri ng(2 , courseld); 

execute statement 69 ResultSet rset = preparedStatement . executeQueryO ; 

70 
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71 if (rset.nextO) { show result 

72 String lastName = rset.getString(l) ; 

73 String mi = rset . getStri ng(2) ; 

74 String fi rstName = rset . getStri ng(3) ; 

75 String title = rset.getString(4) ; 

76 String grade = rset.getString(5) ; 
77 

78 // Display result in a dialog box 

79 JOptionPane.showMessageDialog(null , fi rstName + " " + mi + 

80 " " + lastName + '"s grade on course " + title + " is " + 

81 grade); 

82 } 

83 else { 

84 // Display result in a dialog box 

85 JOptionPane.showMessageDialog(null , "Not found"); 

86 } 

87 } 

88 catch (SQLException ex) { 

89 ex . pri ntStackTrace() ; 

90 } 

91 } 

92 } main method omitted 



This example does exactly the same thing as Listing 37.2 except that it uses the prepared 
statement to dynamically set the parameters. The code in this example is almost the same as 
in the preceding example. The new code is highlighted. 

A prepared query string is defined in lines 50-53 with ssn and courseld as parameters. 
An SQL prepared statement is obtained in line 56. Before executing the query, the actual val- 
ues of ssn and courseld are set to the parameters in lines 67-68. Line 69 executes the pre- 
pared statement. 



37.6 CallableStatement 

The Cal 1 abl eStatement interface is designed to execute SQL-stored procedures. The pro- 
cedures may have IN, OUT or IN OUT parameters. An IN parameter receives a value passed to 
the procedure when it is called. An OUT parameter returns a value after the procedure is com- 
pleted, but it contains no value when the procedure is called. An IN OUT parameter contains 
a value passed to the procedure when it is called, and returns a value after it is completed. For 
example, the following procedure in Oracle PL/SQL has IN parameter pi, OUT parameter p2, 
and IN OUT parameter p3. 

create or replace procedure sampleProcedure 

(pi in varchar, p2 out number, p3 in out integer) is 
begin 

-- do something 
end sampleProcedure; 
/ 



IN parameter 
OUT parameter 
IN OUT parameter 



§ Note 

The syntax of stored procedures is vendor specific. Oracle PL/SQL is used for demonstrations of 
stored procedures in this book. PL/SQL is a procedural language extension of SQL. It is a fully 
functional programming language whose syntax is very similar to Ada's. 

A CallableStatement object can be created using the prepareCall (String call) 
method in the Connect! on interface. For example, the following code creates a Cal 1 abl e- 
Statement cstmt on Connection connection for procedure sampleProcedure. 
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CallableStatement CallableStatement = connect! on . prepareCall ( 
"{call sampleProcedure(?, ?, ?)}"); 

{call sampleProcedureC?, ?, . . . )} is referred to as the SQL escape syntax, which sig- 
nals the driver that the code within it should be handled differently. The driver parses the escape 
syntax and translates it into code that the database understands. For this case, sample- 
Procedure is an Oracle PL/SQL procedure. The call is translated to a string "begin sam- 
pleProcedureC?, ? , ?) ; end" and passed to an Oracle database for execution. 

You can call procedures as well as functions. The syntax to create a SQL callable statement 
for a function is: 

{? = call functionName(?, ?, ...)} 

CallableStatement inherits PreparedStatement. Additionally, the CallableStatement 

interface provides methods for registering OUT parameters and for getting values from OUT 
parameters. 

Before calling a SQL procedure, you need to use appropriate set methods to pass values to 
IN and IN OUT parameters, and use registerOutParameter to register OUT and IN OUT 
parameters. For example, before calling procedure sampl eProcedure, the following state- 
ments pass values to parameters pi (IN) and p3 (IN OUT) and register parameters p2 (OUT) 
and p3 (IN OUT): 

call abl eStatement. setString(l, "Dallas"); // Set Dallas to pi 
cal 1 abl eStatement . setLong(3 , 1); // Set 1 to p3 

// Register OUT parameters 

CallableStatement. regi ster0utParameter(2 , java.sql .Types . DOUBLE) ; 
CallableStatement. regi ster0utParameter(3 , java.sql .Types . INTEGER) ; 

You may use execute () or executeUpdateO to execute the procedure depending on the 
type of SQL statement, then use get methods to retrieve values from the OUT parameters. For 
example, the next statements retrieve the values from parameters p2 and p3. 

double d = call abl eStatement . getDoubl e(2) ; 
int i = call abl eStatement . getlnt(3) ; 

Let us define an Oracle function that returns the number of the records in the table that match 
the specified f i rstName and 1 astName in the Student table. 

create or replace function studentFound 
(first varchar2, last varchar2) 

-- Do not name fi rstName and 1 astName. 6/4/00 YDL 
return number is 

numberOf Sel ectedRows number := 0; 
begin 

select count(-) into numberOfSel ectedRows 
from Student 

where Student . fi rstName = first and 
Student . 1 astName = last; 

return numberOf Sel ectedRows ; 
end studentFound; 
/ 

Suppose the function studentFound is already created in the database. Listing 37.4 gives an 
example that tests this function using callable statements. 
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Listing 37.4 TestCal 1 abl eStatement . j ava 

1 import java.sql.*; 

2 

3 public class TestCal 1 abl eStatement { 



4 /** Creates new form TestTabl eEdi tor */ 

5 public static void main(String[] args) throws Exception { 

6 Class. forName("oracle. jdbc. driver. Oracl eDri ver") ; loaddriver 

7 Connection connection = DriverManager.getConnection( connect database 

8 "jdbc : oracle: thin: @1 iang . armstrong .edu : 1521 :orcl " , 

9 "scott", "tiger"); 
10 

11 // Create a callable statement 

12 Cal 1 abl eStatement call abl eStatement = connection . prepareCall ( create callable statement 

13 "{? = call studentFoundC?, ?)}"); 
14 

15 java.util .Scanner input = new java.util .Scanner(System.in) ; 

16 System . out . pri nt("Enter student's first name: ") ; 

17 String f i rstName = i nput . nextLi ne() ; enter firstName 

18 System . out . pri nt("Enter student's last name: ") ; 

19 String lastName = input. nextLineO ; enter lastName 
20 

21 cal 1 abl eStatement . setStri ng(2 , firstName); set IN parameter 

22 call abl eStatement . setStri ngC : : , lastName); set IN parameter 

23 cal 1 abl eStatement . regi sterOutParameter(l , Types . INTEGER) ; register OUT parameter 

24 cal 1 abl eStatement . execute () ; execute statement 
25 

26 if (call abl eStatement . getlnt(l) >= 1) get OUT parameter 

27 System. out. println(fi rstName + " " + lastName + 

28 " is in the database"); 

29 else 

30 System. out . pri ntl n(fi rstName + " " + lastName + 

31 "is not in the database"); 

32 } 



33 } 



Enter student's first name: Jacob h Enter 
Enter student's last name: Smith h Enter 
Jacob Smith is in the database 



Enter student's first name: John h Enter [ 
Enter student's last name: Smith F™5 
John Smith is not in the database 



The program loads an Oracle driver (line 6), connects to an Oracle database (lines 7-9), and 
creates a callable statement for executing the function studentFound (lines 12-13). 

The function's first parameter is the return value; its second and third parameters corre- 
spond to the first and last names. Before executing the callable statement, the program sets the 
first name and last name (lines 21-22) and registers the OUT parameter (line 23). The state- 
ment is executed in line 26). 
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The function's return value is obtained in line 26. If the value is greater or equal to 1, the 
student with the specified first and last name is found in the table. 

You can define procedures and functions in MySQL 5. The equivalent function for 
studentFound in MySQL can be defined as follows: 

MySQL function drop function if exists studentFound; 

delimiter // 

create function studentFound(f i rst varchar(20), last varchar(20)) 

returns int 
begin 

declare result int; 

select count (*) into result 
from Student 

where Student . fi rstName = first and 
Student . 1 astName = last; 

return result; 
end; 

// 

delimiter ; 

37.7 Retrieving Metadata 

database metadata JDBC provides the DatabaseMetaData interface for obtaining databasewide information 

and the Resul tSetMetaData interface for obtaining information on the specific Resul tSet, 
such as column count and column names. 

37.7.1 Database Metadata 

The Connection interface establishes a connection to a database. It is within the context of a 
connection that SQL statements are executed and results are returned. A connection also pro- 
vides access to database metadata information that describes the capabilities of the database, 
supported SQL grammar, stored procedures, and so on. To obtain an instance of Database- 
MetaData for a database, use the getMetaData method on a connection object like this: 

DatabaseMetaData dbMetaData = connect! on. getMetaData() ; 

If your program connects to a local MySQL database, Listing 37.5 displays the database 
information, as shown in Figure 37.22. 



< '■■ Command Prompt 


^irjjxj 


C:\boolojaua -cp . ; lib/aysql jdbc. jar TestDatabaseMetaData 


±\ 


□riuer Loaded 




Database connected 




database JRL : jdbc : mysql : //localhost/ jauabook 




database user-name: scot tQLccaLhost 




database product name: MySQL 




database product uereion: 5 . S . 3 7 - co mm un i. t y - n t 




JDBC driyftr name; MySQLflB JDBC Driuflr 




JDBC driver u&rsie-p : my*ql-corin»ctor- jaya-5 .C .1 ( iDatfl: 2QDG-1D-19 


17:17:16 


Q0 (Thu, 19 Oct 2006) $ h $Rftuision ; $ ) 




JDBC driuer major uersion: 5 




JDBC driuer minor uersian: 3 




Max number of connections: 




HaxTableNameLength: 61 




MaxColuransInTable: 512 




C:\book>_ 




«l 


_l *fd 



Figure 37.22 The DatabaseMetaData interface enables you to obtain database information. 
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Listing 37.5 TestDatabaseMetaData . j ava 

1 import java.sql.*; 

2 

3 public class TestDatabaseMetaData { 

4 public static void main(String[] args) 



5 throws SQLExcepti on , ClassNotFoundException { 

6 // Load the DDBC driver 

7 Class. forName("com. mysql . jdbc. Driver") ; loaddriver 

8 System. out. println("Driver loaded"); 
9 

10 // Establish a connection 

11 Connection connection = DriverManager.getConnection connect database 

12 ("jdbc: mysql ://local host/javabook" , "scott", "tiger"); 

13 System. out. println ("Database connected"); 
14 

15 DatabaseMetaData dbMetaData = connection. getMetaData() ; database metadata 

16 System, out. println ("database URL: " + dbMetaData. getURLO ) ; getmetadata 

17 System. out. println ("database username: " + 

18 dbMetaData. getUserName() ) ; 

19 System. out. println ("database product name: " + 

20 dbMetaData. getDatabaseProductNameO) ; 

21 System. out. pri ntl n("database product version: " + 

22 dbMetaData. getDatabaseProductVersionO) ; 

23 System. out. pri ntl n("JDBC driver name: " + 

24 dbMetaData. getDri verNameO) ; 

25 System. out. pri ntl n("JDBC driver version: " + 

26 dbMetaData. getDri verVersionO) ; 

27 System. out. pri ntl n("JDBC driver major version: " + 

28 dbMetaData. getDriverMajorVersionO) ; 

29 System. out. pri ntl n("JDBC driver minor version: " + 

30 dbMetaData. getDriverMinorVersionO) ; 

31 System. out. println("Max number of connections: " + 

32 dbMetaData. getMaxConnectionsO) ; 

33 System. out. pri ntl n("MaxTableNameLength: " + 

34 dbMetaData. getMaxTableNameLengthO) ; 

35 System. out. pri ntl n("MaxColumnsInTable: " + 

36 dbMetaData. getMaxCol umnsInTabl e()) ; 
37 

38 // Close the connection 

39 connection. close() ; 



40 } 

41 } 



37.7.2 Obtaining Database Tables 

You can find out the tables in the database through database metadata using the getTabl es 
method. Listing 37.6 displays all the user tables in the test database on a local MySQL. 
Figure 37.23 shows a sample output of the program. 



nJj£l 



■ Coniiibiml Prompt 



C:\book> jaua -cp lib/mysql jdbc . jar FindUserTables 
□riuer loaded 

Database connected — 1 
User tables: account address college course csci1301 csci130£ csciH990 depart men 
t enrollment faculty quiz staff student subject taughtby 
C:\book> 



Figure 37.23 You can find all the tables in the database. 



1302 Chapter 37 



Java Database Programming 



Listing 37.6 FindUserTables. java 



load driver 

connect database 

database metadata 
obtain tables 

get table names 



1 
2 
3 
4 
5 
6 
7 
8 
9 
10 
11 
12 
13 
14 
15 
16 
17 
18 
19 
20 
21 
22 
23 
24 
25 
26 



import java.sql .*; 

public class FindUserTables { 

public static void main(String[] args) 

throws SQLExcepti on , ClassNotFoundException { 
// Load the JDBC driver 
Class.forName("com.mysql . jdbc. Driver") ; 
System. out. pri ntl n("Driver loaded") ; 

// Establish a connection 

Connection connection = DriverManager.getConnection 

("jdbc:mysql : //local host/javabook", "scott", "tiger"); 
System. out. pri ntl n ("Database connected") ; 

DatabaseMetaData dbMetaData = connecti on . getMetaData() ; 

ResultSet rsTables = dbMetaData . getTabl es (nul 1 , null, null, 

new String [] {"TABLE"}); 
System . out . pri nt("User tables: ") ; 
while (rsTabl es . next()) 

System. out. print(rsTables.getString("TABLE_NAME") + " ") ; 

// Close the connection 
connection. close() ; 

} 

} 



Line 17 obtains table information in a result set using the getTabl es method. One of the 
columns in the result set is TABLE_NAME. Line 21 retrieves the table name from this result 
set column. 



37.7.3 Result Set Metadata 

The Resul tSetMetaData interface describes information pertaining to the result set. A 
Resul tSetMetaData object can be used to find the types and properties of the columns in a 
Resul tSet. To obtain an instance of Resul tSetMetaData, use the getMetaData method 
on a result set like this: 

Resul tSetMetaData rsMetaData = resul tSet . getMetaData() ; 

You can use the getCol umnCountO method to find the number of columns in the result and 
the getCol umnName(int) method to get the column names. For example, Listing 37.7 dis- 
plays all the column names and contents resulting from the SQL SELECT statement select 
- from Enrol lment. The output is shown in Figure 37.24. 



| Command Prompt 






C:\book>jaua -cp . ; lib/inysql jdb 


c.jar Test Resul tSetMetaData 




Driver loaded 






Database connected 






ssn course Id 


dateRegistered grade 




•mm lie 11111 


2007-04-13 A 




"HW1 1111S 11113 


2007-04-13 C 




141111111 11111 


2007-04-13 D 




«l 


1 





Figure 37.24 The Resul tSetMetaData interface enables you to obtain resultset information. 
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Listing 37.7 TestResul tSetMetaData. java 

1 import java.sql.*; 

2 

3 public class TestResul tSetMetaData { 

4 public static void main(String[] args) 



5 throws SQLExcepti on , ClassNotFoundException { 

6 // Load the DDBC driver 

7 Class. forName("com. mysql . jdbc. Driver") ; loaddriver 

8 System. out. println("Driver loaded"); 
9 

10 // Establish a connection 

11 Connection connection = DriverManager.getConnection connect database 

12 ("jdbc:mysql ://local host/javabook" , "scott", "tiger"); 

13 System. out. println ("Database connected"); 
14 

15 // Create a statement 

16 Statement statement = connecti on . createStatementO ; create statement 
17 

18 // Execute a statement 

19 ResultSet resultSet = statement . executeQuery create resultset 

20 ("select * from Enrollment"); 
21 

22 Resul tSetMetaData rsMetaData = resul tSet . getMetaData() ; resultset metadata 

23 for (int i = 1; i <= rsMetaData. getCol umnCount() ; i++) columncount 

24 System. out. pri ntf ("%-12s\t" , rsMetaData. getCol umnName(i ) ) ; columnname 

25 System . out . pri ntl n () ; 
26 

27 // Iterate through the result and print the student names 

28 while (resultSet. next()) { 

29 for (int i = 1; i <= rsMetaData. getCol umnCount() ; i++) 

30 System. out. printf ("%-12s\t", resultSet. getObject(i)) ; 

31 System. out. println() ; 

32 } 
33 

34 // Close the connection 

35 connection. close() ; 



36 } 

37 } 
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(SQL) 1278 


Chapter Summary 





I . This chapter introduced the concepts of database systems, relational databases, rela- 
tional data models, data integrity, and SQL. You learned how to develop database ap- 
plications using Java. 



2. The Java API for developing Java database applications is called JDBC. JDBC provides 
Java programmers with a uniform interface for accessing and manipulating a wide 
range of relational databases. 
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3. The JDBC API consists of classes and interfaces for establishing connections with 
databases, sending SQL statements to databases, processing the results of SQL state- 
ments, and obtaining database metadata. 

4. Since a JDBC driver serves as the interface to facilitate communications between 
JDBC and a proprietary database, JDBC drivers are database specific. A JDBC-ODBC 
bridge driver is included in JDK to support Java programs that access databases 
through ODBC drivers. If you use a driver other than the JDBC-ODBC bridge driver, 
make sure it is on the classpath before running the program. 

5 . Four key interfaces are needed to develop any database application using Java: Dr i ver, 
Connection, Statement, and ResultSet. These interfaces define a framework for 
generic SQL database access. The JDBC driver vendors provide implementation for 
them. 

6. A JDBC application loads an appropriate driver using the Driver interface, connects 
to the database using the Connection interface, creates and executes SQL statements 
using the Statement interface, and processes the result using the Resul tSet inter- 
face if the statements return results. 

7. The PreparedStatement interface is designed to execute dynamic SQL statements 
with parameters. These SQL statements are precompiled for efficient use when re- 
peatedly executed. 

8. Database metadata is information that describes the database itself. JDBC pro- 
vides the DatabaseMetaData interface for obtaining databasewide information 
and the Resul tSetMetaData interface for obtaining information on the specific 
ResultSet. 

Review Questions 

Section 37.2 

37. 1 What are superkeys, candidate keys, and primary keys? How do you create a table 
with a primary key? 

37.2 What is a foreign key? How do you create a table with a foreign key? 

37.3 Can a relation have more than one primary key or foreign key? 

37.4 Does a foreign key need to be a primary key in the same relation? 

37.5 Does a foreign key need to have the same name as its referenced primary key? 

37.6 Can a foreign key value be null? 

Section 37.3 

37.7 Create the tables Course, Student, and Enrollment using the create 
table statements in Section 37.3.1, "Creating and Dropping Tables." Insert 
rows into Course, Student, and Enrollment using the data in Figures 37.3, 
37.4, and 37.5. 

37.8 List all CSCI courses with at least four credit hours. 

37.9 List all students whose last names contain the letter e two times. 

37. 1 List all students whose birthdays are null. 
37. 1 I List all students who take Math courses. 
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37. 1 2 List the number of courses in each subject. 

37.1 3 Assume that each credit hour is 50 minutes of lectures. Get the total minutes for 
the courses that each student takes. 

Section 37.4 

37. 1 4 What are the advantages of developing database applications using Java? 

37.1 5 Describe the following JDBC interfaces: Driver, Connection, Statement, and 
ResultSet. 

37. 1 6 How do you load a JDBC driver? What are the driver classes for MySQL, Access, 
and Oracle? 

37.1 7 How do you create a database connection? What are the URLs for MySQL, 
Access, and Oracle? 

37. 1 8 How do you create a Statement and execute an SQL statement? 

37. 1 9 How do you retrieve values in a Resul tSet? 

37.20 Does JDBC automatically commit a transaction? How do you set autocommit to 
false? 

Section 37.5 

37.2 1 Describe prepared statements. How do you create instances of Prepared- 
Statement? How do you execute a PreparedStatement? How do you set para- 
meter values in a PreparedStatement? 

37.22 What are the benefits of using prepared statements? 
Section 37.6 

37.23 Describe callable statements. How do you create instances of Cal 1 abl eStatement? 
How do you execute a Cal 1 abl eStatement? How do you register OUT parameters 
in a Cal 1 abl eStatement? 

Section 37.7 

37.24 What is DatabaseMetaData for? Describe the methods in DatabaseMetaData. 
How do you get an instance of DatabaseMetaData? 

37.25 What is Resul tSetMetaData for? Describe the methods in Resul tSetMeta- 
Data. How do you get an instance of Resul tSetMetaData? 

37.26 How do you find the number of columns in a result set? How do you find the col- 
umn names in a result set? 

Programming Exercises 

37.1 * (Accessing and updating a Staff table) Write a Java applet that views, inserts, 
and updates staff information stored in a database, as shown in Figure 37.25(a). 
The View button displays a record with a specified ID. The Staff table is created 
as follows: 

create table Staff ( 
id char(9) not null, 
lastName varchar(15), 
f i rstName varchar(15), 
mi char(l), 
address varchar(20), 
city varchar(20) , 
state char(2) , 
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telephone char(10), 
email varchar (40) , 
primary key (id) 

); 



I Exerdse37_l 



Staff Information 



lnj_xj 



ID 12345670& 



Last Name 8rnilh 



First Name | jQtin 



Address 1 00 Main Street 



J 



City I savannah " 



State G.i 



Telephone | 9 12-3 33-5 555~ 



J 





View 1 1 Instil 1 | 


Uuilale 


Cltai 



Database uoiineilttLl 




(a) 

Figure 37.25 (a) The applet lets you view, insert, and update staff information, (b) The PieChart and BarChart com- 
ponents display the query data obtained from the data module. 



37. 2** (Displaying data) Write a program that displays the number of students in each 
department in a pie chart and a bar chart, as shown in Figure 37.25(b). The num- 
ber of students for each department can be obtained from the Student table (see 
Figure 37.4) using the following SQL statement: 

select deptld, count(*) 
from Student 

where deptld is not null 
group by deptld; 

Use the PieChart component and the BarChart component created in Exercise 
35.1 to display the data. 

37.3* (Connection dialog) Develop a JavaBeans component named DBConnectionPanel 
that enables the user to select or enter a JDBC driver and a URL and to enter a user- 
name and password, as shown in Figure 37.26. When the OK button is clicked, a 
Connection object for the database is stored in the connection property. You 
can then use the getConnectionQ method to return the connection. 



Erilur tlaldtidsti infu-r itiuMuii 


-IB 


x 


jdbc Drrver 


cotn.iTiysfllJdlJC.Orrver 


•w 




Database URL jtShc:niys{|l: localhost.javabook 


w 




User name 


scotj 




Password 






No {jomieutioii 




Comtvd lu DB 



Figure 37.26 The DBConnectionPanel component enables the 
information. 



user to enter database 
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37.4* (Finding grades) Listing 37.2, FindGrade.java, presented an applet that finds a 
student's grade for a specified course. Rewrite the program to find all the grades 
for a specified student, as shown in Figure 37.27. 



ssn | 444i 11111 ; Show Grade 



Stevenson K John's grade on course Inlroto Java I is D 
Stsvfinsnn KJnhn's grade nn cmtrsR tntrnTn.lava II isF 
itevenaon K John's grade on course Database Cisterns is A 



3 cthuises fmmil 



Mil 



ESN 1 444111110 ~ : | Shoo Ctadc | 



no courses found for tliis SSN 



Figure 37.27 The applet displays the grades for the courses for a specified student. 

37.5* (Displaying table contents) Write a program that displays the content for a given 
table. As shown in Figure 37.28(a), you enter a table and click the Show Contents 
button to display the table contents in the text area. 



B Exerase37_5 


_| D | 




Tatrie Nama |Enrellmsnl 


Shaw contents | 
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H11 11110 11111 2007-04-13 A 






nmiiirj 11113 2007-04-13 C 






mi 11 11 1 11111 ?no?-n4-i^ n 






444111111 11112 2007-04-13 F 






441111111 11113 2007-04-13 A 






444111112 11114 2D07-D4-13 S 







ssn rnwrseld dfllfiRfigistftrfid grade 



4441 11 110 
444111110 
444111111 
4441 11 11 1 
144111111 
444111112 



11113 
11111 



11113 
11114 



2007-04-13 
2007 U4 13 

?nn7-n4-in 

2007-04-13 
2007-04-13 
20C7-Q4-13 



(a) 



(b) 



Figure 37.28 (a) Enter a table name to display the table contents, (b) Select a table name 
from the combo box to display its contents. 

37.6* (Finding tables and showing their contents) Write a program that fills in table 
names in a combo box, as shown in Figure 37.28(b). You can select a table from 
the combo box to display its contents in the text area. 

37.7** (Populating database) Create a table named Quiz as follows: 

create table Quiz( 
questionld int, 
question varchar (4000) , 
choicea varchar (1000) , 
choiceb varchar (1000) , 
choicec varchar (1000) , 
choiced varchar (1000) , 
answer varchar(5)); 

The Quiz table stores multiple-choice questions. Suppose the multiple-choice 
questions are stored in a text file named Exercise37_7.txt in the following format: 



1. questionl 

a. choice a 

b. choice b 

c. choice c 

d. choice d 
Answer : cd 
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2 . 


questi on2 


a . 


choice a 


b. 


choice b 


c . 


choice c 


d. 


choice d 


Answer : a 



Write a program that reads the data from the file and stores it in the Quiz table. 
(Exercise37_7.txt is contained in c:\book). 
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Appendix 

Java Keywords 

The following fifty keywords are reserved for use by the Java language: 



abstract 


double 


int 


super 


assert 


el se 


interface 


switch 


bool ean 


enum 


long 


synchronized 


break 


extends 


native 


this 


byte 


for 


new 


throw 


case 


final 


package 


throws 


catch 


finally 


private 


transient 


char 


float 


protected 


try 


class 


goto 


publ ic 


void 


const 


if 


return 


volatile 


continue 


implements 


short 


while 


def aul t 


import 


static 




do 


instanceof 


strictfp* 





The keywords goto and const are C++ keywords reserved, but not currently used, in Java. 
This enables Java compilers to identify them and to produce better error messages if they ap- 
pear in Java programs. 

The literal values true, false, and null are not keywords, just like literal value 100. 
However, you cannot use them as identifiers, just as you cannot use 100 as an identifier, 
assert is a keyword added in JDK 1.4 and enum is a keyword added in JDK 1.5. 



*The strictfp keyword is a modifier for method or class to use strict floating-point calculations. Floating- 
point arithmetic can be executed in one of two modes: strict or nonstrict. The strict mode guarantees that the 
evaluation result is the same on all Java Virtual Machine implementations. The nonstrict mode allows inter- 
mediate results from calculations to be stored in an extended format different from the standard IEEE floating- 
point number format. The extended format is machine-dependent and enables code to be executed faster. 
However, when you execute the code using the nonstrict mode on different JVMs, you may not always get pre- 
cisely the same results. By default, the nonstrict mode is used for floating-point calculations. To use the strict 
mode in a method or a class, add the stri ctf p keyword in the method or the class declaration. Strict floating- 
point may give you slightly better precision than nonstrict floating-point, but the distinction will only affect 
some applications. Strictness is not inherited; that is, the presence of strictfp on a class or interface decla- 
ration does not cause extended classes or interfaces to be strict. 
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The ASCII Character Set 

Tables B.l and B.2 show ASCII characters and their respective decimal and hexadecimal 
codes. The decimal or hexadecimal code of a character is a combination of its row index and 
column index. For example, in Table B.l, the letter A is at row 6 and column 5, so its decimal 
equivalent is 65; in Table B.2, letter A is at row 4 and column 1, so its hexadecimal equiva- 
lent is 41. 
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TABLE B.l ASCII Character Set in the Decimal Index 








; 


2 


3 


4 


5 


6 


7 


<S' 


9 





mil 


soh 


stx 


ctx 


cot 


enq 


ack 


bcl 


bs 


lit 


1 


nl 


vt 


ff 


cl- 


so 


si 


die 


del 


dc2 


dc3 


2 


dc4 


nak 


syn 


oth 


can 


cm 


sub 


CSC 


fs 


gs 


3 


l'S 


us 


sp 


! 




# 


$ 


% 


& 


> 


4 


( 


) 


* 


+ 




- 




/ 





1 


5 


2 


3 


4 


5 


6 


7 


8 


9 




; 


6 


< 


= 


> 


? 


@ 


A 


B 


C 


D 


E 


7 


F 


G 


H 


I 


J 


K 


L 


M 


N 


O 


8 


P 


Q 


R 


S 


T 


U 


V 


W 


X 


Y 


9 


Z 


[ 


\ 


I 


A 






a 


b 


c 


10 


d 


c 


f 


g 


h 


i 


j 


k 


1 


m 


11 


n 





P 


q 


r 


s 


t 


u 


V 


w 


12 


X 


y 


z 


{ 


1 


} 




del 







TABLE B.2 ASCII Character Set in the Hexadecimal Index 








1 


2 


3 


4 


5 


6 


7 


8 


9 


A 


B 


C 


D 


E 


F 





mil 


soh 


stx 


ctx 


cot 


enq 


ack 


bcl 


bs 


ht 


nl 


vt 


ff 


cr 


so 


si 


1 


die 


del 


dc2 


dc3 


dc4 


nak 


syn 


ctb 


can 


cm 


sub 


esc 


fs 


gs 


l'S 


us 


2 


sp 


j 




# 


S 


% 


& 




( 


) 


* 


+ 








/ 


3 





1 


2 


3 


4 


5 


6 


7 


8 


9 






< 




> 


7 


4 


@ 


A 


B 


C 


D 


E 


F 


G 


H 


I 


J 


K 


L 


M 


N 


O 


5 


P 


Q 


R 


s 


T 


U 


V 


W 


X 


Y 


Z 


[ 


\ 


] 


A 




6 




a 


b 


c 


d 


c 


f 


g 


h 


i 


j 


k 


1 


m 


n 





7 


P 


q 


r 


s 


t 


u 


V 


w 


X 


y 


z 


{ 


1 


} 




del 



Appendix C 



Operator Precedence Chart 

The operators are shown in decreasing order of precedence from top to bottom. Operators in 
the same group have the same precedence, and their associativity is shown in the table. 



Operator 


Name 


Associativity 


o 


Parentheses 


Left to right 


() 


Function call 


Left to right 


n 

□ 


Array subscript 


Left to right 




Object member access 


Left to right 


_i |. 


Pnstinprpmpnt 


Ripht tn left 




Postdecrement 


Right to left 


_i |. 


Prp i n r rp m p n t 

A 1 ^ 1 1 1 1 I 1 IL 1 1 I 


Rioht to lpft 

IV t L_ 1 1 1 I V / IL^l L 




Predecrement 


Right to left 


+ 


Unary plus 


Right to left 


- 


Unary minus 


Right to left 


! 


Unary logical negation 


Right to left 


(type) 


Unary casting 


Right to left 


new 


Creating object 


Right to left 


* 


Multiplication 


Left to right 


/ 


Division 


Left to right 


% 


Remainder 


Left to right 


+ 


Addition 


Left to right 




Subtraction 


Left to right 


« 


Left shift 


Left to right 


» 


Right shift with sign extension 


Left to right 


»> 


Right shift with zero extension 


Left to right 


< 


Less than 


Left to right 


<= 


Less than or equal to 


Left to right 


> 


Greater than 


Left to right 


>= 


Greater than or equal to 


Left to right 


instanceof 


Checking object type 


Left to right 
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Operator 


Name 


Associativity 




Equal comparison 


Left to right 


! = 


Not equal 


Left to right 


& 


(Unconditional AND) 


Left to right 


A 


(Exclusive OR) 


Left to right 


| 


(Unconditional OR) 


Left to right 


&& 


Conditional AND 


Left to right 


1 1 
1 1 


Conditional OR 


T pft tn rifrht 

J V_ 1 I 1U 1 1 ^ III 


7: 


Ternary condition 


Right to left 


_ 


Assignment 


Right to left 


+= 


Addition assignment 


Right to left 


-= 


Subtraction assignment 


Right to left 




Multiplication assignment 


Right to left 


/= 


Division assignment 


Right to left 


%= 


Remainder assignment 


Right to left 
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Java Modifiers 

Modifiers are used on classes and class members (constructors, methods, data, and class-level 
blocks), but the final modifier can also be used on local variables in a method. A modifier that 
can be applied to a class is called a class modifier. A modifier that can be applied to a method 
is called a method modifier. A modifier that can be applied to a data field is called a data mod- 
ifier. A modifier that can be applied to a class-level block is called a block modifier. The fol- 
lowing table gives a summary of the Java modifiers. 



Modifier 



class constructor method data block 



Explanation 



(default)* V 



publ ic 



private 



protected 



static 



final 



abstract 



native 



A class, constructor, method, 
or data field is 
visible in this package. 

A class, constructor, method, 
or data field is 
visible to all the programs 
in any package. 

A constructor, method or data 
field is only visible in this 
class. 

A constructor, method or data 
field is visible in this package 
and in subclasses 
of this class in any package. 

Define a class method, or a 
class data field or a static 
initialization block. 

A final class cannot be 
extended. A final method can- 
not be modified in a 
subclass. A final data field 
is a constant. 

An abstract class must be 
extended. An abstract method 
must be implemented in a 
concrete subclass. 

A native method indicates 
that the method is 
implemented using a 
language other than Java. 



*Default access has no modifier associated with it. For example: cl ass Test {} 
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Modifier class constructor method data 

synchronized ^ 

strictfp V J 

transient % / 
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block Explanation 

v Only one thread at a time can 
execute this method. 

Use strict floating-point 
calculations to guarantee that 
the evaluation result is the 
same on all JVMs. 

Mark a nonserializable 
instance data field. 



Appendix E 

Special Floating-Point Values 



Dividing an integer by zero is invalid and throws ArithmeticException, but dividing a 
floating-point value by zero does not cause an exception. Floating-point arithmetic can over- 
flow to infinity if the result of the operation is too large for a doubl e or a f 1 oat, or under- 
flow to zero if the result is too small for a double or a float. Java provides the special 
floating-point values POSITIVE_INFINITY, NECATIVE_INFINITY, and NaN (Not a Num- 
ber) to denote these results. These values are defined as special constants in the Fl oat class 
and the Double class. 

If a positive floating-point number is divided by zero, the result is POSITIVE_INFINITY. 
If a negative floating-point number is divided by zero, the result is NEGATIVE_INFINITY. If 
a floating-point zero is divided by zero, the result is NaN, which means that the result is un- 
defined mathematically. The string representation of these three values are Infinity, -Infinity, 
and NaN. For example, 

System. out. print(1.0 / 0); // Print Infinity 
System. out. print(-1.0 / 0); // Print -Infinity 
System. out. print(0.0 / 0); // Print NaN 

These special values can also be used as operands in computations. For example, a number 
divided by POSITIVE_INFINITY yields a positive zero. Table E. 1 summarizes various com- 
binations of the /, *, %, +, and - operators. 



Table E.l 


Special Floating 


;-Point Values 












X 


V 


x/y 


x*y 




x%y 


x + y 


x — y 


Finite 


± 0.0 


± oo 


± 0. 





NaN 


Finite 


Finite 


Finite 


± oo 


± 0.0 


± 0. 





X 


± oo 


oo 


± 0.0 


± 0.0 


NaN 


± 0. 





NaN 


± 0.0 


± 0.0 


± oo 


Finite 


± oo 


± 0. 





NaN 


± oo 


± oo 


± oo 


± oo 


NaN 


± 0. 





NaN 


± oo 


oo 


± 0.0 


± oo 


± 0.0 


NaN 




± 0.0 


± oo 


± 0.0 


NaN 


Any 


NaN 


NaN 




NaN 


NaN 


NaN 


Any 


NaN 


NaN 


NaN 




NaN 


NaN 


NaN 



# Note 

[f one of the operands is NaN, the result is NaN. 
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Number Systems 

1 Introduction 



Computers use binary numbers internally, because computers are made naturally to store and 
process Os and Is. The binary number system has two digits, and 1. A number or character 
is stored as a sequence of Os and Is. Each or 1 is called a bit (binary digit). 

In our daily life we use decimal numbers. When we write a number such as 20 in a pro- 
gram, it is assumed to be a decimal number. Internally, computer software is used to convert 
decimal numbers into binary numbers, and vice versa. 

We write computer programs using decimal numbers. However, to deal with an operating 
system, we need to reach down to the "machine level" by using binary numbers. Binary num- 
bers tend to be very long and cumbersome. Often hexadecimal numbers are used to abbrevi- 
ate them, with each hexadecimal digit representing four binary digits. The hexadecimal 
number system has 16 digits: 0-9, A-F. The letters A, B, C, D, E, and F correspond to the dec- 
imal numbers 10, 11, 12, 13, 14, and 15. 

The digits in the decimal number system are 0, 1,2, 3, 4, 5, 6, 7, 8, and 9. A decimal num- 
ber is represented by a sequence of one or more of these digits. The value that each digit rep- 
resents depends on its position, which denotes an integral power of 10. For example, the digits 
7, 4, 2, and 3 in decimal number 7423 represent 7000, 400, 20, and 3, respectively, as shown 
below: 



10 3 10 2 



10 1 10 



7 X 10 3 + 4 X 10 2 + 2 X 10 1 + 3 X 10° 



7000 + 400 + 20 + 3 = 7423 



binary numbers 



decimal numbers 



hexadecimal number 



The decimal number system has ten digits, and the position values are integral powers of 10. 
We say that 10 is the base or radix of the decimal number system. Similarly, since the binary base 
number system has two digits, its base is 2, and since the hex number system has 16 digits, its radix 
base is 16. 

If 1101 is a binary number, the digits 1, 1, 0, and 1 represent 1 X 2 3 , 1 X 2 2 , X 2 1 , and 
1 X 2°, respectively: 



1 


1 





1 


2 3 


2 2 


2 1 


2° 



1 X 2 3 + 1 X 2 2 + X 2 1 + 1 X 2° 



+ 4 + + 1 = 13 



If 7423 is a hex number, the digits 7, 4, 2, and 3 represent 7 X 16 3 , 4 X 16, 2 X 16 1 , and 
3 X 16°, respectively: 

= 7 X 16 3 + 4 X 16 2 + 2 X 16 1 + 3 X 16° 
16 3 16 2 16 1 16° = 28672 + 1024 + 32 + 3 = 29731 
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2 Conversions Between Binary and Decimal Numbers 

Given a binary number b n b n -\b n -2 ■ ■ ■ bjb\b§, the equivalent decimal value is 



b n X 2" + b„-i X 2"" 1 + b n - 2 X 2"~ 2 + 



+ b 2 X 2 2 + b\ X 2 1 + Z? X 2° 
Here are some examples of converting binary numbers to decimals: 



Binary 


Conversion Formula 




Decimal 


10 


1 X 2 1 + X 2° 




2 


1000 


1 X 2 3 + X 2 2 + X 2 1 


+ 0X2° 


8 


10101011 


1 X 2 7 + X 2 6 + 1 X 2 5 
1 X 2 1 + 1 X 2° 


+ X 2 4 +1X 2 3 + X 2 2 + 


171 



To convert a decimal number d to a binary number is to find the bits b n , b n -\ , b„-2, ■ ■ ■ , &2> b\ , 
and b such that 



b„ X 2" + b„ 



X 2 



n-l 



+ b n - 2 X 2"" 2 + ... + b 2 X 2 2 + bi X 2 1 + b X 2° 



These bits can be found by successively dividing d by 2 until the quotient is 0. The remainders 
are bo, b\, b2, . ■ ■ , b n -%, b n -\, and b n . 

For example, the decimal number 123 is 111 101 1 in binary. The conversion is done as follows: 




Quotient 



Remainder 



Tip 

The Windows Calculator, as shown in Figure F.l , is a useful tool for performing number conver- 
sions. To run it, choose Programs, Accessories, and Calculator from the Start button, then under 
View select Scientific. 



Hex 



Decimal 



Edit View Help 



Binary 



□Jxl 



1111011 



«-T Hen 


C Dec C Oct P 


Bin 


(I 


Qword C Dword C Word P Byte 


r Inv 


r H VP 


r 


r 






backspace 


CE 


C 
















Sta 




«l 


• I 


■ 




MC 




7 


8 


9 


/ 


Mod 


And 


Ave 




dms 


Exp 


h 




MR 




4 


5 


G 




□ r 


Xor 


Sum 




sin 


x"v 


log 


MS | 


1 


2 


3 




Lsh 


Not 






cos 


x"'J 


- 




M+ 







+1- 








Int 


Dat 




tan 


k"2 






z 




A 


B 


C 


D 


E 


F 



Figure F.I You can perform number conversions using the Windows Calculator. 
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3 Conversions Between Hexadecimal and Decimal 
Numbers 

Given a hexadecimal number h n h n -]h n -2 ... hjh\hQ, the equivalent decimal value is hex to decimal 

h„ x 16" + h n - x x 16"" 1 + h n - 2 x 16"" 2 + ... + h 2 x 16 2 + ft t x 16 1 + h x 16° 
Here are some examples of converting hexadecimal numbers to decimals: 



Hexadecimal Conversion Formula Decimal 

7F 7 x 16 1 + 15 X 16° 127 

FFFF 15 X 16 3 + 15 X 16 2 + 15 X 16 1 + 15 X 16° 65535 

43 1 4 X 16 2 + 3 X 16 1 + 1 X 16° 1073 



To convert a decimal number d to a hexadecimal number is to find the hexadecimal digits decimal to hex 
h n , h n -\, h n -2, . • . , hi, hi, and ho such that 

d = h„x 16" + h n - x X 16"" 1 + h a - 2 X 16"~ 2 + ... + h 2 X 16 2 
+ h x X 16 1 + h X 16° 

These numbers can be found by successively dividing d by 16 until the quotient is 0. The re- 
mainders are h$, h\, h 2 , . ■ ■ , h n _ 2 > » an d h n . 

For example, the decimal number 123 is 7B in hexadecimal. The conversion is done as 
follows: 




4 Conversions Between Binary and Hexadecimal Numbers 

To convert a hexadecimal to a binary number, simply convert each digit in the hexadecimal hex to binary 
number into a four-digit binary number, using Table F. 1 . 

For example, the hexadecimal number 7B is 1111011, where 7 is 111 in binary, and B is 
1011 in binary. 

To convert a binary number to a hexadecimal, convert every four binary digits from right to 
left in the binary number into a hexadecimal number. binary to hex 

For example, the binary number 1110001101 is 38D, since 1101 is D, 1000 is 8, and 11 is 
3, as shown below. 



1110 110 1 



T I T 

3 8 D 
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Table F.I Converting Hexadecimal to Binary 



Hexadecimal Binary Decimal 

0000 

1 0001 1 

2 0010 2 

3 0011 3 

4 0100 4 

5 0101 5 

6 0110 6 

7 0111 7 

8 1000 8 

9 1001 9 
A 1010 10 
B 1011 11 
C 1100 12 
D 1101 13 
E 1110 14 
F 1111 15 



{Note: Octal numbers are also useful. The octal number system has eight digits, to 7. A 
decimal number 8 is represented in the octal system as 10.) 

Review Questions 



1 . Convert the following decimal numbers into hexadecimal and binary numbers. 

100; 4340; 2000 

2. Convert the following binary numbers into hexadecimal and decimal numbers. 

1000011001; 100000000; 100111 

3. Convert the following hexadecimal numbers into binary and decimal numbers. 

FEFA9; 93; 2000 



INDEX 



Symbols 

- (subtraction), 33 

-= (subtraction assignment operator), 39 

--var (predecrement), 40 

! = (not equal to), 72, 1283 

! operator, truth table for, 88 

&& operator, truth table for, 88 

$ character, 29 

% (remainder), 33 

%= (remainder assignment operator), 37 

* character (all), 322 

* (multiplication), 33 

*= (multiplication assignment operator), 37 
/ (division), 33 

/= (division assignment operator), 37 

\ (backslash), 46, 323 

a operator, truth table for, 88 

| | operator, truth table for, 88 

+ (addition), 33 

+= (addition assignment operator), 39 

++var (preincrement), 40 

var++ (postincrement), 40 

< (less than), 72, 1283 

<= (less than or equal to), 72, 1283 

<> (not equal to) comparison operator, 1283 

<applet> tag, syntax of, 615-617 

<param> tag, 5616 

= = (equal to), 72 

= (equal to) comparison operator, 1283 
> (greater than), 72, 1283 
>= (greater than or equal to), 72, 1283 
var-- (postdecrement), 40 

A 

abs method, Math class, 174 
Absolute file name, 323-324 
Abstract classes, 458^162, 898 
Cal endar class, 462^165 
field constants in, 463 
TestCalendar.java, 463—465 
Circle.java, 460 
defined, 458 

GeometricObject.java, 458—460 

CregorianCal endar class, 462-463 

interesting points on, 462 

for interfaces, 822 

interfaces vs., 465467 

Rectangle.java, 460 
Abstract methods, 458-459, 460, 471, 474, 

478, 486 
abstract modifier, 458, 1316 
Abstract Windows Toolkit (AWT), Swing vs., 406 
AbstractAction class, 1161, 1164 
AbstractBorder class, 1136 

Bevel Border class, 1136-1137 

CompoundBorder class, 1136, 1138 

EmptyBorder class, 1136-1137 

EtchedBorder class, 1136-1137 

LineBorder class, 1136, 1138 

MatteBorder class, 1136, 1138 

SoftBevel Border class, 1136-1137 

TitledBorder class, 1136, 1138 



AbstractButton class, 572-573, 575, 578, 
581,664 

Abstractor 1 ection interface, 729-730 
AbstractCraph class, 898-900 
AbstractGraph.java, 903-908 
createAdjacencyList methods, 908 
getAdjacencyMatrixO method, 909 
printAdjacencyMatrixO method, 909 
print Edges () method, 909 
vertices data field, 908 
AbstractGraph.java, 903-908 
Abstraction: 
class, 347 
AbstractList class, 740-742 
AbstractListModel class, 1209, 1216 
Abst ractMap class, 752 
AbstractSet class, 730, 898 
AbstractSpinnerModel class, 1198 
AbstractTableModel class, 1231, 1243 
AbstractTree class, 862-863 

AbstractTree.java, 864 
Accessibility modifiers, 395 
Accessible method, overriding, 383-384 
AccountWithSyncUsingLock.java, 990-99 1 
acquireO method, Semaphore class, 1000 
action-after-each-iteration, 126-128, 136 
Action interface, 1 160-1 164 
ActionlnterfaceDemo.java, 1 162-1 164 
ActionEvent, 470-471, 534-538, 557-560, 

575-586, 590, 592, 626, 979, 982, 1217 
ActionListener interface, 469471, 534, 536, 
1094, 1102, 1104-1105, 1151, 
1160-1161 
actionListenerList, 1099 
actionPerformed method, 1095, 1098, 1100, 

1161, 1164, 1194 
Actual parameter, 157, 320 
AdapterDemo.java, 551-552 
add method, 829, 1003, 1118, 1123, 1209 
addActionListener method, 536, 1092, 

1099, 1194 
addCol unin method, 1235, 1242 
addElement method, 747, 1211 
addFirst(e) method, MyLinkedList class, 834 
add(index, e) method, MyLinkedList class, 

835-836 
Addition (+), 33 

Addition assignment operator (+= ), 39 

AdditionQuiz.java, 73 

addLast(e) method, MyLinkedList class, 

834-835 
addMatrix method, 719-722 
addRow method, 1242 
addSeparatorO method, 1151 
addStudent method, 1099-1100, 1104 
Adjacent edges, 941, 943, 949 
Adjacent vertices, 898, 916, 951 
AdjustmentEvent, 596 
Adjustment Listener interface, 596 
Aggregated class, 354 
Aggregated objects (subject object), 354 
Aggregating class, 354 
Aggregating object (owner object), 354 



Aggregation, 353-355 

Aggregation relationship, representation of, 

353-354 
Algorithm efficiency, 741-766 

algorithm for finding a closest pair in step 3 

(listing), 784-785 
algorithm for finding a closest pair (listing), 

783-784 
big O notation, 766-767 
examples of determining, 767-769 
binary search algorithm, 769-770 
closest pair of points (case studies), 783-785 
common growth functions, comparing, 771 
exponential algorithm, 771 
Fibonacci numbers, finding (case studies), 
771-773 

greatest common divisors, finding (case 

studies), 774-777 
insertion sort algorithm, 770 
prime numbers, finding (case studies), 

778-783 
quadratic algorithms, 768 
recurrence functions, 785 
selection sort algorithm, 770 
Towers of Hanoi problem, analyzing, 771 
Algorithms, 24, 216, 219, 242 

graphs, 893, 923 
alignment property, FlowLayout manager, 41 1, 

417, 505 
Alignments, 574 

anchorSelectionlndex method, 1207 
Animal class, 465, 475 
AnimationDemo.java, 558-559 
Anonymous arrays, 209 
Anonymous class listeners, 542-544 
AnonymousListenerDemo.java, 543-544 
Applet class, 618-620, 1112, 1114 

destroy method, 620 

getParameter method, 622 

i nit method, 620 

start method, 620 

stop method, 620 

subclasses of, 620 
Applet clients, 1029-1031 

AppletClient.java, 1030-1031 

CountServer.java, 1029-1030 
Applets, 12-13, 15 

audio, playing in Java programs, 633-634 

bouncing ball (case study), 644 

demos, 615 

enabling to run as applications, 618-619 
HTML file and the <applet> tag, 615-618 
JApplet class, 618, 1114 
and multimedia, 613-637 
multimedia animations, 634-637 
passing strings to, 620-624 
TicTacToe game (case study), 628-632 
viewing from a Web browser, 617 
viewing using the applet, 617-618 
viewer utility, 617-618 
appletviewer command, 617-618 
Application program interface (API), 10 
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app1yPattern(String pattern) method, 

Decimal Format class, 1074 
arcAngle, 499, 506 
archive attribute, 616 
Arcs, drawing, 506-507 

DrawArcs.java, 506-507 
Arguments, 157 

Arithmetic/logic unit (ALU), 2-3 
Arithmetic operators, in SQL, 1284-1285 
ArithmeticException, 432^135, 437-438, 

482,716 
Array initializers, 201 
Array length, 200 
Array lists, 825-830, 898 
Array objects, 27 1 
Array variables: 

arrays vs., 200 

declaring, 199 
ArrayBI ockingQueue, 998-999 
arraycopy method, 208-209, 

ArraylndexOutOf BoundsException, 
203, 432, 443 
ArrayList class, 345-349, 709, 717, 740-742, 
747, 807, 843, 898 

add(Object) method, 391 

class diagram, 709 

defined, 740 

differences and similarities between 
arrays and, 392 
remove (index) method, 391 
remove (Object) method, 391 
size() method, 391 
Test Array AndLinkedList.j ava, 74 1 -742 
TestArrayList.java, 392 
toStringO method, 392 
trimToSizeO method, 740, 829 
Arrays, 197-223, 822 
anonymous, 209 
Arrays class, 223 
basics of, 198-199 
binary search approach, 217-219 
conversion between strings and, 309 
copying, 208-209 
creating, 199-200 
defined, 198 
initializers, 201 
insertion sort, 220-222 
length, 200 

linear search approach, 216-217 

multidimensional, 248-25 1 

of objects, 232 

passing to methods, 209-212 

printing, 239 

processing, 201-203 

returning from a method, 212-215 

searching, 216-219 

selection sort, 219-220 

serializing, 665-666 

sorting, 219-222 

GenericSort.java, 479^-81 

two-dimensional, 236-248 

variable-length argument lists, 215-216 

variables, declaring, 199 
Arrays class, 223 

binarySearch method, 219 

sort method, 223 
Arrow keys, 5 
Ascent, 510 

ASCII (American Standard Code for Information 
Interchange), 45 



character set, 1312-1313 
Assembler, 6 
Assembly language, 5-6 
assert keyword, 1311 
Assignment expression, 30-3 1 
Assignment operator, 30-3 1 
Assignment statement, 3 1 
Association, 162 
Associativity, 97-98 
Attributes, 1275 
Audio: 

Image AudioAnimation Java, 635-637 

playing in lava programs, 634 
Autoboxing, 481, 709, 1228 
Autocommit mode, 1292 
Automatic driver discovery, 1289 
autoResizeMode property, 1228, 1231 
Autounboxing, 710 
Average-case analysis, 766 
await () method, 991, 995 

15 

Backslash (\), 46, 323-324 
Backward compatibility, 713 
Backward pointer, 842-843 
BallControl Java, 626-627 
Balljava, 625-626 

Base case, 678-679, 681-686, 689, 691-692 

testing, 688 
Base, decimal number system, 1319 
BASIC, 6 

Beans, See JavaBeans 
Behavior, of objects, 264 
Best-case input, 766 
between-and operator, 1283-1284 
Bevel Border class, 1136-1137 
Big O notation, 766-769 

examples of determining, 767-769 
BigDecimal class, 488 
Biglnteger class, 488 
Binary files, 650, 652 
Binary I/O, 649-668 

characters/strings in, 656-657 

copying files (problem), 660-662 

DatalnputStream class, 655-657 

DataOutputStream class, 655-657 

efficiency of, 652 

object I/O, 662-666 

random access files, 666-668 

Serial izable interface, 664-665 

TestFileStream.java, 654—655 

text I/O vs., 650-652 
Binary numbers, 3, 9 
Binary operator, 35, 97 
Binary search, 216-218, 686-687 

benefits of, 217 

binarySearch method, 687 

BinarySearch.java, 218-219 

recursive binary search method, 686-687 
Binary search algorithm, 769-770 
Binary search trees (BST), 858-886 

deleting elements in, 870-876 

depth of a node, 858 

element: 

inserting, 860-861 
searching for, 860 

height of, 858 

leaf, 858 

left subtree, 858 



length of a path, 858 
level of, 858 
representing, 858-859 
right subtree, 858 
root, 858 
siblings, 858 
tree traversal, 861-863 
Binary tree: 

animation, 801, 858 
complete, 801 

deleting an element from (listing), 870-876 
binarySearch method, Collections 

class, 743 
BinaryTree class, 863-870 

Binary Tree.java, 864-869 

class diagram, 863 

TestBinary Tree.java, 869-870 

Tree.java, 863-864 
Birth dates, guessing (problem), 250-251 

GuessBirthDateUsingArray.java, 250-25 1 
Bits, 3, 9 
Block, 16 

Block comment, 16-17 
Block styles, 52-53 
Blocking queues, 998-999 

ArrayBI ockingQueue, 998-999 

concrete, 998 

ConsumerProducerUsingBlockingQueue.java, 
999 

defined, 998 

LinkedBlockingQueue, 998 

PriorityBlockingQueue, 998 
B1 ockingQueue interface, 998 
BMI class, 351-353 

BMI.java, 352-353 

getBMIO instance method, 353 

getStatusO instance method, 353 

UseBMIClass.java, 352-353 
Body Mass Index (BMI), computing (problem), 

84-85 
Body, method, 157 
Boolean literal, 73, 272 
Boolean operators, 88 
boolean value: 

casting, 90 

testing, 81-82 
Boolean variables, 72 
BorderDemo.java, 1140-1144 
BorderLayout manager, 415-417, 
1114-1115, 

hgap property, 417, 1114 

setHgap method, 417 

ShowBorderLayout.java, 416^117 

vgap property, 417, 11 14 
Borders: 

sharing, 424 

Swing, 1136-1144 
Bottom-up design, 179 
BounceBallApp.java, 627 
Bouncing ball (case study), 624-627 

BallControl.java, 626-627 

Balljava, 625-626 
BounceBallApp.java, 627 
Bounded wildcard, 715 
Box class: 

createHorizontal Box() method, 1121 
create! Horizontal Strut(int) method, 
1119 

createVerticalBoxO method, 1121 
Boxing, 481 
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BoxLayout manager, 1118-1121 

and component's al ignmentX or al ignmentY 

property, 1119 
glue, 1119 
rigid area, 1119 

ShowBoxLayout.java, 1119-1121 
strut, 1119 

unique features of, 1118-1119 
Braces, 16 

Breadth-first search, 916-882 
algorithm (listing), 916 
applications of, 918-919 
defined, 916 

implementation of, 916-917 

nine tail problem, 962-965 
NineTail Model class, 921 

TestBFS.java, 917-918 
Breadth-first traversal: 

graphs, 911,916 

trees, 861-863 
break keyword, 135-139 

GuessNumberUsingBreak.java, 137 

TestBreak.java, 135-136 
break statement, 94 
Bubble sort, 792-794 

algorithm (listing), 793 

bubble sort time, 794 

BubbleSort.java, 793-794 

defined, 792 

improved algortithm (listing), 793 
Bucket sort, 807-809 

algorithm (listing), 807-808 

stability of, 808 
BufferedlnputStream, 659-660 
Buf feredOutputStream, 659-660 
Bugs, 55 
Bus, 2 

ButtonModel , 1195-1196 
Buttons, 572-578 

AbstractButton class, 572-573 

alignments, 574 

defined, 572 

icons, 572-573 

pressed icons, 572-573 

rollover icons, 572-573 

TestButtonlcons.java, 573-574 

text positions, 575 

using, 575-578 
byte type, 32-33 
Bytecode, 7 
Bytecode verifier, 15 
Bytes, 3 

C 

C, 6 
C#, 6 

Cable modem, 5, 976 

cal cul ate method, 1114 

Calculator (problem), 321-322 

Calculator.java, 321-322 

Cal endar class, 462^163, 465, 1060 

field constants in, 463 

get(int field) method, 462 

get Actual Maxi mum (Cal endar . DAY_0F_ 
MONTH) method, 465 

TestCalendar.java, 463-465 
Calendar, displaying, 1024-1029 

CalendarApp class, 1067 

CalendarApp.java, 1070-1071 



CalendarPanel class, 1066-1067 
CalendarPanel.java, 1067-1070 
Call stacks, 160 

Cal 1 abl eStatement interface, 1297-1300 

TestCallableStatement.java, 1299-1300 
Calling methods, 158-160 
Calling object, 387-389 
Candidate key, 1277 

capacityC) method, StringBuilder, 318 
CardLayout manager, 1115-1118 

add method, 11 16 

methods, 1116 

ShowCardLayout.java, 1116-1118 
Case sensitivity: 

of Java source programs, 14 

of name identifiers, 29 
case statement, 94 
Casting, 687, See Type casting 
Casting objects, 387-389 
catch block, 654 
CD-R/CD-RW, 4 
CDs/DVDs, 4 
Cell class, 628-629 
centerAction, MyAction class, 1164 
Central processing unit (CPU), 2-3 

sharing, 8 

speed, 3 
Chained exceptions, 447-448 
ChangeEvent, 1202 
char (data type), 44-47 

casting between numeric types and, 46^17 

increment/decrement, 45 
Character class, 313-315 
charValueO method, 313 
CountEachLetter.java, 314-315 

counting each letter in a string (problem), 
314-315 

methods for manipulating a character, 314 

static methods, 314 
Character encoding, 45 
Character literal, 45 
Character wrapper class, 313-315 
Characters: 

converting to strings, 309-310 

finding in strings, 308-309 
charAt (index) method, String class, 305 
charAt (index) method, 
Check-box menu items, 1151 
Checkboxes, 578-581 

CheckBoxDemo.java, 579-581 

toggle button, 578 
Checked exceptions, 439, 442 
CheckPalindrome.java, 310-311 
Child classes, See Subclasses 
Choice lists, See Combo boxes 
Circleclass, 265-266, 270, 278-279, 281, 
284-285, 289, 291 

Circlel.java, 267-268 

Circle2.java, 279 

Circle3.java, 284-285 

Circle4.java, 376-378 

Circle.java, 460 
CircleControl class, 1188-1189 
CircleController.java, 1192-1193 
CircleModel class, 1188-1189 
CircleModel.java, 1189-1191 
CircleView class, 1188-1191 
Circle View.java, 1191-1192 
Circular doubly lists, 842-843 
Circular singly linked lists, 842 



Clarity, 

in class design, 363 
Class abstraction, 347 
Class block, 12 

Class design guidelines, 362-364 

clarity, 363 

cohesion, 362 

completeness, 363 

consistency, 362 

encapsulation, 363 

instance vs. static, 281, 363-364 
Class diagrams, 615 
Class encapsulation, 347-351 
class keyword, 19 
Class loaders, 15 

Class variables, See Static variables 
ClassCastException, 387, 468 
.class file, 15 
Classes, 263-289 

Date class, 274-275 

Java, 265, 272, 276 

from Java library, 274-278 

naming, 52 

naming convention, 477 

Random class, 275 

reusing, 379 
CI assNotFoundExcepti on, 437^138 
Class's contract, 347 
clear method, Map interface, 730, 752, 

729, 1209 
Client class, 1024, 1042 
Client.java, 1022-1025 
Clock with audio (case study), 980-983 
ClockWithAudio.java, 980-982 

announceTime method, 981-982 

hourAudio array, 982 

start () method, 982 

stop() method, 982 
ClockWithAudioOnSeparateThread.java, 982-983 

announceTime method, 983 

run method, 983 
ClockAnimation.java, 559-560 
clone method, Object class, 471^173 
Cloneabl e interface, 471-473 

House.java, 472-473 
cloneCal endar method, 1070 
CloneNotSupportedException, 472—473 
close () method, 326, 655 
Close stream, 655, 657-658, 661 
closedlcon property, 1266 
Closest pair, finding (problem), 242-244 

FindNearestPoints.java, 243-244 
Closest pair of points (case studies), 783-785 
COBOL, 6 

Code, modularizing, 165-167 
Code incrementally, use of term, 118 
Code sharing, and methods, 160 
codebase attribute, 616 

in class design, 362 
Collection interface, 729-730, 732, 748-749 

add method, 729 

basic operations for adding/removing elements 

in a collection, 729 
class diagram, 729 
c1ear() method, 730 
iterator method, 730 
query methods, 730 
removeAl 1 method, 729-730 
retainAII method, 730 
toArrayO method, 730 
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Collection objects, 1003 
Collections: 
defined, 728 

static methods for, 742-745 

types of, 728 
Col 1 ections class, 742-743 

binarySearch method, 743 

copy method, 742, 744 

disjoint method, 742, 745 

fill method, 742, 744 

frequency method, 742, 745 

max and mi n methods, 742, 744 

methods, 742, 756 

nCopies method, 742, 744 

reverse method, 742 

shuffle method, 742 

singl eton method, 756 

si ngl etonLi st method, 756 

singl etonMap method, 756 

unmodifiableCollection class, 757 

unmodifiableList class, 757 

unmodi f iabl eMap class, 757 

unmodifiableSet class, 757 

unmodi f iabl eSortedMap class, 757 

unmodi f iabl eSortedSet class, 757 
Color class, 419 
color property, 1189, 1192 
ColorDialog.java, 1172-1174 
Column alias, 1284 
col umn Removed method, 

Tabl eCol umnModel Listener, 1250 
columns property, GridLayout manager, 413-415 
columns-to-be-sorted, 1285 
Combining strings, 305-306 
Combo boxes, 590-593 

ComboBoxDemo.java, 591-593 

defined, 590, 1216 

JComboBox class, 590 
ComboBoxCellRendererDemo.java, 1217-1219 
ComboBoxModel interface, 1216 
Command-line arguments, 320-322 
Comment styles, 5 1 
Comments, 11,5 1—52 
commit O method, 1292 
commitEditO method, 1202 
Common design error, 281, 364 
Communication devices, 2, 5 
com.mysql .jdbc .Driver class, 1288 
Comparable interface, , 467^168, 712-713, 735, 
738, 742, 745, 752, 941 

ComparableRectangle.java, 468-469 

compareTo method, 735-736 

reverseOrderO method, 742 
Comparator interface, 737-738 

Comparable interface vs., 738 

GeometricObjectComparator.java, 737-738 

TestTreeSetWithComparator.java, 738 
Comparator, order by, 735 
compareTo method, 304, 313, 735 

String class, 302-313 
compareToIgnoreCase method 

String class, 303-304 
Comparing characters, 72 
Comparison operators, 72 
Compile warning, unavoidable, 7 1 8 
Compiler, 7, 11-12, 14-17 
Compiling vs. interpreting, 15 
Complete binary tree, 801 
Complete graphs, 893-894 

in class design, 363 



Component class, 406^107, 409, 419, 421, 
505,512,516, 521,580,586, 
1058, 1126 

setFont method, 419, 422 
ComponentAdapter class, 551 
ComponentEvent, 535, 1247 
ComponentListener interface, 537, 551 
Components: 

JavaBeans, 1092 

naming convention for, 572 
Composition, 353-355, 394, 423, 843-844 
Compound expression, 847 
CompoundBorder class, 1136, 1138 
ComputeArea.java, 25-26 
ComputeBMI.java. 84-85, 351 
ComputeChange.java, 48-50 
ComputeFactorial.java, 679-681 
ComputeFibonacci.java, 681-683 
ComputeLoan.java, 38-39, 150, 172, 347 
ComputeLoanUsinglnputDialog.java, 56-57 
ComputePrime.java, 1010 

as SwingWorker, 1007 
Computer programming, defined, 2 
Computers: 

central processing unit (CPU), 2-3 

communication devices, 2, 5 

defined, 2 

input7output devices, 2, 4-5 

memory (main memory), 2, 3 

storage devices, 2, 4 
ComputeTax.java, 86-88 
Concatenating strings, 26, 50 
Concrete blocking queues, 998 
Concrete classes, 898-899 

in the Java Collections Framework, 728 
ConcurrentModificationException, 1003 
Condition interface, 991 
Conditional expressions, 95 
Conditional operator, 90, 95 
Conditions, 991 

and Java's built-in monitor, 994 
Confirmation dialogs, 98-100, 1166-1167 

controlling a loop with, 139-140 

defined, 1164, 1166 

showConfirmDialog method, 1167 
Connected and undirected graph, 951 
Connection interface, 1288, 1292, 1295, 

1297, 1300 
connectLeftChild, 879 
connectRightChild, 879 
Consistency, in class design, 362 
Console input, using Scanner class, 26-27 
Console output, formatting, 95-97 
const keyword, 1311 
Constant base, omission of, 769 
Constant time, 767-768, 771-772, 898 
Constants, 31-32, 172, 176, 279 

benefits of, 32 

naming, 31-32, 52 
Constructor chaining, 380-382 
Constructors, 231 

compared to methods, 270 

constructing objects using, 270 

default, 270 

no-arg, 270 

overloaded, 270 
ConsumerProducer.java, 996-997 
ConsumerProducerUsingBlockingQueue.java, 999 
Container class, 406^107, 410, 419, 618, 
1112, 1123 



Container class: 

add methods, 1123-1124 

remove method, 1123-1124 

validate method, 1123-1124 
Container classes, 407, 410, 419 
Container objects, 728 
ContainerAdapter class, 551 
ContainerEvent, 534-535, 537 
ContainerListener interface, 537, 551 
contai nsKey method, Map interface, 752 
contai nsVal ue method, Map interface, 752 
Content pane delegation, 410 
Contention, 978 

Context menus, See Popup menus 
Contiguous selection mode, 1260 
continue keyword, 135-137 
TestContinue.java, 136-137 
Contract, class, 347 
Control unit, 2-3 

Control variable, 117, 122, 126-128, 130, 220, 222 

ControlBall.java, 626-627 

Controller, 1188 

Convenience adapters, 551 

Convenience classes, 729-730, 752, 823 

Convenience listener adapter, 55 1 

Converting strings, 56 

copy method, Col 1 ections class, 742, 744 

Copy reference, 208 

Copying files (problem), 660 

Copy.java, 661-662 
CornerPanel class, 1131 
CountLettersInArray.j ava, 2 1 3-2 1 5 
CountOccurrenceOfWords.java, 755-756 
Country codes, 1058-1059 
Course class, 355-357, 1097 

Course.java, 356-357 

modeling the courses, 355 

TestCourse.java, 356 
Course table, 1275-1278, 1280-1281 
CourseWithActionEvent class, 1097 
Course WithActionEvent.j ava, 1098-1 100 

addActionListener method, 1099 
CourseWithEnrollmentEvent.java, 1 103-1 104 
CPU, See Central processing unit (CPU) 
createAd j acencyLi st methods, 

AbstractCraph class, 900, 902, 
908-909, 911,916, 927, 940-942, 952 
created ue() method, 1119 
createHorizontal Box() method, 1121 

Box class, 1121 
CreateLargeFile.java, 809-810, 815 
createVertical BoxO method, Box 

class, 1121 
Critical region, 987 
Cubic time, 771 
Currency format, 1073 
Current time, displaying (case study), 43^14 
cur rentDi rectory property, JFileChooser 

class, 1177 
currentTimeMill is method, 50 
Custom dialogs, creating, 1171-1174 

ColorDialog.java, 1172-1174 

TestColorDialog.java, 1 174 
Custom event sets, creating, 1101-1106 

CourseWithEnrollmentEvent.java, 1 103-1 104 

Enroll mentEvent class, 1101-1102, 1104, 1106 

EnrollmentEvent.java, 1101-1102 

enroll mentExceeded method, 1102 

Enroll men t Listener class, 1102 

EnrollmentListener.java, 1 102-1 103 
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TestCourseWithEnrollmentEvent.java, 
1104-1106 
Custom exception classes, 448^150 
Custom layout managers, creating, 1 123-1 128 
Custom source components, creating, 1097-1101 

CourseWithActionEvent class, 1097 

CourseWithActionEvent.java, 1098-1 100 

deregistration method, 1097 

multicast listener, 1097 

registration method, 1097 

TestCourseWithActionEvent.java, 1 100-1 101 
Custom stack class, 393-394 
Custom table Tenderers and editors, 1245-1247 

CustomTableCellRendererEditorDemo.java, 
1246-1247 

MylmageCellRenderer.java, 1245 

D 

Data encapsulation, benefit of, 362 
Data field encapsulation, 283-286 

Circle3.java, 284-285 

TestCircle3.java, 285-286 
Data fields, 265, 396, 466 

hidden, 346 
Data structures, , 728, 898 
Data types, 25 
Database, defined, 1274 
Database management system (DBMS), 1274 
Database systems, See also Java database 
programming 

connecting to, 1289 

database language, 1278 
DatabaseMetaData interface, 1300 
databaseURL: 

for a MySQL database, 1289 

for an ODBC data source, 1289 

for an Oracle database, 1289-1290 
Datagram sockets, 1018 
Datalnput interface, 655, 666 
DatalnputStream class, 655-657 

TestDataStream.java, 657-658 

using, 657 
DataOutput interface, 655, 666 
DataOutputStream class, 655-657 

TestDataStream.java, 657-658 

using, 657 
Date class, 274-275, 1060 
Date constructor, 274 
Date/time, displaying, 1060-1071 

calendar, displaying, 1065-1070 
CalendarApp class, 1067 
CalendarApp.java, 1070-1071 
CalendarPanel class, 1066-1067, 1070 
CalendarPanel.java, 1067-1070 

DateFormat class, 1061 

DateFormatSymbol s class, 1062-1063 

international clock display, 1063 
WorldClockApp.java, 1066 
WorldClockControl.java, 1064-1066 
WorldClock.java, 1064 

Simp! eDateFormat class, 1062 

TimeZone class, 1060-1061 
DateFormat class, 1061 
DateFormatSymbol s class, 1062-1063 
De Morgan's law, 90 
Deadlocks, 1001-1002 
Debuggers, 55 
Debugging, 54-55 

defined, 55 



Decimal numbers, 9 
Decimal Format class, 1074 

applyPattern(String pattern) 
method, 1074 
Declarations, 30 
Declared type, 385, 387-388 
Declaring exceptions, 439—440 
Decrement operator, 40 
Deep copy, 473 
Default constructor, 270 
Default field values, 270 
Default modifiers, 282 
Default values, 200, 272-273, 288, 422, 593 
DefaultCell Editor class, 1245, 1247 
Def aul tComboBoxModel class, 1216, 1220 
DefaultListCellRenderer, 1212 
Defaul tListModel class, 1209-1211 
DefaultMutableTreeNode, 1251, 1256-1259 
depthFirstEnumerationO method, 1256 
Def aul tTabl eCol umnModel class, 1233 
DefaultTableModel class, 1231-1233, 
1241-1242, 1244 

methods in, 1231-1233 
Defaul tTreeCell Editor, 1251, 1266-1267 
Defaul tTreeCell Renderer class, 1251, 1265 
Defaul tTreeModel class, 1251, 1254-1256 
Defaul tTreeSelectionModel class, 1259 
Degree of a vertex, 894 
Delete key, 5 

Delimiters, changing, 307 
Delphi, 6 

deposit method, 987-989 
Deprecated methods, 976 
Depth-first search (DFS), 893, 900, 909, 
911-916 

algorithm (listing), 912-913 

applications of, 915-916 

defined, 893 

implementation of, 913-914 
isVisited array, 913 
TestDFS.java, 914-915 
time complexity, 913 
Depth-first traversal: 
graphs, 911, 1256 
trees, 861 

depthFirstEnumerationO method, 
DefaultMutableTreeNode, 1251, 1256 
Deque interface, 748-749 

TestQueue.java, 749-750 
Derived classes, See Subclasses 
Descent, 510 

Descriptive names, 25, 29, 52 

full, 52 

identifiers, 29 
Deserialization, 664 
destroy method, Applet class, 620 
Diagonal Layout class, 1124-1128 

DiagonalLayout.java, 1124-1126 

gap property, 1124 

lastfill property, 1124, 

majorDi agonal property, 1124, 

ShowDiagonalLayout.java, 
1127-1128 

TestDi agonal Layout class, 1128 
Dialog boxes, defined, 1164 
dialogTi tie property, JFileChooser class, 
1177 

dialogType property, DFileChooser 

class, 1 177 
Dialup modem, 5, 



Dijkstra, Edsger, 955 
Dijkstra's algorithm, 955 
Dimension class, 1128 
Directed graphs, 893 
Directory path, 323 

Directory size, finding (problem), 687-688 

directory size, defined, 687 

DirectorySize.java, 687-688 
Discontiguous selection mode, 1260 
disjoint method, Collections class, 745 
Disks, 4 

DisplayFigure.java, 1133 
DisplaylmagePlayAudio.java, 634 
DisplaylmageWithURL.java, 633 
DisplayMessage applet, parameter names/values 
for, 621 

DisplayMessageApp.java, 623-624 
DisplayMessage.html, 621-622 
DisplayMessage.java, 622 
Display Time.java, 34-35 
DisplayUnicode.java, 45^16 
distinct SQL keyword, 1285 
Distinct tuples, displaying, 1285-1286 
Distributed TicTacToe game, 1041-1052 
Cell class, 1042 

HandleASession class, 1042-1043 
TicTacToeClient class, 1042-1043 
TicTacToeClient.java, 1047-1052 
TicTacToeConstants interface, 1042 
TicTacToeConstants.java, 1043 
TicTacToeServer class, 1042-1043 
TicTacToeServer.java, 1043-1047 

Divide-and-conquer strategy, 177 

Division (/), 33-34 

Division by zero, and runtime errors, 54 
do-whileloop, 116-121 
Documentation, 51-53 

defined, 5 1 
doInBackgroundO method, 1004 
doLayout method, 1115 
Domain constraints, 1276-1277 
Domain Name Servers (DNS), 1018 
Domain names, 1018 
doneO method, 1004 
Dot operator (.), 271 
Dot pitch, 5 

Double precision, 25, 29, 33, 131, 478 
doubl e type, 33, 36 

doubl e type values vs. f 1 oat type values, 35 

Doubl e wrapper class, 477 

Doubl e . parseDoubl e method, 56-57 

Doubly linked lists, 842 

draw3DRect method, 502 

drawArc method, 506 

drawlmage method, 521 

drawLine method, 500-501 

drawOval method, 506 

drawPol ygon method, 508-509 

drawPol yl i ne method, 508-509 

drawRect method, 500 

drawRoundRect method, 501 

drawString method, 500 

Drives, 4 

Drop-down lists, See Combo boxes 
DSL (digital subscriber line), 5, 1018 
Duplicate-free elements, storing using HashSet 
class, 731 

Duplicate objects, and object stream, 665 
DVDs, 4 

Dynamic binding, 385-387 
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E 

Eclipse, 10-11,409, 544, 1092, 1191 
Edge-weighted graphs, 940, 962 
Edi bl e interface, 465, 476 
EfficientPrimeNumbers.java, 780-782 
Eight Queens puzzle, 230, 678 
defined, 678 

EightQueens.java, 695-697 

isValid(row, column) method, 696 

search Crow) method, 696 
elementO method, Queue interface, 748 
Elementary programming, 23-57 
empty C) method, Stack class, 747 
EmptyBorder class, 1136-1137 
Encapsulating string, 305 

Encapsulation, 177, 274, 284-286, 305, 347-351, 
487 

benefit of, 362 

class, 347 

in class design, 363 

data field, 283-286 
encoding, 38 
Encoding scheme, 38-39 
EncodingDemo.java, 1085 
End-of-line style, 52-53 
End tag, 616 

Enrollment table, 1275-1277 

Enroll mentEvent class, 1101-1102, 1104, 1106, 

EnrollmentEventjava, 1101-1102 

enroll mentExceeded method, 1101, 1104-1105 

EnrollmentListener.java, 1102 

entrySetO method, Map interface, 752 

enum keyword, 709 

Enumeration interface, 747 

equal Area method, 460, 462, 712 

equal s method: 

AbstractSet class, 730, 898 

Object class, 375, 377,384 
equal slgnoreCase method, String class, 303 
Erroneous solutions, 133 
Error class, 437^38 

subclasses of, 438 
Escape sequences for special characters, 46 
EtchedBorder class, 1136-1137 
Euclidean algorithm, 133 
Euler, Leonard, 892 
EvaluateExpression.java, 849-851 
Event, defined, 534 
Event dispatch thread, 979, 1004 
Event-driven programming, 534-560 

defined, 534 
Event pair, 1094 
Event set, 1094 

EventDispatcherThreadDemo.java, 979-980 
EventListener, 1102 
EventListenerList, 1099 
EventObject class, 534 
Events: 

key, 555-557 

mouse, 552-554 
Ever-waiting threads, 994 
Exception class, 434, 438, 440-442, 448^150 
Exception classes, types of, 437-439 
Exception handling, 432—450 

advantages of, 434-437 

custom exception classes, 448-450 

exception types, 437—439 

f i nal 1 y clause, 445^146 

overview, 432—434 



Quotient.java, 432 

QuotientWithException.java, 433-434 

QuotientWithlf java, 432^133 

QuotientWithMethod.cpp, 435^136 

rethrowing exceptions, 447 

when to use exceptions, 447 
Exception propagation, 441, 447 
Exception types, 437^4-39 
Exceptions, 432-450 

chained, 447-448 

chained exceptions, 447—448 

checked, 439, 442 

declaring, 439^140 

defined, 434 

propagation, 441, 447 

throwing, 440 

unchecked, 439, 445 
executeQueryO method, Statement interface, 
1295 

executeUpdateO method, Statement interface, 
1295 

Execution time, 217, 746, 766-767, 769 
Executor interface, 983 
ExecutorDemo.java, 984-985 
Executors class, 984 
ExecutorService interface, 983 
exitMenu menu, 1154 
Exponent methods, Math class, 172-173 
Exponential algorithm, 771 
Exponential time, 771 
Expression statement, 40 
Expressions, 31 

compound, 847 

conditional, 74, 95 

EvaluateExpression.java, 849-85 1 

evaluating, 36-37 
case study, 847-851 
Extended classes, See Subclasses 
Extending, prevention of, 396 
External sort, 809-816 

analysis, 816 

copying first half segments (listing), 812 
CreateLargeFile.java, 809-811 
creating initial sorted segments (listing), 811 
defined, 809 

merging all segments (listing), 812 
merging two segments (listing), 812-813 
phase I, implementation of, 811 
phase II, implementation of, 811-813 
sort phases, defined, 809 
SortLargeFile.java, 813-815 
two phases, combining, 813-815 

F 

factorial method, 679-681, 698 
Factorials, computing: 
base case, 678 

ComputeFactorial.java, 679-681 
problem, 678 

stopping condition, 678-681 
FahrenheitToCelsius.java, 37 
Fail-fast, use of term, 1003 
Fairness policy, and locks, 989 
Fall-through behavior, 94 
Fibonacci, Leonardo, 681 
Fibonacci numbers, computing (problem), 
681-683 

ComputeFibonacci.java, 681-683 

fib method, 683 



Fibonacci numbers, finding (case studies), 
771-773 

ImprovedFibonacci.java, 773 
FigurePanel class (case study): 

FigurePanel.java, 503-505 

TestFigurePanel.java, 502-503 

UML diagram, 265 
File class, 322-325,327 

lastModifiedO method, 324 

obtaining file and directory properties using, 
323 

TestFileClass.java, 324-325 
File dialogs, 329-330 

ReadFileUsingJFileChooser.java, 329-330 
File encoding scheme, 1042 
File input and output, 325-329 

Pri ntWri ter class, writing data using, 
325-326 

Scanner class, reading data using, 326-327 

WriteData.java, 325-326 
File names: 

absolute, 323 

relative, 323 
File pointer, 666-668 
FilelnputStream class, 652-654 

constructors, 652 
FileOutputStream class, 652-654 

constructors, 652 
Files, naming consistently, 423 
fill method, Collections class, 223, 742 
fill 3DRect method, 502 
filled property, 502 
fillOval method, 502 
fillRect method, 501 
f i 1 1 RoundRect method, 502 
Filter streams, 655 
Fil terlnputStream class, 655 
Fil terOutputStream class, 655 
final modifier, 396, 1316 
f i nal 1 y clause, 
FindGrade.java, 1292-1294 
FindGradeUsingPreparedStatement.java, 

1295-1297 
FindNearestPoints.java, 243-244 
Flash drives, 4 
float type, 27, 33 

Floating-point approximation, 35, 1311 
Floating-point literals, 35-36 
Floating-point numbers, 33, 36 

defined, 36 
Floppy disks, 4 

FlowLayout manager, 41 1-413, 417, 505, 1 1 14, 
1134 

hgap property, 417 

order of components added to a container, 412 
placing components in a frame using, 410 
properties, 4171 

ShowFlowLay out. java, 41 1-413 

vgap property, 417 
flush O method, 660 
focusable property, 557 
FocusEvent, 534-535, 537 
FocusListener interface, 487, 498 
Font class, 419-120 
FontMetrics class, 510-512 

TestCenterMessage.java, 511-512 
for-each loops, 203 
for loop, 126-128 
Foreign key, 1277 
Foreign key constraints, 1277 
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Formal parameters, 157 
Format specifier, 95-97 
FORTRAN, 6 
Forward pointer, 842-843 
Fractals: 

defined, 692 

problem, 692-695 

Sierpinski triangle, 692-695 
defined, 692 

SierpinskiTriangle.java, 692-695 
Frame class, 542, 544, 546-547, 1112 
Frames, 408^110 

adding components to, 410 

creating, 408-409, See also JFrame class 

My Frame Java, 408^109 

MyFrameWithComponents.java, 410 
Framework-based programming using, 536 
frequency method, Col 1 ections class, 742, 745 
Full descriptive names, 52 
Function keys, 4-5 
Functions, 157 

G 

Garbage collection, 208, 274 
Garbage, defined, 274 
GCDl.java, 774-775 
GCD2.java, 776 

Generic matrix class (case study), 719-723 
CenericMatrix class: 

addMatrix method, 719-721 

class diagram, 719 

GenericMatrix.java, 720-721 

IntegerMatrix class, 719, 721-722 

IntegerMatrix.java, 721-722 

mul ti pi yMatrix method, 720-721 

Rational Matrixclass, 719, 722 

RationalMatrix.java, 722 

TestlntegerMatrix.java, 722-723 

TestRationalMatrix.java, 723 
Generic programming, 388-389, 480 

and interfaces, 480 
Generic types, 708 
GenericMatrix.java, 720-721 
Generics, 708-723 

actual concrete type, 708 

benefit of, 708, 711 

bounded generic type, 712 

BoundedTypeDemo.java, 712-713 

defined, 708 

erasing of, 716-717 

erasure and restrictions on, 716-719 

formal generic type, 708 

generic class constructor, 711 

generic class parameter, 713 

generic classes and interfaces: 

declaring, 710-712 

multiple generic parameters, 711 
generic instantiation, 708 
generic matrix class (case study), 719-723 
generic method parameter, 713 
generic methods, 712-713 

invoking, 712 
generic types, benefits of using, 711 
GenericMethodDemo.java, 712 
Ceneri cStack class, 688, 7 1 2 
GenericStack.java, 710-71 1 
inheritance with, 712 
motivations and benefits, 708-710 
raw type and backward compatibility, 713-714 



unbounded generic type, 7 1 3 

wildcard generic types, 714-716 
GenericSort.java, 479^-81 
Geometric objects, 375 
GeometricObject class, 375 

Circle4.java, 376-377 

GeometricObjectl.java, 375-376 

Rectanglel.java, 378 
GeometricObj ectComparator.j ava, 737-7 3 8 
GeometricObjectjava, 458^160 

abstract methods, 459 
benefits of defining, 460 

TestGeometricObject.java, 461^162 
getAdjacencyMatrixO method, 

AbstractCraph class, 909 
get Area () method, 264, 267, 272 

Circle class, 375 
getAreaO method, Rectangle class, 375 
getAvailableFontFamilyNamesO method, 420 
getAvailableLocalesO method, 1060 
getBMIO instance method, 352-353 
getBundle method, 1079 
getByName method, 1025 
getClassO method, 632 

getCodeBaseO .getHostC) method, 1029, 1031 
getColumnClassO method, 1242, 1244 
getCol umn (col umnldenti f i er) method, 
JTable class, 1233 

getCol umn (index) method, Tabl eCol umnModel 

interface, 1233 
getCol umnNamesO method, 1242 
getCurrencylnstance method, 

NumberFormat class, 1073 
getDatelnstance method, 1061 
getDateTimelnstance method, 1061 
getDi ammeter O method, Ci rcl e class, 375 
getDisplayNameO method, 1071 
getElementAt method, ListModel, 1209 
getFontMetrics methods, Graphics class, 510 
getHamiltonianPath(int v) method, 924 
getHeightO method, 520 
getHostAddress method, 1025 
getHostName method, 1025 
getlnputStreamO method, 1020 
getlnstance method, NumberFormat class, 1072 
get (i nt f i el d) method, Cal endar class, 462 
getKeyCharO method, 1094 
getKeyCodeO method, 555 
getKeysO method, 1161 
getKeyStroke method, 1152 
getLeadSelectionPathO method, 1259 
getLi stCel 1 RendererComponentO 

method, 1245 
getLocalGraphicsEnvironmentO method, 420 
getMinimumSpanningTree method, 943 
getNumberlnstance method, NumberFormat 

class, 1072 
getNumberOf Objects, 278-279 
getNumberOfPrimes method, 1006 
getOutputStreamO method, 1020 
getParameter method, Appl et class, 622 
getParent(v) method, Tree class, 912 
getPercentlnstance method, NumberFormat 

class, 1073 
getPerimeterO method: 
Circle class, 375 
Rectangle class, 375 
getPreferredSizeO method, 505 
getPriority method, 977 
getRadius method, 285 



getRootO method, Tree class, 912 
getSearchOrdersO method, Tree class, 912 
getSelectionPathsO method, 1259 
getShortestPath method, 961 
getSizeO method, ListModel, 1209 
getSizeO method, MyStack class, 394 
getSourceO method, 535 
getStatusO instance method, 353 
getString method, 1079 
getTabl eCel 1 RendererComponent () 

method, 1245 
getTestTime method, 746 
getTimelnstance method, 1061 
getTreeCell RendererComponent method, 1265 
getWeekdays method, 1070 
getWidthO method, 512, 520 
GIF (Graphics Interchange Format), 422 
Gigahertz (GHz), 3 
Glue, 1119 
Gosling, James, 8 
goto keyword, 1311 
goto statement, 137 
GradeExam.java, 241-242 
Graph applications, 892-930 
Graph interface, 898-899, 900, 908-909, 916, 927 

class diagram, 899 
Graph traversals, 911-912 

breadth-first traversal, 911 

defined, 911 

depth-first traversal, 911 
Graphical user interface (GUI), 572, See also GUI 
programming 

displaying components, 276 

GUIComponents.java, 277-278 

TestFrame.java, 276 
Graphics, 498-525 

graphical coordinate systems, 498 

Graphics class, 498-500 

images, displaying, 520-522 

ImageViewer class, 522-525 

MessagePanel class (case study), 512-516 

paintComponent method, 516 

StillClock class, 517-520 
Graphics class, 498-500 

methods, 499, 508-509 
Graph i csEnvi ronment class, 420 
Graphs: 

AbstractGraph class, 898-899, 900, 902, 

908-909,911,916, 927-928 
AbstractGraph.java, 903-908 
adjacency lists, 897-898, 908, 910 
adjacency matrices, 896-897 
adjacency lists vs, 898 
algorithms, 898, 923 
basic terminologies, 893-894 
breadth-first search, 912-916 

algorithm (listing), 916 

applications of, 918-919 

defined, 916 

implementation of, 916-917 

Nine Tail Problem, 919-923 

TestBFS.java, 917-918 
common operations for, 898-899 
complete, 893-894 
components of, 893 
defined, 893 

depth-first search (DFS), 912-916 
algorithm (listing), 912-913 
defined, 912 

implementation of, 913-914 
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Graphs: (continued) 

TestDFS.java, 914-915 

time complexity, 913 
directed, 893 
edge array, 895-896 
edge objects, 896 
edges, 894 

edges, representing, 895-898 

Graph.java, 902-903 

Knight's Tour problem, 923-930 

defined, 924 

Hamiltonian cycle, 924 

Hamiltonian path, 924 

Hamiltonian path algorithm (listing), 
926-927 

KnightTourApp class, 924 

KnightTourApp.java, 929-930 

KnightTourModel class, 924 

KnightTourModel.java, 925-926 

NP-complete, use of term, 927 

time complexity, 927 
modeling, 898-909 

and modeling of real-world problems, 892, 923 
representing, 894-898 
simple, 894 

TestGraph.java, 900-902 
theory, 892 
undirected, 893 

UnweightedCraph class, 898, 900, 902 

UnweightedGraph.java, 908-909 

vertices, representing, 894-895 
Greatest common divisor, finding: 

case studies, 774-777 

GCDl.java, 774-776 

GCD2.java, 776-777 

problem, 131-133 
GreatestCommonDivisor.java, 132-133 
GreatestCommonDivisorMethod.java, 1 65- 1 66 
GregorianCalendar class, 462^163, 1060 
GridLayout manager, 413^-15, 505, 1114 

properties, 417 

ShowGridLayout.java, 414^-15 

specifying the number of rows/columns in a 
grid, 414 
Growth functions, comparing, 771 
Growth rate, 766 
GuessDate class: 

designing, 359-362 

GuessDate.java, 361-362 

UseGuessDateClass.java, 360-361 
Guessing numbers (problem), 118-120 
GuessNumber.java, 119-120 
GuessNumberOneTime.java, 118-119 
GuessNumberUsingBreak.java, 1 37 
GUI event dispatch thread, 979-980 

EventDispatcherThreadDemo.java, 979-980 
GUI programming, 406-424 

arcs, drawing, 506-507 

Color class, 419 

component classes, 406-407 

container classes, 406—407 

Font class, 408, 419-420 

frames, 408^110 

GUI classes, classification of, 407 
helper classes, 406, 408 
image icons, 422-424 
Java GUI API, 406-408 
layout managers, 411^-17 

Border-Layout manager, 415—417 

FlowLayout manager, 411-413 



GridLayout manager, 413-415 

properties of, 417 

setLayout method, 41 1, 420 
panels, using as subcontainers, 417-419 
polygons/polylines, drawing, 507-510 
Swing GUI components, 406-407 

common features of, 420-424 
Swing vs. AWT, 406 

H 

Hand-traces, 55 
HandleASessi on class, 1043 
HandleEvent.java, 470-471 
Handlers, 536, 1094 

Handling the exception, use of term, 434 

Hard disks, 4 

Hardware, 2, 7 

Hash map, 753-755 

Hash sets, 730-732, 746 

hashCode method, 731 

HashMap class, 751-752 

HashSet class, 730-734 

Hashtable class, 753, 1003 

hasNextO method, Iterator interface, 730, 880 

Heap class, 804-806 

class diagram, 804 

heap time complexity, 807 

Heap.java, 804-806 
Heap sort, 801-802 

HeapSort.java, 806 

merge sort vs., 806 

sort time, 801 
Heaps, 

defined, 801 

Heap class, 804-806 

height of, 807 

new node, adding, 802 

root, removing, 802-804 
Heavyweight Swing components, 406 
Height, 510 

Helper classes, 406, 408 
Hertz (Hz), 3 
Heuristics, 929 
hgap property: 

Border Layout manager, 417, 1114 

Fl owLayout manager, 417 

GridLayout manager, 417 
Hidden data fields, 346 
Hidden static methods, 383 
High-level languages, 6, 7 
Histogram.java, 604-606 
Hoare, C. A. R., 797 
Horizontal alignment, 574, 584 
Horizontal text position, 575 
House.java, 472—4-73 
howToEat method, 466, 475^-76 
hspace attribute, 617 
HTML tag, 616 

Hypertext Markup Language (HTML), 8 
I 

I/O, in Java, 650 
IBM DB2, 1278 
IBM Informix, 1278 
Icons: 

alignments, 574 

sharing, 424 

text positions, 575 



Identifiers, 299 

using abbreviations for, 52 
IdentifyHostN amelP.java, 1 025-1 026 
IEEE 754, 33 

if . . . else statements, 79 
i f statements, 74-75 

nested, 80-81 

simple, 75 

IllegalArgumentException, 438, 440, 445 
Image icons, 422-424, 1152-1153, 1214 

Testlmagelcon.java, 423—124 
Imagelcon, 1131 
Images, displaying, 520-522 

Displaylmage.java, 521-522 
ImageViewer class, 522-525 

Image Viewer.java, 525-525 

SixFlags.java, 523 
Immutable classes, 344, 487 
Immutable objects, 344-345 
Immutable strings, 302-303 
Implicit import, 17 
ImprovedFibonacci.java, 773 
Incompatible operands, 90 
Increment and decrement operators, 40, 45 
Incremental development and testing, 88, 183 
Increment. java, 163 
Indent code, 52 
Indentation style, 52 
Indexed variables, 200 
InetAddress class, 1025-1026 
Infinite loop, 117, 128 
Infinite recursion, 679 
Information hiding, 177 
Inheritance, 374 

aggregation vs., in class design, 412 

casting objects, 387-389 

defined, 374 

and modeling of the is-a relationship, 379, 394 
multiple, 379 
Object class, 384 
overriding methods, 383-384 
overriding vs. overloading 

methods, 383-384 
single, 379 
subclasses, 374-379 
super keyword, 380-382 
superclass, 374-379 

using to design stack and queue classes, 843 
i ni t method, Appl et class, 620 
initial-action, 126-127 
Inner class, 541-542 
Inner class listeners, 541 
InnerCl ass class, 541-542 
Inorder traversal, 861, 870 
Inorderlterator class, 880 
inorderlteratorO method, 880 
Input dialogs, 55-58, 1 167-1168 

defined, 1167 

using, 56-57 
Input errors, 54 
Input/output devices, 2, 4-5 

keyboard, 4-5 

monitor, 5 

mouse, 5 
Input stream, defined, 652 
InputMismatchException, 327 
InputStream class, 652 
Insert key, 5 

insert (element) method, 870 
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Insertion sort, 219-222 

InsertionSort.java, 222 
Insertion sort algorithm, 770 
insertRow method, 1242 
Insets class, 1126 
Inside access, 283 
Instance, 264 
Instance method, 271 
Instance variables, 278, 350 
Instantiation, 264 

generic, 708 
int, 32 

Integer literals, 35 

Integer vs. decimal division, 37 

Integer weights, 940 

Integer wrapper class, 476 

IntegerMatrix class, 719, 721 

IntegerMatrix.java, 721-722 

Integer . parselnt method, 56 

Integrated Development Environment (IDE), 10 

debugging in, 55 
Integrity component, relational database 

systems, 1274 
Integrity constraints, 1276-1278 

domain constraints, 1276-1277 

enforcing, 1277-1278 

foreign key constraints, 1277 

primary key constraints, 1277 
Interface inheritance, 465 
Interfaces, 465^176, 898-899 

abstract classes vs., 473-476 
in class design, 475 

ActionListener interface, 469^-71 

CI oneabl e interface, 47 1-473 

defined, 465 

distinguishing from a class, 465 
and generic programming, 469 
in the Java Collections Framework, 728 
marker, 47 1 

naming convention, 4758 
TestEdible.java, 465^66 
International clock display, 1064-1066 
WorldClockApp.java, 1066 
WorldClockControLjava, 1064-1066 
WorldClock.java, 1064 
Internationalization, 1015-1047 
character encoding, 1084-1085 

EncodingDemo.java, 1085 
date/time, displaying, 1060-1071 
Locale class, 1058-1060 

constants based on language, 1060 

country codes, 1059 

getAvailableLocalesO method, 1060 

language codes, 1059-1060 

local sensitive operations, 1060 

locale property, 1058 
numbers, formatting, 1071 

currency format, 1073 

Decimal Format class, 1074 

example of, 1074-1077 

locale dependence of, 1072 

NumberFormat class, 1072-1074 

NumberFormatDemo.java, 1074-1077 

parsing numbers, 1073 

percent format, 1073 

plain number format, 1072-1073 
resource bundles, 1077-1084 

for the Chinese language (example), 1080 

defined, 1077 



for the English language (example), 1079 
for the French language (example), 1080 
getBundle method, 1078 
Li stResourceBundle class, 1077 
MissingResourceException, 1079, 1084 
naming conventions, 1078 
property resource bundles, 1084 
ResourceBundle class, 1077-1078, 1084 
ResourceBundleDemo.java, 1080-1084 
updateString method, 1084 
ResourceBundle class, 1058 
Unicode, 1058 

Interned strings, 302-303 

Internet, defined, 1018 

Internet Protocol (IP), 1018 

Internet Protocol (IP) address, 1018 

Internet Service Provider (ISP), 1018 

Interrelational constraints, 1276 

interruptO method, 977, 1002 

InterruptedException, 977 

Intranational constraints, 1276 

invokeAndWait method, 979 

invokeLater method, 979 

Invoking a second constructor, 347 

IOException class, 654 

IP address, 1018 

is-a relationships, 394, 475 

is-kind-of relationship, 475 

is null operator, 1284 

isAliveO method, 1002 

i sCel 1 Edi tabl e method, Tabl eModel , 1243 

i sDi gi t method, Character class, 314 

isEmptyO method, Map interface, 752 

isEmptyO method, MyStack class, 394 

i sFocusabl e property, 557 

isLetter method, Character class, 314 

isLetterOrDi git method, Character class, 314 

isLowerCase method, Character class, 314 

isPalindrome method, 684 

isVisited array, 914, 916, 929 

ItemEvent, 537, 1094 

ItemListener interface, 537 

Iteration of a loop, 116 

Iteration, recursion vs., 697 

Iterator interface, 730, 739-740, 747, 880 

Iterators, 879-881 
advantages of, 881 
defined, 879 
Iterator interface, 880 
Iterator pattern, 881 

TestBinaryTreeWithlterator.java, 880-88 1 
variations of, 881 



JApplet class, 618, 1114 
Java, 6 

anatomy of characteristics of, 8 

defined, 2, 12 

versatility of, 10 
Java applet, accessing a database from, 1292-1294 

FindGrade.java, 1292-1294 
Java bytecode, running, 14 
Java class, 265, 272 
java ClassName, 15 

Java Collections Framework, 728-757, 898, 1002 
AbstractCol lection interface, 729-730 
Col 1 ection interface, 729-730 
Comparator interface, 737-738 

GeometricObjectComparator.java, 737-738 



constructors, for concrete classes in, 737 
defined, 728 
design of, 729 

interfaces and classes defined in, 729 

maps, 751-756 

priority queues, 748-750 

queues, 748-750 

sets, 706, 730-737 

Set interface, 730 

Stack class, 746-747 

types of collections supported by, 729 

Vector class, 746-747 
java command, 15, 22 
Java compiler, 12, 14 
Java database programming, 1231-1268, 

1250-1252, See also Database systems 

database systems, defined, 1274 

JDBC, 1244-1252, See also JDBC URLs, 1247 

PreparedStatement interface, 1253 
preparedStatement method, 1253 

relational database systems, 1274-1278 
attributes, 1275 
integrity, 1274 

integrity constraints, 1276-1278 

language, 1274 

relational data model, 1274 

structure, 1274 

tables, 1275-1276 

tuples, 1275 
relational structures, 1275-1276 
Structured Query Language (SQL), 1278-1286 

arithmetic operators, 1284-1285 

between-and operator, 1283-1284 

Boolean operators, 1282-1283 

from clause, 1282, 1286 

column alias, 1284 

comparison operators, 1282-1283 

creating a database, 1279-1280 

creating a user account on, 1278-1279 

creating and dropping tables, 1280-1281 

defined, 1278 

delete records, 1281-1282 

distinct tuples, displaying, 1285 

inserting records, 1281-1282 

is null operator, 1283-1284 

1 i ke operator, 1283-1284 

select clause, 1282-1283, 1285 

simple queries, 1282 

standard SQL, 1278 

tables, joining, 1286 

updating records, 1281-1282 
Java Development Toolkit (JDK), 10 
Java Enterprise Edition (Java EE), 14 
Java expressions, evaluating, 36-37 
Java file, 14 
Java GUI API, 406^108 
Java keywords, See Keywords 
Java language specification, 10-11 
Java Micro Edition (Java ME), 10 
Java modifiers, See Modifiers 
Java program-development process, 13 
Java program, simple, 11—13 
Java source-code file, creating, 14 
Java source programs, case sensitivity of, 14 
Java Standard Edition (Java SE), 10 
Java Virtual Machine (JVM), 14, 208, 
java . awt package, 406, 408 
j ava . awt . Appl et class, 1112 
java. awt. Color class, 408, 419 
java. awt. Component, 1112 
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java.awt. Container, 408, 1112, 1115, 1123 
java.awt. Dialog, 1112, 1174 
java.awt. Dimension, 408 
java.awt. Font, 408, 419 
java.awt . FontMetrics, 408 
j ava . awt .Frame class, 1112 
java.awt .Graphics, 408, 499, 521 
java . awt .CraphicsEnvi ronment, 420 
java.awt.LayoutManager, 408 
JavaBeans, 1092-1106 
components, 1092 

relationship between Java classes and, 
1092-1093 
custom event sets, creating, 1101-1 106 
CourseWithEnrollmentEvent.java, 
1103-1105 

Enroll mentEvent class, 1101-1102, 1104 
EnrolImentEventjava, 1101-1102 
enroll mentExceeded method, 1104 
Enroll mentListener class, 1102 
EnrollmentListener.java, 1 102-1 103 
TestCourseWithEnrollmentEvent.java, 

1105-1106 
custom source components, creating, 

1097-1101 

CourseWithActionEvent class, 1097-1098 
CourseWithActionEvent.java, 1098-1099 
deregistration method, 1097 
multicast listener, 1097 
registration method, 1097 
TestCourseWithActionEvent.java, 1 100-1 101 
defined, 1092 

delegation-based model, 1094 
event, 1094 

event classes, 1094-1095 

event listener interface, 1094-1095 

event object, 1094 

event set, 1094 

Java event model, 1094-1096 

listener, 1094 

listener components, 1095-1096 

minimum component requirements, 102 

properties, 1093-1094 

and data fields, 1093-1094 

property-naming patterns, 1093 

source components, 1095 

source object, 1094 
javac command, 1 5 
javadoc comments, 51-52 
java. io. FileNotFoundExcept ion, 653 
java.io.IOException, 653-654 
java. Jang package, 17, 39, 56, 313, 467 
java. Jang. CI ass class, 632 
java . J ang .CI assNotFoundException, 664 
java. Jang. Comparable, 467, 475 
java . 1 ang . InterruptedException, 1002 
java. J ang. Number, 1073 
java . J ang . UnsupportedOperation- 

Exception,730 
java. math, 481 
java.net, 632 

java. net. BindException, 1019, 1024 
java. net. ConnectException, 1024 
java . net . URL class, 632, 1037 
Java's built-in monitor, 994-995 
JavaServer Pages, 10 
java.sun.com, 8-10, 51, 175 
java. swing. SwingConstants, 1052 
java. text .DateFormat class, 1060 
java. text. Decimal Format, 1074 



java. text . ParseException, 1073 
java.util package, 28 
java.util .ArrayList, 1003, 1209 
java.util .Calendar, 1060 
java.util .Collection, 748 
java.util . concurrent package, 998 
java.util .Date, 1060 
java.util .EventListener, 1094, 1101 
java.util .EventObject, 1094, 1101 
j ava . uti 1 . Hashtabl e, 753, 1003 
java.util .Map, 1003 
java.util .Observer interface, 1188 
java.util .Queue, 998 
java.util .TimeZone, 1060 
java.util .Vector, java.util .Stack, 1003 
j avax .swing package, 406, 1 25 1 
javax. swing. Border package, 1138 
javax.swing.BorderFactory, 1138 
javax. swing. BoxLayout, 1118 
j avax . swi ng . event package, 596 
j avax . swi ng . event . ChangeEvent, 1204 
j avax . swi ng . event . Event Li stener- 
List, 1099 

j avax . swi ng . event . Hyperl i nkEvent, 1039 
javax. swing. JApplet, 407, 615 
j avax . swi ng . JDi aJ og, 407 
javax. swing. JEditorPane, 1039 
j avax . swi ng . JFi 1 eChooser, 1 176-1 177 
j avax . swi ng . JFrame, 407 
j avax . swi ng . JPanel , 407, 1114 
javax. swing. Li stSelectionModel , 593 
javax. swing. RowFi Iter, 1235 
javax. swing. Swi nglltilities, 979 
j avax . swi ng . Ti mer, 557 
j avax . swi ng . t ree package, 1 25 1 
JButton class, 276, 406, 410, 420, 422, 522, 
535-536, 572-573, 575, 583, 1092, 
1112-1113, 1195-1196 

GUIComponentsjava, 277-278 
JCheckBox class, 535, 572, 581 

GUIComponentsjava, 277-278 
JCheckBoxMenuItem class, 11501153, 1156 
JColorChooser class, 1174-1176, 1181 

color preview panel, 1176 

defined, 1174 

showDialog method, 1175 

tabbed pane, 1 176 
JComboBox class, 276, 406-408, 410, 412^413, 
420, 422, 547, 551, 587, 602, 615, 
1216-1219 

ComboBoxCellRendererDemojava, 
1216-1219 

GUIComponentsjava, 277-278 

properties/constructors, 1216 
JComponent class, 499, 501, 583-584, 1158 
JDBC, 1286-1303 

Cal 1 abl eStatement interface, 1297 

classes, 1288 

connections, establishing, 1289-1290 
defined, 1286 

developing database applications using, 

1287-1289 
drivers, 1288 
loading, 1288-1289 

FindGradeUsingPreparedStatementjava, 

1295-1297 
interfaces, 1288 

Java applet, accessing a database from, 

J292-1294 
metadata retrieval, 1300-1303 



database tables, obtaining, 1301 
Da t aba seMetaDat a interface, 1300 
Resul tSetMetaData interface, 1302 
TestDatabaseMetaDatajava, 1301 
TestResultSetMetaDatajava, 1303 
PreparedStatement interface, 1295 
relationships between Java programs, JDBC 
API, JDBC drivers, and relational 
databases, 1287 
Resul tSet, processing, 1290 
SimpleJDBCjava, 1291-1292 
statements, executing, 1 290 
JDBC-ODBC bridge driver, 1287, 1292 
jdbc:odbc:dataSource, 1289 
JDialog class, 406-407, 1112-1113, 1164, 1171 
JDK 1.6, 10 

JEditorPane class, 1039-1041 

WebBrowserjava, 1040-1041 
JFileChooser class, 290, 1176-1181, 1153 

currentDi rectory property, 1177 

dialogTi tie property, 1177 

dialogType property, 1177 

mul ti Sel ectionEnabl ed property, 1 177 

no-arg constructor, 1176 

ReadFileUsingJFileChooserjava, 329-330 

sel ectedFile property, 1177 

sel ectedFiles property, 1177 

showOpenDialog method, 1177 

showSaveDialog method, 1177 

TextEditorjava, 1177-1181 
JFrame class, 276, 406-408, 410, 412^113, 
420, 422, 547, 551, 587, 602, 615, 
1112-1113 

compared to 3 Applet class, 618 

setDefaul tCloseOpeartion method, 276 

setLocation method, 276 

setSize method, 276 

setTi tl e method, 276 

setVisible method, 276 
JLabel class, 406, 420, 422, 500, 583-584 
JList class, 276, 535,593-594, 1196 

constructors, 1205 

DefaultListCellRenderer, 1212 

DefaultListModel, 1210-1211 

HORIZONTAL_WRAP, 1206 

list layout orientations, 1206 

list-selection models, 1206-1207 

list-selection modes, 1206-1207 

methods, 1205 

properties, 1205 

scrollable list, creating, 1209 

string values, 1207 

VERTICAL, 1206 

VERTICAL_WRAP, 1206 
JMenu class, 1113, 1150 
JMenuBar class, 1112-1113, 1150 
JMenuItem class, 1112-1113, 1150 
JOptionPane class, 50, 55, 1164-1 171 

confirmation dialog, 1166-1167 
defined, 1 164 

creating, 1169-1171 

dialogs created using, 1164 

input dialog, 1167-1168 
defined, 1164, 1167 

message dialogs, 1 165-1 166 
defined, 1 164 

option dialog, 1168-1169 
defined, 1164, 1168 

showMessageDialog method, 29, 98 
JOptionPaneDemo.java, 1170-1171 
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JPanel class, 277, 406^08, 417, 420, 500, 503, 
521, 554, 1114, 1181 

as a canvas for drawing, 500 
JPasswordField class, 572, 586 
JPEG (Joint Photographic Experts Group), 422 
JProgressBar, 1007-1010 

class diagram, 1008 

ProgressBarDemo.java, 1008-1010 

PropertyChangeEvent, 1010 
JRadioButton class, 276, 406, 535, 578, 581 

GUIComponents.java, 277-278 
JRadioButtonMenuItem class, 1 150-1 153 
JScrol 1 Bar class, 596 
JScrol 1 Pane class, 1 128-1 132 

hsbPol i cy parameter, 1129 

methods, 1129 

ScrollMap.java, 1130-1131 

setCorner method, 1129 

viewport, 1128 

vsbPol i cy parameter, 1129 
JScrol 1 Pane class, 586 
JSlider class, 599 
jspDate, 1204 
jspDay, 1204 

JSpinner class, 1196-1198 

getNextValueO method, 1197-1198 

getPreviousValueO method, 1197-1198 

getValueO method, 1197-1198 

methods, 1197-1198 

sequence value, 1197-1198 

SimpleSpinner.java, 1 198 
JSpinner. DateEditortor, 1201 
JSpinner.DefaultEditor, 1201 
JSpinner. ListEditor, 1202 
JSpinner.NumberEditor, 1201 
JSplitPane class, 1133, 1195 

defined, 1133 

properties/constructors/methods, 1 134 

ShowLayout.java, 1134-1136 
jspMonth, 1204 
JTabbedPane class, 1132-1133 

defined, 1132 

DisplayFigure.java, 1133 
JTable class, 1226-1250 

auto sort and filtering, 1235-1237 

classes, 1227 

column model, 1226 

constructors, 1226 

for creating tables, 1227 

defined, 1226 

and events, 1205 

interfaces, 1226 

JTableHeader, as supporting class, 1226 

list-selection model, 1226 

methods, 1226-1227 

properties, 1226-1227, 1231 

rows/columns, modifying (case study), 
1237-1242 

rowSorter method, 1235-1236 

scrollable table, creating, 1 226 

table column models, 1231, 1233, 1237, 1247 
AbstractTableModel class, 1231 
Def aul tTabl eModel class, 1231 
Tabl eModel interface, 1231 
Tab! eModel Events, 1231 
TestTableModel.java, 1231-1232 

table model events, 1247-1250 

table models, 1231 

table Tenderers and editors, 1242-1245 
custom, 1245-1247 



TableColumn, as supporting class, 1226 

TablePropertiesDemo.java, 1 229- 1231 

TestTable.java, 1228 

TestTableSortFilter.java, 1236-1237 
JTableHeader class, 1226, 1235 
JTextArea class, 572, 576 

constructors/methods, 586 
JTextComponent class, 1039 
JTextField class, 406, 418, 420, 535, 572, 
584-585 

GUIComponents.java, 277-278 
JToggJ eButton class, 578 
JTool Bar class, 1 158-1 160 

floatable toolbar, 1 160 

ToolBarDemo.java, 1159-1160 
JTree class, 1250 

classes, 1251-1252 

complexity of, 1251 

constructors for creating tables, 1251 

data representation of the tree, 1251 

defined, 1250 

editable property, 1265 

interfaces, 1251 

modifying trees (case study), 1262-1265 

Modify Tree.java, 1262-1265 
SimpleTreeDemo.java, 1253-1254 
supporting interfaces and classes, 1251 
TestTreeModel.java, 1255-1256 
TestTreePath.java, 1260-1262 
tree events, 1267 

tree node rendering and editing, 1265-1267 
JViewport class, 1128 

K 

Key codes, 555 
Key constants, 555 
Key events, 555-557 
defined, 555 

KeyEventDemo.java, 556-557 
KeyAdapter class, 551-557 
Keyboard, 4-5 

accelerators, 1152-1153 

mnemonics, 1152-1153 
KeyEvent class, 535, 537, 555, 1094, 1247 
KeyEventDemo.java, 556-557 
KeyListener interface, 537, 555 
keyPressed handler, 555 
keyRel eased handler, 555 
keySet () method, Map interface, 752 
Keystroke class, 1152 
keyTyped handler, 555 
Keywords, 11, 1311 
Knight's Tour problem: 

defined 923-924 

Hamiltonian cycle, 924 

Hamiltonian path, 924 

Hamiltonian path algorithm (listing), 926-929 
KnightTourModel.java, 929-930 
NP-complete, use of term, 927 
time complexity, 927 

L 

Labels, 583-584 

defined, 583 
LAN (local area network), 5 
Language codes, 1058-1059 
Language component, relational database 
systems, 1274 



Large input size, 766 
LargeFactorial.java, 482 
lastlndexOf method, String class, 308 
lastModifiedO method, File class, 324 
Layout managers, 411-417, 1 1 14-1 123 
al ignmentX (al ignmentY) property, 417 
BorderLayout manager, 429^131, 415, 426, 
1114, 1146 
hgap property, 411, 1114 
setHgap method, 411, 413, 415 
ShowBorderLayout.java, 416 
vgap property, 43 1 , 
Box Layout manager, 1121, 1134 
and component's al ignmentX or 
al ignmentY property, 1119 
glue, 1119 
rigid area, 1119 

ShowBoxLayout.java, 1119-1122 
strut, 1119-1120 
unique features of, 1119 
CardLayout manager, 1115-1118 
add method, 1116 
methods, 1116 

ShowCardLayout.java, 1116-1118 
custom, creating, 1 123-1 128 
defined, 1114 
doLayout method, 1115 
FlowLayout manager, 41 1 — 413, 1114 

hgap property, 1114-15 

order of components added to a container, 407 

placing components in a frame using, 417 

properties, 409 

setHgap method, 417 

setVgap method, Fl owLayout manager, 417 
ShowFlowLayout.java, 41 1 — 41 3 
vgap property, 41 1 
GridLayout manager, 413^115, 1114 
properties, 417 

ShowGridLayout.java, 414^115 
specifying the number of rows/columns in a 

grid, 414 
maximumSize property, 1115 
mi nimumSize property, 1115 
null layout manager, using, 1 121-1 123 
ShowNoLayout.java, 1122-1123 
preferredSize property, 1114-1115, 1124 
properties affecting sizing/location of 

components in container, 1114 
set Layout method, 41 1 
val idate method, 1115 

LayoutManager interface, 1116, 1123-1124 
layoutContainer method, 1126 

Lead path, 1259 

Leading, 574-575 

leadSelectionlndex method, 1207 

1 eaf Icon property, 1266 

Leap year, determining (problem), 91 

LeapYear.java, 91 

Left child of a node, 872 

Left subtree, 872 

leftAction, MyAction class, 1164" 
lengthO method, StringBuilder, 278 

Level of a tree, 872 

Lightweight Swing components, 406-407 

like operator, 1283 

Line comment, 1 1 

Line numbers, 1 1 

Line separator sting, 328 

Linear search algorithm, 766 

Linear time, 747 
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LinearSearch.java, 216-217 
Li neBorder class, 1136-1138 
Lines, drawing, 501-502 
LinkageError class, 438 
Linked hash map, 752-754 
Linked hash set, 734-735, 745 
Linked lists, 830-842 

LinkedList class, 832-833 
MyLinkedList class, 832-833 
addFirst(e) method, 834 
add(index, e) method, 835-836 
addLast(e) method, 834-835 
implementing, 836-839 
MyArrayList class vs., 841-842 
removeFi rst() method, 836-837 
remove(index) method, 837-838 
removeLastO method, 838-839 
MyLinkedList.java, 839-841 
nodes, 830-832 
TestLinkedList.java, 833 
variations of, 842-843 
LinkedBlockingQueue, 998 
Li nkedHashMap class, 728 
LinkedHashSet class, 728, 731 
LinkedList class, 740-741 
defined, 740 
methods, 741 

TestArrayAndLinkedList.java, 741-742 
Linux, 7 

List cell Tenderer, 1212-1215 
List interface, 739-741, 823 

add method, 739 

addAl 1 method, 739-740 

indexof method, 739 

methods in, 739 

remove method, 740 

set method, 740 
List layout orientations, 1206 
List models, 1209-1212 

and ListModel interface, 1209 

ListModelDemo.java, 1210-1212 
List properties demo (example), 1207-1209 
List-selection models/list-selection modes, 

1206-1207 
ListCellRenderer class, 1212, 1214 

getLi stCel 1 RendererComponent 
method, 1212 

ListCellRendererDemo.java, 1214-1215 

MyListCellRenderer.java, 1213-1214, 
Li stCell Renderer interface, 1217 
ListDataEvent, 1209 
ListDataListener, 1209 
Listener components, 1095-1096 

TestSourceListener.java, 1096 
ListenerClass class, 492 
Listeners, 469, 535-541 

anonymous class listeners, 542-544, 547 

defined, 535 

inner class listeners, 542, 544 

listener interface adapters, 536-537 
AdapterDemo.java, 551-552 
Listlterator interface, 739 

add method, 730 

hasNextO method, 730 

next() method, 730 

previousO method, 730 

set method, 730 
ListModel interface 1209, 1216 
ListPropertiesDemo.java, 1207-1209 
Li stResourceBundl e class, 1077 



Lists, 593-596 738-742 
array lists, 825-830 

MyArrayList.java, 826-829 

TestList.java, 829-830 
ArrayList class, 740-742 

defined, 740 

Test Array AndLinkedList.j ava, 74 1 -742 

trimToSizeO method, 740 
circular doubly 1, 842-843 
circular, singly linked, 842 
common features for, 822-825 
compared to sets, 792-793 
defined, 593 
doubly linked, 842-843 
expressions, evaluating (case study), 847-851 
J Li st class, 593 
linked lists, 830-842 

variations of, 842-843 
linked structure, 822 
LinkedList class 740-741 

defined, 740 

LinkedList(Collection), 741 

methods, 741 

Test Array AndLinkedList.j ava, 74 1 -742 
List interface, 739 
ListDemo.java, 594-596 
performance of, 745-746 
queues, 748-750 

SetListPerformanceTest.java, 745-746 

stacks, 746-748 

static methods for, 742-745 
ListSectionListener, 1206 
ListSelectionEvent, 535 
Literals, defined, 35 
Load factor, 731 
Loan class, 347-349 

class diagram, 348 

Loan.java, 349-35 1 

test program, writing, 348-35 1 

TestLoanClass.java, 348-349 
Loan payments, computing (case study), 37-39 
Local area network (LAN), 1018 
Local variables, 171, 345 
Locale class, 1058-1060 

constants based on language, 1058 

country codes, 1059 

getAvailableLocalesO method, 1059 

language codes, 1059 

local sensitive operations, 1060 

1 ocal e property, 1058 
Lock interface, 989 
Locks 

and Java's built-in monitor, 994 

synchronization using, 989-991 

Account WithSyncUsingLock.java, 990-991 

ReentrantLock class, 989 
Log-linear time, 771 
Logarithmic time, , 771 
Logic errors, 54 
Logical operators, 88-90 
long, 32 
long literal, 35 
Long string, breaking, 26 
Long wrapper class, 476 
Loop body, 123 

loop-continuation-condition, 116-1 17 
Loop statement, 41 
Loops, 103-139, 860 
body, 123 

case studies, 131-135 



controlling, with a confirmation dialog, 
139-140 

controlling with a sentinel value, 122-124 

defined, 116 

do-while loop, 124-126 

infinite, 117 

iteration of, 117 

for loop, 126-128 

nested, 129-130 

pre-test, 128 

whileloop, 116-124 
Loss of precision, 41, 49 
Lottery (problem), 91-93 
Lottery.java, 91-93 
Lower-bound wildcard, 715 

M 

Mac OS, 7 

Machine language, 7, 15 
Main class, 265 

main method, 11-12, 15-16, 157-158,266,614, 
618-621, 624, 634, 637 
passing strings to, 320-321 
Main window, 602 
MalformedURLException, 1037 
Map, 728 

Map interface, 751-752 
Maps, 751-756 

AbstractMap class, 752 

HashMap class, 753 

Li nkedHashMap class, 753 

Map interface, 751-752 

concrete implementations of, 752 
methods, 751-752 
query methods, 752 
update methods, 752 

SortedMap interface, 752 

TestMap.java, 754-755 

TreeMap class, 752 
Marker interface, 47 1 
matches method, String class, 308 
Matching braces, 12 
Math class, 172-175, 272, 279, 396 

abs method, 174 

exponent methods, 173 

max method, 174 

min method, 174 

random method, 174-175 

rounding methods, 173-174 

trigonometric methods, 172 
Math learning tool, 73 

advanced, 121-124 

improved, 82-84 
MatteBorder class, 1136-1138, 1144 
max and mi n methods, Col 1 ections class, 744 
max method, 157-159,468-469 

Math class, 174 
Maxl.java, 714 

maxDaysInMonth method, 1204 
Max.java, 713 

Mbps (million bits per second), 5 
Megabyte (MB), 3 
Megahertz (mHz), 3 
Memory chips, 3 
Memory (main memory), 3 
Menu bar, creating, 1 150 
Menus, 1150-1156 

check-box menu items, 1151-1152 

classes, 1150 
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creating, 1152 

menu bar, 1 150 

menu items, 1 151-1 152 

MenuDemo.java, 1153-1156 

popup, 1156-1158 

radio-button menu items, 1 151 

submenu items, 1151 

using, 1153-1156 
Merge sort, 794-797 

algorithm (listing), 794-795 

illustration, 795 

merge sort time, 796-797 

method for merging two arrays (listing), 
794-795 

quick sort vs., 801 

time analysis, 796 
Message dialog box, displaying text in, 16-17 
Message dialogs, 1165-1166 

defined, 1164 
MessagePanel class (case study), 512-516 

implementation of, 513 

MessagePanel.java, 513-516 

TestMessagePanel.java, 513 

xCoordinate property, 512 

yCoorcHnate property, 512 
MessagePanel.java, 513-516 
Meta object, 633 
Metadata retrieval, 1 300- 1 303 

database tables, obtaining, 1301-1302 

DatabaseMetaData interface, 1300-1301 

Resul tSetMetaData interface, 1302-1303 

TestDatabaseMetaData.java, 1301 

TestResultSetMetaData.java, 1 303 
Method abstraction, 176-183 

bottom-up design, 179-180 

PrintCalendar.java, 181-183 

top-down design, 177-179 
Method block, 12 
Method header, 157 
Method name, 157 
Method overloading, 169 
Method signature, 157 
Methods, 16, 156-183, 271-272 

body, 157 

call stacks, 160 

calling, 158-160 

defined, 156-158 

modularizing code, 165-167 

naming, 52 

overloading, 168-170 

parameters, 157 

passing arrays to, 209-212, 240-241 

passing objects to, 286-287 

passing parameters by values, 162-165 

syntax for defining, 156 

value-returning, 157 

void, 160-162 
Microsoft Windows, 6-7 
min method, Math class, 174 
Minimum spanning trees (MSTs), 949-955 

getMinimumSpanningTree method, 952 

implementation of, 951-955 

MST class, 952 

Prim's algorithm, 950-951 

TestMinimuinSpanningTree.java, 953-955 

time complexity, 953 

uniqueness of, 952 
MissingResourceException, 1078-1079, 1084 
Modal dialogs, 1176 

Model-view-controller (MVC), See MVC 



Models, 1188 
Modem, 5 
Modifier key, 5 

Modifiers, 282, 289, 395-396, 466 

methods, 157, 159 
Modify Tree.java, 1262-1265 
Modularizing code, 165-167 

GreatestCommonDivisorMethod.java, 165-166 

PrimeNumberMethod.java, 166-167 
Monetary units, counting (case study), 47-50 
Monitor, 5 

defined, 994 
Mouse, 5 

Mouse events, 552-554 

MoveMessageDemo.java, 553-554 

moving a message on a panel using a mouse 
(example), 553-554 
mouseDragged method, 554 
MouseEvent, 535, 537, 1094, 1106, 1247 
MouseLi stener interface, 552-553 
MouseMotionListener interface, 536-537, 

552-554 
mousePressed handler, 1158 
mouseRel eased handler, 1158 
MovableMessagePanel class, 554 
MoveMessageDemo.java, 553-554 
MS Access, 1278 

JDBC-ODBC driver, 1287 

URL, 1289 
MST class, 951-953 
Multidimensional arrays, 236-251 

birth dates, guessing (problem), 250-25 1 
Multimedia, 634-637 

animations, 634-637 
Multiple-choice test, grading (problem), 241-242 

GradeExam.java, 241-242 
Multiple clients, serving, 1026-1029 
Multiple inheritance, 379 
Multiple solutions, 133 
Multiple windows: 

creating, 602-606 

Histogram.java, 604-606 

Multiple WindowsDemo .j ava, 603-604 
Multiplication (*), 33 
MultiplicationTable.java, 1 29-1 30 
Multiplicative constants, ignoring, 766 
Multiplicity, 354 
multiplyMatrix method, 720-722 
Multiprocessing, 8 
Multiprogramming, 8 
mul tiSel ectionEnabled property, 

JFileChooser class, 1177 
Multithreading, 8, 972-1010, 1028 

blocking queues, 998-999 

ArrayBlockingQueue, 998-999 
concrete, 998 
ConsumerProducerUsing- 

BlockingQueue.java, 999 
defined, 998 

LinkedBl ockingQueue, 998 
PriorityBlockingQueue, 998 

cooperation among threads, 991-995 
deadlocks, 1001-1002 

avoiding, 1001-1002 
defined, 972 

FlashingText.java, 978-979 

GUI event dispatch thread, 979-980 

JProgressBar, 1007-1010 

class diagram, 1008 

ProgressBarDemo.java, 1008-1010 



Producer/Consumer (case study), 995-996 

and program responsiveness/interactivity, 972 

Semaphore class: 

acquireO method, 1000 
class diagram, 1001 
releasee) method, 1000 

semaphores, 1000-1001 

SwingWorker class, 1004-1007 

synchronized collections, 1002-1003 

synchronized keyword, 987-988 

tasks, 972-975 

thread concepts, 972 

thread pools, 983-985 

thread states, 1002 

thread synchronization, 985-989 
MultiThreadServer.java, 1 026- 1 029 
Mutabl eComboBoxModel interface, 1216 
MutableTreeNode, 1251, 1255-1256 
Mutator method, 284-285, 522 
MVC, 1188-1219 

MVCDemo.java, 1193-1194 

Swing architecture, 1195-1196 

variations, 1194-1195 
MyAbstractList interface, 823-824 
MyAbstractList.java, 824-825 
MyAction class, 1164 
MyArrayList class, time complexities for 

methods in, 841-842 
MyArrayList.java, 826-829 

add method, 828 

cl ear method, 828 

contains method, 828 

ensureCapacity method, 828 

get method, 828 

indexOf method, 828 

1 astlndexOf method, 828 

remove method, 829 

set method, 829 

toString method, 829 
MyFrame.java, 408^109 
MyFrameWithComponents.java,410 
MylmageCellRenderer.j ava, 1 245- 1 247 
MyLinkedList class, 833-834 

addFirst(e) method, 834 

add(index, e) method, 835-836 

addLast(e) method, 834-835 

implementing, 834-839 

MyArrayList class vs., 841-842 

removeFi rstC) method, 836-837 

remove(index) method, 838-839 

removeLastO method, 837-838 
MyLinkedList.java, 839-841 

time complexities for methods in, 841-842 
My Li st interface, 823-824 

MyList.java, 823-824 
MyListCellRenderer.java, 1213-1214 
MyPriorityQueue class, 846 
MyPriorityQueue.java, 846-847 
MyQueue class, 844 
MySQL, 1278-1279 

JDBC driver, 1287-1288 

URL, 1289 
MyStack class, 788 

MyStack.java, 393-394, MyTableModel.java, 
1243-1244 

N 

Naming conflicts, avoiding, 266 
Naming conventions, 475 
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Narrowing a type, 41 
native keyword, 472 
native modifier, 1316 
Natural order, 735 

nCopies method, Collections class, 744 

Neighbors, 894 

Nested blocks, 171 

Nested class, 541-542 

Nested if statements, 74, 80-81 

Nested loops, 129-130 

NetBeans, 10-11,409, 1092 

Network interface card (NIC), 2, 5 

Networking: 

applet clients, 1029-1030 
client/server computing, 1018-1025 

client sockets, 1019 

Clientjava, 1022-1025 

data transmission through sockets, 1020 

example of, 1020-1025 

server sockets, 1018-1019 

Server.java, 1021-1022 
distributed TicTacToe game, 1041-1052 

Cell class, 1042 

HandleASession class, 1042-1043 
TicTacToeClient class, 1042-1043 
TicTacToeClient.java, 1047-1052 
TicTacToeConstants class, 1042 
TicTacToeConstants.java, 1043 
TicTacToeServer class, 1042-1043 
TicTacToeServer.java, 1043-1047 
Domain Name Servers (DNS), 1018 
domain names, 1018 
IdentifyHostNamelP.java, 1025-1026 
InetAddress class, 1025-1026 
Internet Protocol (IP) address, 1018 
JEditorPane class, 1039-1041 
multiple clients, serving, 1026-1029 
packet-based communications, 1018 
sending and receiving objects, 1031-1036 
ObjectlnputStream, 1031 
ObjectOutputStream, 1031 
StudentAddress class, 1032 
StudentAddress.java, 1032-1033 
StudentClient.java, 1033-1035 
StudentServer.java, 1035-1036 
stream-based communications, 1018 
Transmission Control Protocol (TCP), 1018 
User Datagram Protocol (UDP), 1018 
Web servers, retrieving files from, 1036-1039 
java.net. URL class, 1037 
MalformedURLException, 1037 
openStreamO method, 1037 
ViewRemoteFile.java, 1038-1039 
New account inner class (listing), 1000-1001 
new operator, 267-268, 270 
newConditionO method, 989, 991, 993, 997 

Condition interface, 991 
newDepos it condition, 991-994 
newFixedThreadPool (int) method, 983 
Newlnterface, 474 
next O, 27, 50-51 
Next-line style, 52-53 
next() method, Iterator interface, 740 
nextByteO method, 27,326 
nextDoubleO method, 27,326 
nextFloatO method, 27,326 
nextlntO method, 27,326 
nextLineO method, 27,326 
nextLongO method, 27,326 
nextShortO method, 27,326 



NIC, 2, 5 

Nine tail problem, 919-923 

NineTailModel.java, 921-923 

No-arg constructor, 266 

NoClassDefFoundError, 15 

Nondominating terms, ignoring, 766 

Nonextensible is-a relationship, 379 

Nonserializable fields, 664 

Nonstrict mode, floating-point arithmetic, 1311 

NoSuchMethodError, 15 

not operator, 1283 

notifyO method, 994-995 

notifyAH O method, 994-995 

NotSerial izableException, 664 

nul 1 keyword, 17 

null value, 272-273 

Nul 1 Poi nterException, 273, 438^139, 516 
Number class, 477-478, 482, 486 
NumberFormat class, 1072-1074 

getCurrencylnstance method, 1072 

getlnstance method, 1072 

getNumberlnstance method, 1072 

getPercentlnstance method, 1072 

setMaximumFractionDigits method, 1072 

setMinimumFractionDigits method, 1072 
NumberFormatDemo.java, 1074-1077 
numberOf Objects, 278-284 
Numbers, formatting, 42, 1071-1077 

converting to strings, 56 

currency format, 1073 

Decimal Format class, 1074 

example of, 1074-1077 

locale dependence of, 1071 

NumberFormat class, 1072 

NumberFormatDemo.java, 1074-1077 

parsing numbers, 1073 

percent format, 1073 

plain number format, 1072-1073 
Numeric data types, 32-37 
Numeric errors: 

avoiding, 1313 

minimizing, 130-131 
Numeric keypad, 5 
Numeric literals, 35-36 
Numeric operators, 33-35 

on characters, 47 
Numeric types: 

conversions, W-A2 

range of, 41 

Numeric values, converting to strings, 309-310 
Numeric wrapper classes, 477-478 

abstract methods implemented by, 478 
numOfCredits attribute, 1276, 1278, 1280, 1282 

O 

Oak language, 8 
Object class, 384 

cl one method, 471 

equal s method, 384, 477 

toString method, 384 
Object I/O, 662-666 

TestObjectlnputStream.java, 663-664 

TestObjectOutputStream.java, 663 
Object member access operator ( . ), and casting 

operator, 389 
Object serialization, 664 
ObjectlnputStream class, 662-663, 
1031-1033, 1036 

readObject method, 1033, 1036 



ObjectOutputStream class, 1031-1033, 1036 

writeObject method, 1033 
Objects: 

anonymous, 272 

array of, 287-289 

behavior of, 264 

calling, 271 

defined, 264 

object reference variables vs., 271 
passing to methods, 286-287 
processing primitive data type values as, 

476^179 
state of, 270 
Occurrences of letters, counting (case study), 
212-215 

CountLettersInArray.j ava, 213-215 
Occurrences of words (case study), 755-756 
Octal numbers, 35, 720 
ODBC, 1287, 1289 
Off-by-one error, 203 
offer method, Queue interface, 748 
openlcon property, 1266 
openStreamO method, 1037 
Operands, converting, 41 
operandStack, 847-848, 851 
Operating system (OS), 7-8, 14 

defined, 7 

scheduling operations, 8 

system activities, controlling/monitoring, 7 

system resources, allocating/assigning, 8 
operationMenu menu, 1156 
Operator associativity, 97-98 
Operator precedence, 97-98 
Operator precedence chart, 97-98, 1314—1315 
operatorStack, 847-851 
Option buttons, See Radio buttons 
Option dialog, 1168-1169 

defined, 1168 
or operator, 1283 
Oracle, 1278 

JDBC driver, 1287-1289 

URL, 1289 
Order by comparator, 735 
orientation property, 1160 
OuterClass class, 541 
Output stream, defined, 650 
OutputStream class, 653, 659 
Ovals, drawing, 501-505 
Overflow, 33 

Overloaded constructors, 270 
Overloading methods, 168-170 

TestMethodOverloading.java, 169-170 
Overriding: 

methods, 382-383 

prevention of, 396 

P 

packO method, 544, 586 
Package-access, 282 
Package-private, 282 
Packages, using, 16, 282 
Packet-based communications, 1018 
Page Up/Page Dn keys, 5 
paintComponent method, 499-500, 505, 516, 
520-521, 523 
invoking, 505 

TestPaintComponent.java, 500-501 
Palindromes, checking (problem), 310-31 1 



Index 1337 



Panels, using as subcontainers, 417—419 

TestPanels.java, 417^19 
Parallel edges, 894 
Parameter list, 157, 169 
Parameter order association, 162 
Parameters, methods, 157 
Parent classes, See Superclasses 
parse method, 1073 

parseDoubl e method, Doubl e class, 478 
parselnt method, Integer class, 478 
Parsing numbers, 1073 
Partition: 

illustration, 799 

method, 799-800 
Pascal, 6 

Pass-by-sharing, 209, 287 
Pass-by- value, use of term, 163 
Passing arrays to methods, 209-212 

TestPassArray.java, 211-212 
Passing parameters by values, 162-165 

Increment. java, 163 

TestPassByValue.java, 163-165 
peek method: 

Queue interface, 748 

Stack class, 747 
Percent format, 1073 
Pixels, 5, 498, 500 
Plain number format, 1072-1073 
Plus sign {+), 26 

PNG (Portable Network Graphics), 422 
Point class, 552, 694 
pol 1 method, Queue interface, 748 
Polygons/polylines, drawing, 507-510 

DrawPolygon.java, 509-510 
poly Line method, 528 
Polymorphism, 384-385 

defined, 384 

dynamic binding, 385-387 

generic programming, 388 

matching vs. binding, 387 

PolymorphismDemo.java, 385 
popO method, MyStack.java, 394 
pop() method, Stack class, 747 
Popup menus, 1 156-1 158 

popup triggers, 1156 

PopupMenuDemo.java, 157-1158 
Postdecrement operator, 40 
Postincrement operator, 40 
Postorder traversal, 861, 
Postorderlterator class, 891 
postorderlteratorO method, 861 
pow(a, b) method, 37, 172 
Precedence, 97 
Predecrement operator, 40 
Predefined Tenderers and editors, 1242-1245 
preferredSize property, 1242 
Preincrement operator, 40 
Preorder traversal, 861-862, 864, 866 
Preorderlterator class, 880 
preorderlteratorO method, 880 
presentNation(index) method, 637 
Pressed icons, 572-573 
Primary key, 1276-1278 
Primary key constraints, 1277 
Prime number algorithms, comparisons of, 783 
Prime numbers 

displaying (problem), 137-139 

finding (case studies), 774-783 

EfficientPrimeNumbers.java, 780-782 
PrimeNumbers.java, 778-780 
SieveOfEratosthenes.java, 782-783 



PrimeNumber.java, 138-139 
PrimeNumberMe thod.j ava, 1 66- 1 67 
Primitive data types, 25 

Prim's minimum spanning tree algorithm, 950-951 
print method, 326 

print! n method compared to, 28 
pr i nt Ad j acencyMat r i x () method, 
AbstractGraph class, 902 
PrintCalendar.java, 181-183 
PrintChar class, 975 
printEdgesO method, AbstractGraph 

class, 902 
PrintNum class, 975 
printPath(v) method, Tree class, 902 
printTree() method, Tree class, 902 
PrintWri ter class, writing data using, 325, 650 
Priority queues, 846-847 

MyPriorityQueue class, 846 

MyPriorityQueue.java, 846 

TestPriorityQueue.java, 847 
PriorityBlockingQuei . 99S 
PriorityQueue class, 749-750 
PriorityQueueDemo.java, 750 
private constructor, 283 
Private constructor, 362 
Private data fields, 344, 376, 379 
private modifier, 282-283, 363, 395, 1316 
Procedures, 157 
process method, 1010 
processEvent method, 1099-1100, 1094 
Processing arrays, 201-203 
Producer/Consumer (case study), 995-997 

ConsumerProducer.java, 996-997 
Programming errors, 53-55 

debugging, 54-55 

logic errors, 54 

runtime errors, 54 

syntax errors, 53 
Programming style, 51-53 

defined, 5 1 
Programs, 5-7, 

creating/compiling/executing, 1 3-1 6 
ProgressB arDemo .j ava 1 008- 1010 
Properties, 264 
Property default values, 422 
Protected data fields, 825 
protected modifier, 282, 396, 1316 
Pseudocode, 24, 106 
publ ic modifier, 274, 282, 396, 1316 
publish method, 1010 
publ ishPrimeNumbers, 1010 
pushO method, Stack class, 747 
push(Object element) method, MyStack.java, 

393-394 
put method, Map interface, 750 
putAll method, Map interface, 750 

Q 

Quadratic algorithm, 768 

Quadratic time, 768, 771 

Queue classes, designing, 843-844 

Queue interface, 748 

Queues, defined, 843 

Quick sort 

algorithm (listing), 797-798 

defined, 797 

illustration, 798 

merge sort vs., 801 

partition method, 800 



partitioning, 798-800 

quick sort time, 800-801 

QuickSort.java, 798-800 
quicksort methods, 798 
Quotient.java, 432 

Quotient WithException.java, 433^-34 
QuotientWithlfjava, 432^133 

R 

Race condition, 987 
Radio-button menu items, 1151 
Radio buttons, 581-583 
defined, 581 

RadioButtonDemo.java, 582-583 
radius data field, 264 
radius property, 285 
Radix, decimal number system, 1319 
Radix sort, 807 
Ragged array, 238 
RAM (random-access memory), 3 
Random access files, 666-668 

defined, 666 

and processing of files of record, 668 
TestRandomAccessFile.java, 667-668 
Random class, 275 

randomO method, Math class, 82, 92 

Random numbers, generating (case study), 175-176 

RandomCharacter.java, 175-176 

TestRandomCharacter.java, 176 
RandomAccessFil e class: 

defined, 666 

UML diagram, 666 
Rational class, 483^87 

limitations of, 487 

overflow, 487 

properties/constructors/methods, 483 

Rational Java, 484^486 

TestRationalClass.java, 483^84 
Rational Matrixclass, 722 
RationalMatrix.java, 722 
Raw type, 713-714 

and backward compatibility, 713 
Maxl.java, 714 
Max.java, 713 
Read-only property, 1094 
Read-only streams, 757 
ReadFileUsingJFileChooser.java, 329-330 
readObjectO method, 666, 

ObjectlnputStream class, 1031-1033 
Rectangle class, 375, 377-378 

Rectangle 1. java, 378 
, TestCircleRectangle.java, 379 
Rectangle. java, 460 
Rectangles, drawing, 501-502 
Recurrence functions, 760 
Recursion, 678-698 

advantages of, 697 

defined, 678 

directory size, finding (problem), 687-688 
Eight Queens puzzle, 695-697 
defined, 695 

EightQueens.java, 695-697 
factorials, computing, 678-681 
base case, 678 

ComputeFactorial.java, 679-680 

stopping condition, 678-679 
Fibonacci numbers, computing (problem), 

681-683 
fractals (problem), 692-695 
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Recursion (continued) 

Sierpinski triangle, 692 

SierpinskiTriangle.java, 692-695 
infinite, 679 
iteration vs., 697 
overhead, 697 

and performance concern, 697 
problem solving using, 683-684 

RecursivePalindromeUsingSubstring.java, 
684 

recursive helper methods, 684-687 
binary search, 686-687 
RecursivePalindrome.java, 684-685 
selection sort, 685-686 

Tower of Hanoi (problem), 688-691 
Recursive call, 678 
Recursive methods, 678 
Recursive thinking, 683 
RecursivePalindrome.java, 684-685 
RecursivePalindromeUsingSubstring.java, 684 
RecursiveSelectionSort.java, 685-686 
ReentrantLock class, 989 
Reference type, defined, 271 
Reference variables: 

accessing an object's data and methods, 271-272 

accessing objects via, 270-274 

Circlel.java, 267-268 

defined, 270 

reference data fields and the null value, 272-273 

and reference types, 273-274 

TestC irclel.java, 266-267 

variables of primitive types and reference types, 
differences between, 273-274 
regionMatches method, String class, 304 
Register listener, 536 
Regular expression, 307 
Relational database systems, 1274—1278 

attributes, 1275 

integrity, 1274 

integrity constraints, 1276-1278 

language, 1274 

relational data model, 1274 

structure, 1274 

tables, 1275 

tuples, 1277 
Relational operators, 72 
Relational structures, 1275-1276 
Relative file name, 324 
release() method, Semaphore class, 1001 
Remainder (%), 33-34 
remove method: 

Map interface, 751-754 

Queue interface, 748 
remove C) method, Iterator interface, 880 
removeActionListener method, 1099 
removeCol umn method, Tab! eCol umnModel , 
1242 

removeFirstO method, MyLinkedList 

class, 836-837 
remove(index) method, MyLinkedList 

class, 838-839 
removeLastO method, MyLinkedList 

class, 837-838 
removeRow(rowIndex) method, 1242 
reorderi ngAll owed property, 1235 
repaint method, Component class, 505 
replaceAll method, String class, 307-308 
replaceFirst method, String class, 307-308 
ReplaceText.java, 329 
Replacing strings, 307 



requestFocusInWindowO method, 586 

Reserved words, 1 1 

Resolution, 5, 409 

Resource bundles, 1077-1084 

for the Chinese language (example), 1080 

defined, 1077 

for the English language (example), 1079 
for the French language (example), 1080 
getBundle method, 1079 
Li stResourceBundl e class, 1077-1078 
MissingResourceException, 1079, 1084 
naming conventions, 1078 
property resource bundles, 1084 
ResourceBundle class, 1077-1078, 1084 
ResourceBundleDemo.java, 1080-1084 
updateString method, 1084 

Resource ordering, 1001-1002 

ResourceBundl e class, 1084 

ResultSetMetaData interface, 1300, 1302 

Rethrowing exceptions, 447 

return statement, 158-161 

Return value type, methods, 157 

Reusing methods, 160, 379 

revalidateO method, 1132, 1164 

reverse method, Collections class, 743 

RGB model, 419 

Right-associative operators, 98 

Right child of a node, 872 

Right subtree, 872 

rightAction, MyActi on class, 1164 
Rigid area, 1119 
rollbackO method, 1292 
Rollover icons, 572-573 
Rounding methods, Math class, 173-174 
RowFil ter class, 1235 
Rows/columns, modifying (case study), 
1237-1242 

Add New Column button, 1238, 1242 

Add New Row button, 1237, 1242 

Clear button, 1238, 1242 

Delete Selected Row button, 1238, 1242 

ModifyTable.java, 1238-1242 

Restore button, 1238, 1242 

Save button, 1238, 1242 
rows property, GridLayout manager, 413, 415 
rowSorter method, JTable class, 1235-1237 
Runnabl e interface, 972-973 
Runnable object, 972, 975, 979, 984 
Runtime errors, 54 
RuntimeException, 730, 1003 

S 

SalesTax.java, 42 

InputMismatchException, 327 
Scientific notation, 36 
Scope of variables, 171-172 
Screen resolution, 5 
Scroll bars, 596-599 

JScrol 1 Bar class, 596 

ScrollBarDemo.java, 598-599 
ScrollMap.java, 1130-1132 
searchO method, Stack class, 747 
Search word problem, 678 
search(Object element) method, 

MyStack.java, 393 
sel ectedFi 1 e property, JFil eChooser 

class, 1177 
selectedFiles property, JFileChooser 
class, 1177 



Selection sort, 219-220, 685-686 
defined, 219, 685 

RecursiveSelectionSort.java, 685-686 

SelectionSort.java, 220 
Selection sort algorithm, 770, 792 
Selection statements, 72, 81-82 
sel ectionMode method, 593, 1206-1027 
sel ectionMode property, 1206 
selectionModel property, 1206 
Selections, 72-100 
Semaphore class: 

acquireO method, 1000-1001 

class diagram, 1001 

releasee) method, 1000-1001 
Semaphores, 1000-1001 
Semicolon (statement terminator), 1 1-12 
Sentinel value, 122 
SentinelValue.java, 123-124 
SentinelValueUsingConfirmationDialog.java, 140 
Serial izabl e interface, 664-665, 1032, 
1126, 1209 

serializing arrays, 665-666 

TestObjectStreamForArray.java, 665-666 
Serial izabl e objects, defined, 664 
Serialization, 664 
Server class, 1024 
Server.java, 1021-1024 
Set interface, 730 
setAccelerator method, 1152 
setAl ignment method, FlowLayout 

manager, 417 
setAutoCommit(false) method, 1292 
setBackground method, Component class, 

419,516 
setBorder method, 1152 
setCol or method, 503, 1 194 

Graphics class., 516 
setColumns method, GridLayout manager, 417 
setComponentPopupMenuQPopupMenu) 

method, 1158 
setDefaultCloseOpeartion method, JFrame 

class, 276 
setEdi tor method, 1202 
setFi lied method, 1194 
setFont method: 

Component class, 419, 516 

Graphics class, 516 
setHgap method: 

BorderLayout manager, 417 

FlowLayout manager, 417 

GridLayout manager, 417 
setHorizontalTextPosition method, 1 152 
set JMenuBar method, 1150 
setLayout method, 418^119 
setlengthO method, StringBuilder, 317-318 
setLocation method, JFrame class, 276 
setLocationRel ativeTo(null ), 409 
setMaximumFractionDigits method, 

NumberFormat class, 1073 
setMinimumFractionDigits method, 

NumberFormat class, 1073 
setModel method, CircleView class, 1194 
setPage(url) method, 1039 
setPriority method, 977 
setRadi us method, 285, 1194 
setRows method, GridLayout manager, 417 
Sets, 730-737 

compared to lists, 746 

HashSet class, 730 

LinkedHashSet class, 734-735 
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and nonduplicate elements, 738 

performance of, 745-746 

SetListPerformanceTest.java, 745-746 

TesfHashSet.java, 732 

TestLinkedHashSet.java, 734-735 

TestMefhodsInCollection.java, 732-734 

TestTreeSet.java, 735-736 

TreeSet class, 735-736 
setSi ze method, JFrame class, 276, 409, 544 
setSize(w, h) method, 409 
Setter method, 284 
setTi tie method, 413 

JFrame class, 276, 408^109 
setVgap method: 

BorderLayout manager, 417 

FlowLayout manager, 417 

GridLayout manager, 417 
setVi si ble method, JFrame class, 276 
setVisibleRowCount method, 1209 
Seven Bridges of Konigsberg problem, 892-893 
Shallow copy, 473 
Short-circuit operator, 90 
short type, 27 
Shortest-path tree, 958 
Shortest paths, 955-965 

algorithms, 955-958 

implementation of, 958-962 

ShortestPathTree class, 958 

TestShortestPath.java, 960-962 
Shorthand operators, 39 — 41 
ShowBoxLayout.java, 1119-1121 
ShowCardLayout.java, 1 1 16-1 118 
showConfirmDialog method, 1167 
ShowCurrentTime.java, 43^44, 274 
showDayNames method, 1070 
showDays method, 1070 
ShowDiagonalLayout.java, 1 127-1 128 
ShowGridLayout.java, 414^4-15 
showHeader method, 1070 
showInputDialog method, 55, 57, 1168 
ShowLayout.java, 1134-1136 
showMessageDialog method, JoptionPane 

class, 16 
ShowNoLayout.java, 1122-1123 
showOpenDialog method, JfileChooser class, 

1177, 1180 
showPopup method, 1158 
showSaveDialog method, JfileChooser class, 
1177, 1181 

shuffle method, Collections class, 746 
Sierpinski triangle, 692-694 

creation of, 692 

defined, 692 

SierpinskiTriangle.java, 692-694 
Point class, 694 
Sieve of Eratosthenes algorithm, 781-783 
SieveOfEratosthenes.java, 782-783 
signal O method, 991, 994 
signal All () method, 991, 994 
Simple graphs, 894 

SimpleDateFormat class, 1062, 1070 
SimpleSpinner.java, 1198 
SimpleTreeDemo.java, 1253-1254 
Single inheritance, 379, 473 
Single precision, 33 

Single selection mode, 593, 1209, 1260 
Single-source all-shortest-path tree, 958 
Single space, 52 

size method, Map interface, 752 
Sliders, 599-602 



JSlider class, 599 
SliderDemo.java, 600-602 
SoftBevel Border class, 1137-1138 
Software, 2, 5-7, 14 

defined, 5 
Sorted tuples, displaying, 1285-1286 
SortedMap interface, 752 
SortedSet interface, 735 
Sorting, 792-816 

bubble sort, 792-794 
algorithm (listing), 793 
bubble sort time, 794 
BubbleSort.java, 793-794 
defined, 793 

improved algortithm (listing), 793 
bucket sort, 807-809 

algorithm (listing), 807-809 

stability of, 807-808 
defined, 792 
external sort, 809-816 

analysis, 816 

copying first half segments (listing), 8 1 2 
CreateLargeFile.java, 809-811 
creating initial sorted segments (listing), 811 
defined, 809 

merging all segments (listing), 812-813 

merging two segments (listing), 812-813 

phase I, implementation of, 811 

phase II, implementation of 811-812 

sort phases, defined, 809 

SortLargeFile.java, 813-816 

two phases, combining, 812-813 
heap sort, 801-807 

HeapSort.java, 806-807 

merge sort vs., 807 

sort time, 807 
lower bound on sort, 807 
merge sort, 794—797 

algorithm (listing), 795-796 

illustration, 795 

merge sort time, 796-797 
method 796-797 
quick sort, 797-801 

algorithm (listing), 797-798 

defined, 797 

illustration, 798 

merge sort vs., 801 

partition method, 799 

partitioning, 798-800 

quick sort time, 800-801 

QuickSort.java, 798-799 
radix sort, 807-809 
reasons for studying, 793 
SortLargeFile.java, 814-815 
Source components, 1095 
Source file, 7, 14 

Source object (source component), 469 
Source program (source code), 6-7, 14 
Spacing, 52-53 
Spanning tree, 949 

Special characters, escape sequences for, 46 

Special floating-point values, 438 

Specific import, 17 

Specifier, 96-97 

Speed, CPU, 3 

Spinner, defined, 1196 

Spinner editors, 1201-1204 

JSpinner.DateEditortor, 1201 
JSpinner.DefaultEditor, 1201 
JSpinner.ListEditor, 1202 



JSpinner.NumberEditor, 1201 

SpinnerModelEditorDemo .j ava, 1 202- 1 204 

using, 1202-1204 
Spinner models, 1198-1201 

SpinnerModelEditorDemo .j ava, 1 202- 1 204 

using, 1202-1204 
SpinnerDateModel, 1198-1199, 1201, 1204 
SpinnerListModel 1198-1200, 1204 
SpinnerModel interface, 1198 
SpinnerNumberModel, 1198, 1200, 1204 
spinnerYear, 1204 
Splash screen, 424 
spl it method, String class, 307 
Splitting strings, 307-308 
SQL, See Structured Query Language (SQL) 
sqrt method, 173 
Stack class, 746-748 

emptyO method, 747 

peek() method, 747 

popO method, 747 

push() method, 747 

search () method, 747 
Stack classes, designing, 747 
StackOflntegers class, 358-359 

StackOflntegers.java, 359 

TestStackOflntegers.java, 358-359 

UML diagram, 358 
Stacks, 160, 357 

defined, 746 

TestStackQueue.java, 845-846 
start method, Applet class, 620 
Start tag, 616 
startAngle, 506 
Starvation, 978 
State, of objects, 264 
Statement, 1 1 

Statement interface, 1288, 1295 
Statement terminator, 1 1 
static inner class, 542 
Static methods, 278 

hidden, 383 
static modifier, 1316 
Static variables, 278-281, 345 

Circle2.java, 279 

TestCircle2.java, 279-281 
Stepwise refinement, 177 
Still Clock class, 516-520, 559 

DisplayClock.java, 516-518 

StillClockjava, 518-520 

UML diagram, 517 
stop method, Appl et class, 620 
Stopping condition, 678 
Storage devices, 2, 4 
Stream-based communications, 1018 
Stream, defined, 650 
Stream sockets, 1020 

Strict mode, floating-point arithmetic, 1311 
strictfp keyword, 1311 
strictfp modifier, 1217 
String class, 302-313 

characters, 302 

combining strings, 305-306 

compareTo method, 304 

as immutable class, 344 

methods for comparing strings, 303-304 

string length, 305-306 
String concatenation operator, 26 
String literal, 45 
String type, 50-5 1 
StringBuf fer class, 315-320, 362 
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StringBuilder, 318 
StringBuilder class, 315-320, 362 

capacityO method, 318 

charAt(index) method, 318 

constructors, 316 

initial capacity, 318 

length () method, 318 

methods for modifying string builders, 316-317 
setl ength method, 317-318 
Strings: 

calculator (problem), 321-322 
characters, finding in, 308-309 
CheckPalindrome.java, 310-311 
command-line arguments, 320-322 
comparisons, 304-305 
constructing, 302 

conversion between arrays and, 309 
converting, 307 

converting characters and numeric values to, 

309-310 
converting to numbers, 56 
immutable, 302-303 
index range, 305 
interned, 302-303 
matching, by patterns, 307-308 
PalindromelgnoreNonAlphanumeric.java, 

319-320 

palindromes, checking (problem), 310-311 
palindromes, ignoring nonalphanumeric 

characters when checking (problem), 

318-320 

passing to the main method, 320-321 

replacing, 307-308 
by patterns, 308 

splitting, 307-308 
by patterns, 308 

string literal, 45, 305 

string literal object, 302 

string object, 302 

string value, 302, 305 

string variable, 302 

substrings: 

finding in, 308-309 
obtaining, 306 
Strong is-a relationship, 475 
Structure component, relational database 

systems, 1232 
Structured Query Language (SQL), 1278-1286 

arithmetic operators, 1284-1285 

between- and operator, 1284 

Boolean operators, 1282-1283 

from clause, 1282 

column alias, 1284 

comparison operators, 1282-1283 

creating a database, 1279-1280 

creating a user account on, 1278-1279 

creating and dropping tables, 1280-1281 

defined, 1278 

delete records, 1281-1282 

distinct tuples, displaying, 1285 

inserting records, 1281-1282 

is null operator, 1284 

1 ike operator, 12831 

select clause, 1282 

simple queries, 1282 

standard SQL, 1278 

tables, joining, 1286 

updating records, 1281-1282 
Strut, 1119 
Stubs, 179-180 



Student class, 272, 344, 386-387 

Student table, joining Enrollment table and, 1286 

StudentAddress.java, 1032-1033 

StudentClient.java, 1033-1035 

StudentServer.java, 1035-1036 

Subinterface, 474 

Subproblem, 139 

substring method, String class, 306 
Substrings: 

finding in a string, 308-309 

obtaining, 306 
Subtraction (-), 33 
SubtractionQuiz.java, 83-84 
SubtractionQuizLoop.java, 1 2 1-1 22 
Subtype, 384 
Subwindows, 602 

Sudoku game, developing an applet for, 614 
Sudoku (problem), 244-248 
Sun Java Website, 9-10 
super keyword, 380-382 

constructor chaining, 380-382 

superclass constructors, 380 

superclass methods, calling, 382 
Superkey, 1277 
Supertype, 384-385 
Supplementary Unicode, 45, 651 
Swing: 

AWT vs., 406 

components, 406 
Swing borders, 1136-1144 

and Border interface, 1 136 

BorderDemo.java, 1140-1144 

defined, 1136 
Swing container structures, 1 112-1 1 14 

DApplet class, 1113-1114 

JFrame class, 1113 

JPanel class, 1114 
Swing GUI components, 420-421, 572, 575 

common features of, 420—421 

TestSwingCommonFeatures.java, 421—422 
Swing MVC architecture, 1195-1196 
SwingUtilities class, 979 
SwingWorker class, 1004-1007, 1010 

class diagram, 1004 

defined, 1004 

and GUI, 1007 

Swing WorkerDemo.java, 1005-1007 
switch statements, 74, 93-94 

and break statement, 94 
Sybase, 1274, 1278 
Synchronization using locks, 989-991 
Synchronization wrapper, 1003 
Synchronized block, 988 
Synchronized collections, 1002-1003 

defined, 1002 
synchronized keyword, 987-988, 994, 

1003, 1311 
synchronizing statements, 988-989 
synchronized methods, 988 
synchronized modifier, 1317 
Syntax errors, 53 
Syntax rules, 12 
System errors, 438 

System. currentTimeMill is(), 37 
System, out. print"! n, 11-12 

T 

Table model events, 1247-1250 
Table renderers and editors, 1242 



custom, 1245-1247 
MyTableModel.java, 1243-1244 
predefined, 1242 

TableCellRendererEditorDemo.java, 1244 
TableCell Editor interface, 1226 
TableCell Renderer interface, 1226, 1245 
TableCellRendererEditorDemo.java, 1244 
tabl eChanged method, Tabl eModel Li stener, 
1250 

TableColumn, as supporting class, 1226 
TableColumn class, 1226, 1233-1234 

properties/constructors/methods, 1233-1234 
Tabl eCol umnModel interface, 1233 

TestTableColumnModel.java, 1234-1235 
TableEventsDemo.java, 1247-1250 
tabl eHeader property, 1235 
TableModel interface, , 1231-1233 

and table data management, 1233 
Tabl eModel Events, 1231 
TablePropertiesDemo.java, 1229-1231 
Tables, joining, 1286 

Tables, relational database systems, 1275-1276 

Tag, defined, 616 

Tag name, defined, 616 

Tapes, 4 

Target node, 920, 923 
Tasks: 

creating, 972-973 

defined, 972 

TaskThreadDemo.java, 974-975 
run() method, 974 
start C) method, 974 
TaskThreadDemo.java, 974-975 

run() method, 974 

start () method, 974 
Taxes, computing (problem), 85-88 
TCP (Transmission Control Protocol), 1018 
Ternary operator, 95 
TestArrayAndLinkedList.java, 741-742 
TestArrayList.java, 390-392 
TestBFS.java, 917-918 
TestBinaryTreeDelete.java, 874-875 
TestBinary Tree Java, 869-870 
TestBinaryTreeWithlterator.java, 880-88 1 
TestBreak.java, 135-136 
TestButtonlcons.java, 573-576 
TestCalendar.java, 463-465 
TestCallableStatement.java, 1299 
TestCenterMessage.java, 511-512 
TestCirclel.java, 266-267 
TestCircle2.java, 279-280 
TestCircle3.java, 285-286 
TestColorDialog.java, 1174 
TestContinue.java, 136 
TestCourse.java, 356 

TestCourseWithActionEvent.java, 1 100-1 101 
TestCourseWithEnrollmentEvent.java, 1 104-1 105 
TestDatabaseMetaData.java, 1301 
TestDFS.java, 914-915 
TestDoWhile.java, 125-126 
TestEdible.java, 465-466 
TestFileClass.java, 324-325 
TestFrame.java, 276 
TestGeometricObject.java, 461^-62 
TestHashSet.java, 732 
Testlmagelcon.java, 423 
TestlntegerMatrix.java, 722-723 
TestLinkedHashSet.java, 734-735 
TestList.java, 829-830 
TestLoanClass.java, 348-349 
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TestMap.java, 754 
TestMax.java, 158-160 
TestMethodOverloading.java, 169-170 
TestMethodsInCollection.java, 732-734 
TestMinimumSpanningTree.java, 953-954 
TestObjectlnputStream.java, 663-664 
TestObjectOutputStream.java, 663 
TestObjectStreamForArray.java, 665-666 
TestPaintComponent.java, 500 
TestPanels.java, 417^119 
TestPassArray.java, 211-212 
TestPassByValue.java, 163-165 
TestPassObject.java, 286-287 
TestPriorityQueue.java, 847 
TestQueue.java, 749 
TestRandomAccessFile.java, 667-668 
TestRandomCharacter.java, 176 
TestRationalMatrix.java, 723 
TestResultSetMetaData.java, 1303 
TestShortestPath.java, 960-961 
TestStackOflntegers.java, 358-359 
TestStackQueue.java, 845 
TestSum.java, 130-131 
TestSwingCommonFeatures.java, 421^122 
TestTableColumnModel.java, 1234-1235 
TestTable.java, 1228 
TestTableModel.java, 1231-1232 
TestTableSortFilter.java, 1236-1237 
TestTreeModel.java, 1255-1256 
TestTreeSet.java, 735-736 
TestTreeSetWithComparator.java, 738 
TestVoidMethod.java, 160-162 
TestWeightedGraph.java, 947-948 
TestWindowEvent.java, 549-551 
Text areas, 586-589 

DescriptionPanel.java, 587-589 

TextAreaDemo.java, 589 
Text fields, 584-586 

defined, 584 

TextFieldDemo.java, 585-586 
Text I/O, binary I/O vs., 650-652 
Text I/O classes, 650 
TextAreaDemo class, 587-588 
TextEditor.java, 1177-1181 

open method, 1 1 80 

save method, 1181 
Think before coding, use of term, 1 1 8 
this keyword, 346 
this(arg-list) statement, 347 
Thread class, 975-978 

class diagram, 975 

extending, 976 

join method, 977 

methods, 975 

resumeO method, 976 

si eep method, 976-977 

stopO method, 976 

suspendO method, 976 

yieldO method, 976 
Thread cooperation, 991-995 

ever-waiting, 994 

Java's built-in monitor, 994-995 

ThreadCooperation.java, 992-994 
Thread-safe class, 987 
Thread states, 1002 
Thread synchronization, 985-989 

AccountWithoutSync.java, 985-987 
Account class, 986-987 
AddAPennyTask class, 986 
and data inconsistency, 987 
isTerminatedQ method, 986 



Threads: 

Blocked state, 1002 
concurrent, 975 
cooperation among, 991-994 
creating, 972-973 
defined, 972 

interruptO method, 1002 
isAliveO method, 1002 
New state, 1002 
Ready state, 1002 
Running state, 1002 
separating tasks from, 975 
starting, 973 
Thread class, 975-978 
class diagram, 975 
extending, 976 
join method, 977 
methods, 975 
resumeO method, 976 
si eep method, 976-977 
stopO method, 976 
suspendO method, 976 
yieldO method, 976 
time sharing, 972 
timers vs., 979 
Throwable class, 438, 442 
Throwing exceptions, 440 
throws Exception, 326-327 
TicTacToe game (case study), 628-632 
TicTacToe.java, 629-632 
TicTacToeCI ient class, 1043 
TicTacToeClient.java, 1047-1052 
TicTacToeConstants class, 1042 
TicTacToeConstants interface, 1052 
TicTacToeConstants Java, 1043 
TicTacToeServer class, 1043 
TicTacToeServer.java, 1043-1047 
Time sharing, 972 

Timer class, animation using, 557-560 

AnimationDemo.java, 558-559 

ClockAnimation.java, 559-560 
Timers, threads vs., 979 
TimeZone class, 1060-1061 
TitledBorder class, 1138, 1144 
toCharArray method, 309 
Toggle button, 578 
Token-reading methods, 327 
toLowerCase method, Character class, 314-315 
Tooltip, 420-421, 577 
Toolbars, 1158 
Top-down design, 177-179 
toString method: 

Date class, 274-275 

GeometricObject class, 382-383 

MyStack.java, 393-395 
TotalArea.java, 288-289 
tollpperCase method, Character class, 307 
Tower of Hanoi (problem), 688-691 

analyzing, 771 

defined, 688 

TowersOfHanoi.java, 690-691 
transient keyword, 664 
transient modifier, 1317 
Transmission Control Protocol (TCP), 1018 
Traversals: 

graphs, 911-912 

trees, 861-863, 875 
Tree class, 885, 911-912, 914, 916, 951-954, 960 

class diagram, 912 
Tree events, 1267 



Tree interface, 862, 911 

TreeMap, 751-752, 754-756 

Tree node rendering and editing, 1265-1267 

Tree sets, 735-737, 738 

Tree traversal, 861-863 

breadth-first traversal, 861, 863 

depth-first traversal, 861 

inorder traversal, 861, 869, 875 

postorder traversal, 861-862, 866, 869-870 

preorder traversal, 861, 863, 866, 869-870, 875 

Tree visualization, 876-879 
DisplayBinaryTree.java, 876 

TreeCellRenderer interface, 1265 

treeCol lapsed, 1267 

TreeExpansionEvent, 1267 

TreeExpansionListener, 1267 

treeExtended, 1267 

Tree.java, 863-864 

TreeMap class, 752 

TreeModel class, 1251 

TreeModel interface, 1254-1256 

TreeNode class, 1251, 1255-1256, 1257-1258 

TreeNodeDemo.java, 1256-1259 

TreePath class, 1251, 1259-1262 

Trees: 

binary search trees, 858-870 
deleting elements in, 870-876 

defined, 858 

iterators, 879-881 
TreeSelectionEvent, 1267 
TreeSelectionListener interface, 1267 
TreeSelectionModel interface, 1251, 1259-1260 
TreeSet class, 730, 735-738, 898 
Trigonometric methods, Math class, 172 
Truncation, 41 

try-throw-catch block, template for, 434 
Tuples, 1277 

distinct, displaying, 1285 

sorted, displaying, 1285 
Two-dimensional arrays, 236-248 

closest pair, finding (problem), 242-244 

creating, 236-237 

declaring variables of, 236-237 

multiple-choice test, grading (problem), 
241-242 

obtaining the lengths of, 237 

processing, 238-240 

ragged array, 238 

Sudoku (problem), 244-248 
Type casting, 31, 41 

defined, 41 

explicit casting, 4142 
implicit casting, 47, 387 
and loss of precision, 49 
syntax for, 41 
Type erasure, 716 

U 

UDP (User Datagram Protocol), 1018 
UML (Unified Modeling Language): 

class diagram, 265 

notation, 265 
Unary operator, 35 
Unbounded wildcard, 715 
Unboxing, 481 
Unchecked exceptions, 439 
Underflow, 33 
Unicode, 45, 1058 

supplementary, 45, 651 
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Unix epoch, 43 

Unmodifiabl eCollection class, 757 
Unmocli fiabl eLi st class, 757 
Unmocli f iabl eMap class, 757 
Unmodi f iabl eSet class, 757 
Unmocli f iabl eSortedMap class, 757 
Unmodi f iabl eSortedSet class, 757 
UnsupportedOperationException, 730 
Unweighted edges, 893 

UnweightedCraph class, 898-900, 902, 908-909, 

940, 942 
updateDateO method, 1204 
updateString method, 1084 
URL class, 632-633 

DisplaylmagePlayAudio.java, 634 
DisplaylmageWithURL.java, 633 
USB flash drives, 4 
UseGuessDateClass.java, 360-361 
User actions, source object and event type, 534 
User Datagram Protocol (UDP), 1018 
User interfaces: 
buttons, 572-578 

AbstractButton class, 572-573 
alignments, 574 
ButtonDemo.java, 576-578 
defined, 572 
icons, 572-574 
pressed icons, 572-573 
rollover icons, 572-573 
TestButtonlcons.java, 573-574 
text positions, 575 
using, 575-578 
check boxes, 578-581 

CheckBoxDemo.java, 579-581 
toggle button, 578 
combo boxes, 590-593 

ComboBoxDemo.java, 591-593 
defined, 590, 1216 
JComboBox class, 590 
creating, 572-606 
labels, 583-584 
lists, 593-596 

multiple windows, creating, 602-606 
radio buttons, 581-583 
defined, 581 

RadioButtonDemo.java, 582-583 
scroll bars, 596-599 

JScrol 1 Bar class, 596-597 

ScrollBarDemo.java, 598-599 
sliders, 599-602 

JSlider class, 599,602 

SliderDemo.java, 600-602 
text areas, 586-589 

DescriptionPanel.java, 587-589 

TextAreaDemo class, 586 

TextAreaDemo.java, 585-586 
text fields, 584-586 

defined, 584 

TextFieldDemo.java, 585-586 
UTF-8 format, 657 

V 

validate method, 1223-1224 
Value-returning method, 157-158, 317 
val ueChanged method: 

ListSelectionListener, 1250 



TreeSelectionListener interface, 1267 
val uelsAdjusting method, 1207 
val ueOf method, Stri ng class, 309, 478 
val ues O method, Map interface, 752 
VarArgsDemo.java, 215-216 
Variable-length argument lists, 215-216 
Variables, 27 

class's, 345 

control, 127 

declarations, 30 

delaring/initializing in one step, 30 

indexed, 198, 200 

instance, 271, 278, 280-281, 346 

local, 171, 272, 345, 396, 697 

naming, 30, 52 

scope of, 171, 345-346 

static, 278-281, 345-346, 665 

used as expressions, 31 
Vector class, 746-748 

methods, 747 
Vertical alignment, 573-574, 584 
Vertical text position, 575 
vertices data field, 910 
vgap property: 

Border Layout manager, 417, 1114 

FlowLayout manager, 417 

GridLayout manager, 417 
ViewRemoteFile.java, 1038-1039 
Views, 1188 

Vi rtual Machi neError class, 437^138 
Visibility, changing of, 396 
Visibility modifiers, 282-283, 395 
visible property, JFrame, 422 
visibleRowCount method, 1206-1207 
Visual Basic, 6 
Visualization, trees, 876-879 
void keyword, 270 
Void method, 157 
void method, 160-162 

invoking, 161 

return in, 161-162 

TestVoidMethod.java, 160-162 
vspace attribute, 617 

VV 

waitO method, 991, 994, 1002 

Weak is-a relationship, 475 

Web servers, retrieving files from, 1036-1039 

java . net . URL class, 1037 

MalformedURLException, 1037 

openStreamO method, 1037 

ViewRemoteFile.java, 1038-1039 
WebBrowser.java, 1040-1041 
Weighted edges, 

representing, 940 
edge array, 940 

priority adjacency lists, 941-942 
weighted adjacency matrices, 941 

WeightedEdge.java, 941-942 
Weighted graphs: 

applications, 940-965 

representing, 940-942 
Weighted nine tail problem (case study), 962-964 

WeightedNineTailMode class, 964 
WeightedNineTailModel .j ava, 963-964 
WeightedEdge.java, 941-942 



WeightedCraph class, 898, 942-949 

TestWeightedGraph.java, 947-949 
WeightedGraph.java, 943-947 
WelcomelnMessageDialogBox.java, 16-17 
Welcome Java, 11-13 
while loop, 116-124 
Whitespace, 5 1 
Whitespace character, 27, 51 
Widening a type, 41 
Wildcard generic types, 714-716 

<? extends E> type, 715 

<? super T> wildcard, 715-716 

<?> type, 715 

bounded wildcard, 715 

lower-bound wildcard, 715 

unbounded wildcard, 715 

WildCardDemol.java, 714-715 

WildCardDemo2.java, 715-716 

WildCardDemo3.java, 716 
Wildcard import, 17 
WildCardDemo3.java, 716 
Window events, handling, 549-551 
windowActi vated method, 551 
WindowAdapter class, 551 
windowClosed method, 551 
windowClosing method, 551 
windowDeacti vated method, 551 
wi ndowDei coni f i ed method, 551 
WindowEvent, 535, 537, 549 
windowlconified method, 551 
WindowListener interface, 551 
wi ndowOpened method, 551 
Windows Calculator, 1320 
World Wide Web (WWW), defined, 8 
WorldClockApp.java, 1066 
WorldClockControl.java, 1064-1066 
WorldClockjava, 1064 
Worst-case input, 766 
Wrapper class, 476^178 

naming convention, 477 

and no-arg constructors, 478 
Wrapper class types, automatic conversion 
between primitive types and, 48 1 
Wrapper objects, constructing, 478 
Write-only property, 1094 
Write-only streams, 666 
writeBytes(String s) method, 656 
writeChar(char c) method, 656 
writeChars(String s) method, 656 
WriteData.java, 325-326 
writeObject method, ObjectOutputStream 

class, 1033, 1036 
writeUTF(String s) method, 656-657 

X 

xCoordinate, Component class, 512 
Y 

yCoordinate, Component class, 512 
Z 

Zero, division by, and runtime errors, 54 
based array indices, 200 



Video Notes 



Locations of Video Notes 

http://www.pearsonhighered.com/liang 

Chapter I Introduction to Computers, Programs, and Java 

First Java Program I I 

Compile and Run a Java Program 15 

Brief Eclipse Tutorial 14 

Chapter 2 Elementary Programming 

Obtain Input 26 

Program Computations 43 

Use Operators / and % 37 

Compute BMI 66 

Chapter 3 Selections 

Program Addition Quiz 73 

Program Subtraction Quiz 82 

Multiple Alternative if Statements 85 

Sort Three Integers 107 

Chapter 4 Loops 

Guess a Number 1 18 

Multiple Subtraction Quiz 121 

Minimize Numeric Errors 130 

Display Loan Schedule 150 

Chapter 5 Methods 

Define and Invoke Max Method 158 

Use Void Method 160 

Modularize Code 165 

Compute 77- 191 

Chapter 6 Single-Dimensional Arrays 

Random Shuffling 202 

Lotto Numbers 204 

Selection Sort 219 

Coupon Collector's Problem 232 

Chapter 7 Multidimensional Arrays 

Find the Row with the Largest Sum 239 

Grade Multiple-Choice Test 241 

Sudoku 244 

Multiply Two Matrices 253 

Chapter 8 Objects and Classes 

Use Classes 277 

Static versus Instance 278 

Data Field Encapsulation 283 

The Fan Class 297 

Chapter 9 Strings and Text I/O 

Check Palindrome 310 

Command-Line Argument 321 

Write and Read Data 000 

Decimal to Binary Number 000 

Chapter 10 Thinking in Objects 

The Loan Class 347 

The BMI Class 351 

The StackOflnterger Class 357 

Design and Implement MyPoint Class 367 



Chapter 1 1 Inheritance and Polymorphism 

Geometric Class Hierarchy 374 

Polymorphism and Dynamic Binding 386 

The ArrayList Class 390 

The MyStack Class 393 

Chapter 12 GUI Basics 

Use FlowLayout 41 I 

Panels as Subcontainers 4 1 7 

Swing Common Properties 420 

Display a Checkerboard 429 

Chapter 13 Exception Handling 

Exception Handling Advantage 432 

Create Custom Exception Classes 448 

The HexFormatException Class 456 

Chapter 14 Abstract Classes and Interfaces 

Abstract GeometricObject CI ass 458 

Calendar and GregorianCalendar Classes 462 

The Concept of Interface 465 

Redesign the Rectangle Class 492 

Chapter 15 Graphics 

The FigurePanel Class 502 

The MessagePanel Class 512 

The Still Clock Class 516 

Plot a Sine Function 529 

Chapter 16 Event-Driven Programming 

Create Source and fistener 540 

Anonymous Inner Class 543 

Move Message with the Mouse 553 

Animate a Clock 559 

Animate a Rising Flag 564 

Chapter 17 Creating User Interfaces 

Use Buttons 575 

Use Check Boxes 578 

Use Radio Buttons 581 

Use Labels and Text Fields 584 

Use Text Areas 610 

Chapter 18 Applets and Multimedia 

First Applet 614 

Run Applets Standalone 618 

TicTacToe 628 

Audio and Image 635 

Control a Group of Clocks 642 

Chapter 19 Binary I/O 

Copy File 660 

Object I/O 662 

Split a Large File 673 

Chapter 20 Recursion 

Binary Search 686 

Directory Size 687 

Fractal and the Sierpinski Triangle 692 

Search a String in a Directory 704 



